Server definition
- Hash
- sha256:48e7363aa9979396db1717f6a0081d84821b5315c57c4b55877fa9145d8311b5
- What it is
- What a remote MCP server returned when asked what it offers: 19 tools
The blob, as servednamed by its sha256
{
"instructions": "Treat unknown and partial results as incomplete. Such questions are automatically recorded for priority learning. If a returned answer does not address the original question, call report_knowledge_gap with the same question, context, reason and revision_refs. Use get_learning_status to check progress. Ask the user for missing context when learning.needs_context is true. Never claim that research or model training has completed unless status is published; this system learns verified knowledge, not model weights.",
"tools": [
{
"description": "Return exact-model, exact-version upgrade prerequisites, risks, checks, and rollback without downloading software. Missing or incomplete knowledge may create or update a tracked research demand. No device commands are executed.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"current_version": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z0-9][A-Za-z0-9()._\\-/]*$",
"type": "string"
},
"enabled_features": {
"default": [],
"items": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"maxItems": 30,
"type": "array"
},
"model": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"operating_system": {
"default": "IOS XE",
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"target_version": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z0-9][A-Za-z0-9()._\\-/]*$",
"type": "string"
}
},
"required": [
"model",
"current_version",
"target_version"
],
"type": "object"
},
"name": "advise_network_upgrade",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"applicability": {
"additionalProperties": false,
"properties": {
"current_version": {
"type": "string"
},
"model": {
"type": "string"
},
"operating_system": {
"type": "string"
},
"target_version": {
"type": "string"
},
"vendor": {
"type": "string"
}
},
"required": [
"vendor",
"model",
"operating_system",
"current_version",
"target_version"
],
"type": "object"
},
"assurance": {
"additionalProperties": false,
"properties": {
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"last_verified_at": {
"type": "string"
},
"validation_level": {
"const": "documentation_reviewed",
"type": "string"
}
},
"required": [
"validation_level",
"last_verified_at",
"confidence"
],
"type": "object"
},
"breaking_changes": {
"items": {
"type": "string"
},
"type": "array"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"next_action": {
"enum": [
"use_advice",
"request_expert_answer"
],
"type": "string"
},
"prerequisites": {
"items": {
"type": "string"
},
"type": "array"
},
"procedure": {
"items": {
"type": "string"
},
"type": "array"
},
"reload_expected": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"rollback": {
"items": {
"type": "string"
},
"type": "array"
},
"security_advisories": {
"items": {
"additionalProperties": false,
"properties": {
"applicability": {
"type": "string"
},
"disposition": {
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"id",
"applicability",
"disposition"
],
"type": "object"
},
"type": "array"
},
"status": {
"enum": [
"supported_with_checks",
"blocked",
"unknown"
],
"type": "string"
},
"verification": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"status",
"applicability",
"breaking_changes",
"security_advisories",
"prerequisites",
"procedure",
"verification",
"rollback",
"reload_expected",
"next_action",
"assurance",
"limitations"
],
"type": "object"
}
},
{
"description": "Detect vendor, model, operating system, and version from bounded CLI output while redacting sensitive values. Input is not stored.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"redaction_profile": {
"default": "strict",
"enum": [
"secrets_only",
"strict"
],
"type": "string"
},
"snapshot": {
"minLength": 1,
"type": "string"
},
"snapshot_type": {
"default": "auto",
"enum": [
"auto",
"show_version",
"config",
"log",
"topology",
"other"
],
"type": "string"
}
},
"required": [
"snapshot"
],
"type": "object"
},
"name": "analyze_device_snapshot",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"context": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"ambiguities": {
"items": {
"type": "string"
},
"type": "array"
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"operating_system": {
"type": "string"
},
"support_level": {
"enum": [
"deep",
"recognized"
],
"type": "string"
},
"vendor": {
"type": "string"
},
"version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"vendor",
"model",
"operating_system",
"version",
"support_level",
"confidence",
"ambiguities"
],
"type": "object"
},
{
"type": "null"
}
]
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"redactions": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"type": {
"type": "string"
}
},
"required": [
"type",
"count"
],
"type": "object"
},
"type": "array"
},
"retention": {
"const": "not_stored",
"type": "string"
},
"sanitized_snapshot": {
"type": "string"
},
"snapshot_type": {
"enum": [
"show_version",
"config",
"log",
"topology",
"other"
],
"type": "string"
}
},
"required": [
"context",
"snapshot_type",
"sanitized_snapshot",
"redactions",
"retention",
"limitations"
],
"type": "object"
}
},
{
"description": "Build a bounded topology and packet-path graph from supplied CDP, LLDP, route, and traceroute outputs without storing them.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"destination": {
"maxLength": 120,
"type": "string"
},
"snapshots": {
"items": {
"properties": {
"content": {
"maxLength": 16000,
"minLength": 1,
"type": "string"
},
"device_hint": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"output_type": {
"enum": [
"auto",
"cdp",
"lldp",
"route",
"traceroute"
],
"type": "string"
}
},
"required": [
"device_hint",
"output_type",
"content"
],
"type": "object"
},
"maxItems": 8,
"minItems": 1,
"type": "array"
},
"source": {
"maxLength": 120,
"type": "string"
}
},
"required": [
"snapshots"
],
"type": "object"
},
"name": "analyze_network_path",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"edges": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"local_interface": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"protocol": {
"enum": [
"cdp",
"lldp",
"route",
"traceroute"
],
"type": "string"
},
"remote_interface": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"source": {
"type": "string"
},
"target": {
"type": "string"
}
},
"required": [
"id",
"source",
"target",
"local_interface",
"remote_interface",
"protocol"
],
"type": "object"
},
"type": "array"
},
"findings": {
"items": {
"type": "string"
},
"type": "array"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"nodes": {
"items": {
"additionalProperties": false,
"properties": {
"attributes": {
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"id": {
"type": "string"
},
"kind": {
"enum": [
"device",
"hop",
"network",
"unknown"
],
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"id",
"label",
"kind",
"attributes"
],
"type": "object"
},
"type": "array"
},
"parse_diagnostics": {
"items": {
"additionalProperties": false,
"properties": {
"detected_type": {
"anyOf": [
{
"enum": [
"cdp",
"lldp",
"route",
"traceroute"
],
"type": "string"
},
{
"type": "null"
}
]
},
"records_parsed": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"requested_type": {
"enum": [
"auto",
"cdp",
"lldp",
"route",
"traceroute"
],
"type": "string"
},
"snapshot_index": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"status": {
"enum": [
"parsed",
"partial",
"unparsed"
],
"type": "string"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"snapshot_index",
"requested_type",
"detected_type",
"status",
"records_parsed",
"warnings"
],
"type": "object"
},
"type": "array"
},
"paths": {
"items": {
"additionalProperties": false,
"properties": {
"complete": {
"type": "boolean"
},
"destination": {
"type": "string"
},
"hops": {
"items": {
"type": "string"
},
"type": "array"
},
"source": {
"type": "string"
}
},
"required": [
"source",
"destination",
"hops",
"complete"
],
"type": "object"
},
"type": "array"
},
"probable_fault_domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"retention": {
"const": "not_stored",
"type": "string"
},
"unparsed_inputs": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"nodes",
"edges",
"paths",
"probable_fault_domain",
"findings",
"unparsed_inputs",
"parse_diagnostics",
"retention",
"limitations"
],
"type": "object"
}
},
{
"description": "Cancel a non-terminal expert task.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"access_token": {
"maxLength": 128,
"minLength": 32,
"type": "string"
},
"task_id": {
"pattern": "^ekt_[A-Za-z0-9_-]{32}$",
"type": "string"
}
},
"required": [
"task_id"
],
"type": "object"
},
"name": "cancel_expert_task",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"answer": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"applicability": {
"additionalProperties": false,
"properties": {
"assurance_level": {
"enum": [
"exact",
"compatible",
"generic",
"best_effort"
],
"type": "string"
},
"context_relation": {
"enum": [
"same_model",
"same_software_family",
"portable",
"same_vendor",
"cross_platform"
],
"type": "string"
},
"documented_version_relation": {
"enum": [
"older",
"newer",
"different",
"not_comparable",
"unspecified"
],
"type": "string"
},
"match_level": {
"enum": [
"exact_model",
"vendor_os",
"architecture_os",
"os_family"
],
"type": "string"
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"operating_system": {
"type": "string"
},
"requires_platform_confirmation": {
"type": "boolean"
},
"vendor": {
"type": "string"
},
"version_match": {
"enum": [
"exact",
"explicit_range",
"branch",
"unbounded",
"same_branch_fallback"
],
"type": "string"
},
"versions": {
"additionalProperties": false,
"properties": {
"maximum": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"minimum": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"requested": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"minimum",
"maximum",
"requested"
],
"type": "object"
}
},
"required": [
"vendor",
"model",
"operating_system",
"versions"
],
"type": "object"
},
"assurance": {
"additionalProperties": false,
"properties": {
"confidence_explanation": {
"type": "string"
},
"independent_confirmations": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"lab_validated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"next_review_at": {
"type": "string"
},
"validation_level": {
"enum": [
"legacy_migrated",
"documentation_reviewed",
"batfish_modeled",
"runtime_lab_validated"
],
"type": "string"
}
},
"required": [
"validation_level",
"independent_confirmations",
"confidence_explanation",
"next_review_at",
"lab_validated_at"
],
"type": "object"
},
"cli_mode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"command": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"conflicts": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"type": "string"
},
"severity": {
"enum": [
"informational",
"warning",
"blocking"
],
"type": "string"
}
},
"required": [
"severity",
"description"
],
"type": "object"
},
"type": "array"
},
"dangerous": {
"type": "boolean"
},
"kind": {
"enum": [
"command",
"workflow",
"diagnostic",
"concept",
"change",
"upgrade"
],
"type": "string"
},
"last_verified_at": {
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"prerequisites": {
"items": {
"type": "string"
},
"type": "array"
},
"procedure": {
"items": {
"type": "string"
},
"type": "array"
},
"quality_score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"revision_ref": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"risks": {
"items": {
"type": "string"
},
"type": "array"
},
"rollback": {
"items": {
"type": "string"
},
"type": "array"
},
"summary": {
"type": "string"
},
"title": {
"type": "string"
},
"verification": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"revision_ref",
"kind",
"title",
"summary",
"applicability",
"cli_mode",
"command",
"procedure",
"prerequisites",
"risks",
"verification",
"rollback",
"last_verified_at",
"confidence",
"quality_score",
"dangerous",
"assurance",
"conflicts",
"limitations"
],
"type": "object"
},
{
"type": "null"
}
]
},
"created_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"failure": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
{
"type": "null"
}
]
},
"input_request": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"milestones": {
"items": {
"additionalProperties": false,
"properties": {
"created_at": {
"type": "string"
},
"message": {
"type": "string"
},
"progress_percent": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"stage": {
"type": "string"
}
},
"required": [
"stage",
"progress_percent",
"message",
"created_at"
],
"type": "object"
},
"type": "array"
},
"poll_after_ms": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"progress_percent": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"published_release_sequence": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"stage": {
"enum": [
"queued",
"researching",
"conflict_check",
"validating",
"publishing",
"completed",
"failed",
"cancelled"
],
"type": "string"
},
"status": {
"enum": [
"queued",
"claimed",
"researching",
"input_required",
"validating",
"publishing",
"completed",
"failed",
"cancelled",
"expired"
],
"type": "string"
},
"task_id": {
"type": "string"
}
},
"required": [
"task_id",
"status",
"created_at",
"expires_at",
"input_request",
"answer",
"failure",
"poll_after_ms",
"stage",
"progress_percent",
"milestones",
"published_release_sequence"
],
"type": "object"
}
},
{
"description": "Provide bounded additional input requested by the researcher.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"access_token": {
"maxLength": 128,
"minLength": 32,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"task_id": {
"pattern": "^ekt_[A-Za-z0-9_-]{32}$",
"type": "string"
}
},
"required": [
"task_id",
"message"
],
"type": "object"
},
"name": "continue_expert_task",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"answer": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"applicability": {
"additionalProperties": false,
"properties": {
"assurance_level": {
"enum": [
"exact",
"compatible",
"generic",
"best_effort"
],
"type": "string"
},
"context_relation": {
"enum": [
"same_model",
"same_software_family",
"portable",
"same_vendor",
"cross_platform"
],
"type": "string"
},
"documented_version_relation": {
"enum": [
"older",
"newer",
"different",
"not_comparable",
"unspecified"
],
"type": "string"
},
"match_level": {
"enum": [
"exact_model",
"vendor_os",
"architecture_os",
"os_family"
],
"type": "string"
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"operating_system": {
"type": "string"
},
"requires_platform_confirmation": {
"type": "boolean"
},
"vendor": {
"type": "string"
},
"version_match": {
"enum": [
"exact",
"explicit_range",
"branch",
"unbounded",
"same_branch_fallback"
],
"type": "string"
},
"versions": {
"additionalProperties": false,
"properties": {
"maximum": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"minimum": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"requested": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"minimum",
"maximum",
"requested"
],
"type": "object"
}
},
"required": [
"vendor",
"model",
"operating_system",
"versions"
],
"type": "object"
},
"assurance": {
"additionalProperties": false,
"properties": {
"confidence_explanation": {
"type": "string"
},
"independent_confirmations": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"lab_validated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"next_review_at": {
"type": "string"
},
"validation_level": {
"enum": [
"legacy_migrated",
"documentation_reviewed",
"batfish_modeled",
"runtime_lab_validated"
],
"type": "string"
}
},
"required": [
"validation_level",
"independent_confirmations",
"confidence_explanation",
"next_review_at",
"lab_validated_at"
],
"type": "object"
},
"cli_mode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"command": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"conflicts": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"type": "string"
},
"severity": {
"enum": [
"informational",
"warning",
"blocking"
],
"type": "string"
}
},
"required": [
"severity",
"description"
],
"type": "object"
},
"type": "array"
},
"dangerous": {
"type": "boolean"
},
"kind": {
"enum": [
"command",
"workflow",
"diagnostic",
"concept",
"change",
"upgrade"
],
"type": "string"
},
"last_verified_at": {
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"prerequisites": {
"items": {
"type": "string"
},
"type": "array"
},
"procedure": {
"items": {
"type": "string"
},
"type": "array"
},
"quality_score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"revision_ref": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"risks": {
"items": {
"type": "string"
},
"type": "array"
},
"rollback": {
"items": {
"type": "string"
},
"type": "array"
},
"summary": {
"type": "string"
},
"title": {
"type": "string"
},
"verification": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"revision_ref",
"kind",
"title",
"summary",
"applicability",
"cli_mode",
"command",
"procedure",
"prerequisites",
"risks",
"verification",
"rollback",
"last_verified_at",
"confidence",
"quality_score",
"dangerous",
"assurance",
"conflicts",
"limitations"
],
"type": "object"
},
{
"type": "null"
}
]
},
"created_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"failure": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
{
"type": "null"
}
]
},
"input_request": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"milestones": {
"items": {
"additionalProperties": false,
"properties": {
"created_at": {
"type": "string"
},
"message": {
"type": "string"
},
"progress_percent": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"stage": {
"type": "string"
}
},
"required": [
"stage",
"progress_percent",
"message",
"created_at"
],
"type": "object"
},
"type": "array"
},
"poll_after_ms": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"progress_percent": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"published_release_sequence": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"stage": {
"enum": [
"queued",
"researching",
"conflict_check",
"validating",
"publishing",
"completed",
"failed",
"cancelled"
],
"type": "string"
},
"status": {
"enum": [
"queued",
"claimed",
"researching",
"input_required",
"validating",
"publishing",
"completed",
"failed",
"cancelled",
"expired"
],
"type": "string"
},
"task_id": {
"type": "string"
}
},
"required": [
"task_id",
"status",
"created_at",
"expires_at",
"input_request",
"answer",
"failure",
"poll_after_ms",
"stage",
"progress_percent",
"milestones",
"published_release_sequence"
],
"type": "object"
}
},
{
"description": "Return the context and public-record contracts for one installed knowledge domain.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain_id": {
"pattern": "^[a-z0-9][a-z0-9-]{1,62}$",
"type": "string"
}
},
"required": [
"domain_id"
],
"type": "object"
},
"name": "describe_knowledge_domain",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"items": {
"$ref": "#/definitions/__schema0"
},
"type": "array"
},
{
"additionalProperties": {
"$ref": "#/definitions/__schema0"
},
"propertyNames": {
"type": "string"
},
"type": "object"
}
]
}
},
"properties": {
"manifest": {
"additionalProperties": false,
"properties": {
"capabilities": {
"additionalProperties": false,
"properties": {
"artifacts": {
"default": false,
"type": "boolean"
},
"continuous_learning": {
"default": false,
"type": "boolean"
},
"lab_validation": {
"default": false,
"type": "boolean"
},
"relations": {
"default": false,
"type": "boolean"
},
"search": {
"default": true,
"type": "boolean"
},
"spatial": {
"default": false,
"type": "boolean"
},
"workflows": {
"default": false,
"type": "boolean"
}
},
"required": [
"search",
"workflows",
"continuous_learning",
"artifacts",
"spatial",
"relations",
"lab_validation"
],
"type": "object"
},
"context_dimensions": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"display_name": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"key": {
"pattern": "^[a-z][a-z0-9._-]{1,63}$",
"type": "string"
},
"required": {
"type": "boolean"
},
"value_type": {
"enum": [
"string",
"number",
"boolean",
"date",
"enum",
"json"
],
"type": "string"
}
},
"required": [
"key",
"display_name",
"description",
"value_type",
"required"
],
"type": "object"
},
"maxItems": 32,
"minItems": 1,
"type": "array"
},
"core_compatibility": {
"additionalProperties": false,
"properties": {
"maximum": {
"pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-[0-9A-Za-z.-]+)?$",
"type": "string"
},
"minimum": {
"pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-[0-9A-Za-z.-]+)?$",
"type": "string"
}
},
"required": [
"minimum"
],
"type": "object"
},
"description": {
"maxLength": 500,
"minLength": 10,
"type": "string"
},
"display_name": {
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"id": {
"pattern": "^[a-z0-9][a-z0-9-]{1,62}$",
"type": "string"
},
"record_types": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"display_name": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"id": {
"pattern": "^[a-z][a-z0-9._-]{1,63}$",
"type": "string"
}
},
"required": [
"id",
"display_name",
"description"
],
"type": "object"
},
"maxItems": 64,
"minItems": 1,
"type": "array"
},
"schema_version": {
"const": "1",
"type": "string"
},
"version": {
"pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-[0-9A-Za-z.-]+)?$",
"type": "string"
}
},
"required": [
"schema_version",
"id",
"version",
"display_name",
"description",
"core_compatibility",
"context_dimensions",
"record_types",
"capabilities"
],
"type": "object"
},
"schemas": {
"additionalProperties": false,
"properties": {
"context": {
"additionalProperties": {
"$ref": "#/definitions/__schema0"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"public_record": {
"additionalProperties": {
"$ref": "#/definitions/__schema0"
},
"propertyNames": {
"type": "string"
},
"type": "object"
}
},
"required": [
"context",
"public_record"
],
"type": "object"
}
},
"required": [
"manifest",
"schemas"
],
"type": "object"
}
},
{
"description": "Poll an expert research task by opaque ID and access token.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"access_token": {
"maxLength": 128,
"minLength": 32,
"type": "string"
},
"task_id": {
"pattern": "^ekt_[A-Za-z0-9_-]{32}$",
"type": "string"
}
},
"required": [
"task_id"
],
"type": "object"
},
"name": "get_expert_task",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"answer": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"applicability": {
"additionalProperties": false,
"properties": {
"assurance_level": {
"enum": [
"exact",
"compatible",
"generic",
"best_effort"
],
"type": "string"
},
"context_relation": {
"enum": [
"same_model",
"same_software_family",
"portable",
"same_vendor",
"cross_platform"
],
"type": "string"
},
"documented_version_relation": {
"enum": [
"older",
"newer",
"different",
"not_comparable",
"unspecified"
],
"type": "string"
},
"match_level": {
"enum": [
"exact_model",
"vendor_os",
"architecture_os",
"os_family"
],
"type": "string"
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"operating_system": {
"type": "string"
},
"requires_platform_confirmation": {
"type": "boolean"
},
"vendor": {
"type": "string"
},
"version_match": {
"enum": [
"exact",
"explicit_range",
"branch",
"unbounded",
"same_branch_fallback"
],
"type": "string"
},
"versions": {
"additionalProperties": false,
"properties": {
"maximum": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"minimum": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"requested": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"minimum",
"maximum",
"requested"
],
"type": "object"
}
},
"required": [
"vendor",
"model",
"operating_system",
"versions"
],
"type": "object"
},
"assurance": {
"additionalProperties": false,
"properties": {
"confidence_explanation": {
"type": "string"
},
"independent_confirmations": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"lab_validated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"next_review_at": {
"type": "string"
},
"validation_level": {
"enum": [
"legacy_migrated",
"documentation_reviewed",
"batfish_modeled",
"runtime_lab_validated"
],
"type": "string"
}
},
"required": [
"validation_level",
"independent_confirmations",
"confidence_explanation",
"next_review_at",
"lab_validated_at"
],
"type": "object"
},
"cli_mode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"command": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"conflicts": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"type": "string"
},
"severity": {
"enum": [
"informational",
"warning",
"blocking"
],
"type": "string"
}
},
"required": [
"severity",
"description"
],
"type": "object"
},
"type": "array"
},
"dangerous": {
"type": "boolean"
},
"kind": {
"enum": [
"command",
"workflow",
"diagnostic",
"concept",
"change",
"upgrade"
],
"type": "string"
},
"last_verified_at": {
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"prerequisites": {
"items": {
"type": "string"
},
"type": "array"
},
"procedure": {
"items": {
"type": "string"
},
"type": "array"
},
"quality_score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"revision_ref": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"risks": {
"items": {
"type": "string"
},
"type": "array"
},
"rollback": {
"items": {
"type": "string"
},
"type": "array"
},
"summary": {
"type": "string"
},
"title": {
"type": "string"
},
"verification": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"revision_ref",
"kind",
"title",
"summary",
"applicability",
"cli_mode",
"command",
"procedure",
"prerequisites",
"risks",
"verification",
"rollback",
"last_verified_at",
"confidence",
"quality_score",
"dangerous",
"assurance",
"conflicts",
"limitations"
],
"type": "object"
},
{
"type": "null"
}
]
},
"created_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"failure": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
{
"type": "null"
}
]
},
"input_request": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"milestones": {
"items": {
"additionalProperties": false,
"properties": {
"created_at": {
"type": "string"
},
"message": {
"type": "string"
},
"progress_percent": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"stage": {
"type": "string"
}
},
"required": [
"stage",
"progress_percent",
"message",
"created_at"
],
"type": "object"
},
"type": "array"
},
"poll_after_ms": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"progress_percent": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"published_release_sequence": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"stage": {
"enum": [
"queued",
"researching",
"conflict_check",
"validating",
"publishing",
"completed",
"failed",
"cancelled"
],
"type": "string"
},
"status": {
"enum": [
"queued",
"claimed",
"researching",
"input_required",
"validating",
"publishing",
"completed",
"failed",
"cancelled",
"expired"
],
"type": "string"
},
"task_id": {
"type": "string"
}
},
"required": [
"task_id",
"status",
"created_at",
"expires_at",
"input_request",
"answer",
"failure",
"poll_after_ms",
"stage",
"progress_percent",
"milestones",
"published_release_sequence"
],
"type": "object"
}
},
{
"description": "Return safe source metadata for up to five active knowledge revisions.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"revision_refs": {
"items": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"maxItems": 5,
"minItems": 1,
"type": "array"
}
},
"required": [
"revision_refs"
],
"type": "object"
},
"name": "get_knowledge_provenance",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"revisions": {
"items": {
"additionalProperties": false,
"properties": {
"revision_ref": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"sources": {
"items": {
"additionalProperties": false,
"properties": {
"document_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"document_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"source_kind": {
"enum": [
"official_web",
"admin_web",
"admin_document",
"pasted_text",
"field_log"
],
"type": "string"
},
"source_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
},
"url": {
"format": "uri",
"pattern": "^https:\\/\\/.*",
"type": "string"
},
"verified_at": {
"type": "string"
}
},
"required": [
"source_ref",
"source_kind",
"title",
"url",
"document_version",
"document_date",
"verified_at"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"revision_ref",
"sources"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"revisions"
],
"type": "object"
}
},
{
"description": "Check a learning ID returned by a knowledge query or report_knowledge_gap. Published means the original question has a complete answer; repeat the original query to read it.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"learning_id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
}
},
"required": [
"learning_id"
],
"type": "object"
},
"name": "get_learning_status",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"learning": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"active_tasks": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"elapsed_seconds": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"last_error_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"last_progress_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"message": {
"type": "string"
},
"needs_context": {
"type": "boolean"
},
"queued_tasks": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"revision_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"stage": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"type": "string"
}
},
"required": [
"id",
"status",
"stage",
"message",
"needs_context",
"elapsed_seconds",
"last_progress_at",
"last_error_code",
"queued_tasks",
"active_tasks",
"revision_ref"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"learning"
],
"type": "object"
}
},
{
"description": "Return a deterministic, ordered workflow including safety, verification, and rollback. Missing or incomplete knowledge may create or update a tracked research demand. No device commands are executed.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"context": {
"properties": {
"model": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"operating_system": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"runtime_mode": {
"enum": [
"normal",
"rescue",
"installer",
"update",
"uninstall",
"recovery",
"diagnostic"
],
"type": "string"
},
"shell_environment": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"vendor": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"version": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z0-9][A-Za-z0-9()._\\-/]*$",
"type": "string"
}
},
"type": "object"
},
"goal": {
"maxLength": 2000,
"minLength": 3,
"type": "string"
},
"limit": {
"default": 1,
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"goal",
"context"
],
"type": "object"
},
"name": "get_network_workflow",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"answer_status": {
"enum": [
"complete",
"partial",
"unknown"
],
"type": "string"
},
"answers": {
"items": {
"additionalProperties": false,
"properties": {
"applicability": {
"additionalProperties": false,
"properties": {
"assurance_level": {
"enum": [
"exact",
"compatible",
"generic",
"best_effort"
],
"type": "string"
},
"context_relation": {
"enum": [
"same_model",
"same_software_family",
"portable",
"same_vendor",
"cross_platform"
],
"type": "string"
},
"documented_version_relation": {
"enum": [
"older",
"newer",
"different",
"not_comparable",
"unspecified"
],
"type": "string"
},
"match_level": {
"enum": [
"exact_model",
"vendor_os",
"architecture_os",
"os_family"
],
"type": "string"
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"operating_system": {
"type": "string"
},
"requires_platform_confirmation": {
"type": "boolean"
},
"vendor": {
"type": "string"
},
"version_match": {
"enum": [
"exact",
"explicit_range",
"branch",
"unbounded",
"same_branch_fallback"
],
"type": "string"
},
"versions": {
"additionalProperties": false,
"properties": {
"maximum": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"minimum": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"requested": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"minimum",
"maximum",
"requested"
],
"type": "object"
}
},
"required": [
"vendor",
"model",
"operating_system",
"versions"
],
"type": "object"
},
"assurance": {
"additionalProperties": false,
"properties": {
"confidence_explanation": {
"type": "string"
},
"independent_confirmations": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"lab_validated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"next_review_at": {
"type": "string"
},
"validation_level": {
"enum": [
"legacy_migrated",
"documentation_reviewed",
"batfish_modeled",
"runtime_lab_validated"
],
"type": "string"
}
},
"required": [
"validation_level",
"independent_confirmations",
"confidence_explanation",
"next_review_at",
"lab_validated_at"
],
"type": "object"
},
"cli_mode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"command": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"conflicts": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"type": "string"
},
"severity": {
"enum": [
"informational",
"warning",
"blocking"
],
"type": "string"
}
},
"required": [
"severity",
"description"
],
"type": "object"
},
"type": "array"
},
"dangerous": {
"type": "boolean"
},
"kind": {
"enum": [
"command",
"workflow",
"diagnostic",
"concept",
"change",
"upgrade"
],
"type": "string"
},
"last_verified_at": {
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"prerequisites": {
"items": {
"type": "string"
},
"type": "array"
},
"procedure": {
"items": {
"type": "string"
},
"type": "array"
},
"quality_score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"revision_ref": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"risks": {
"items": {
"type": "string"
},
"type": "array"
},
"rollback": {
"items": {
"type": "string"
},
"type": "array"
},
"summary": {
"type": "string"
},
"title": {
"type": "string"
},
"verification": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"revision_ref",
"kind",
"title",
"summary",
"applicability",
"cli_mode",
"command",
"procedure",
"prerequisites",
"risks",
"verification",
"rollback",
"last_verified_at",
"confidence",
"quality_score",
"dangerous",
"assurance",
"conflicts",
"limitations"
],
"type": "object"
},
"type": "array"
},
"context": {
"additionalProperties": false,
"properties": {
"ambiguities": {
"items": {
"type": "string"
},
"type": "array"
},
"applicable_version": {
"type": "string"
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"model_resolved": {
"type": "boolean"
},
"operating_system": {
"type": "string"
},
"operating_system_slug": {
"type": "string"
},
"platform_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"portable_operating_system": {
"type": "boolean"
},
"resolution_confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"runtime_mode": {
"anyOf": [
{
"enum": [
"normal",
"rescue",
"installer",
"update",
"uninstall",
"recovery",
"diagnostic"
],
"type": "string"
},
{
"type": "null"
}
]
},
"shell_environment": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"software_family": {
"type": "string"
},
"software_family_slug": {
"type": "string"
},
"vendor": {
"type": "string"
},
"vendor_resolved": {
"type": "boolean"
},
"vendor_slug": {
"type": "string"
},
"version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"vendor",
"vendor_slug",
"model",
"platform_slug",
"operating_system",
"operating_system_slug",
"version",
"applicable_version",
"resolution_confidence",
"ambiguities"
],
"type": "object"
},
"coverage": {
"items": {
"additionalProperties": false,
"properties": {
"answer_refs": {
"items": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"type": "array"
},
"capability": {
"type": "string"
},
"label": {
"type": "string"
},
"status": {
"enum": [
"covered",
"missing"
],
"type": "string"
}
},
"required": [
"capability",
"label",
"status",
"answer_refs"
],
"type": "object"
},
"type": "array"
},
"cross_platform_examples": {
"items": {
"additionalProperties": false,
"properties": {
"applicability": {
"additionalProperties": false,
"properties": {
"assurance_level": {
"enum": [
"exact",
"compatible",
"generic",
"best_effort"
],
"type": "string"
},
"context_relation": {
"enum": [
"same_model",
"same_software_family",
"portable",
"same_vendor",
"cross_platform"
],
"type": "string"
},
"documented_version_relation": {
"enum": [
"older",
"newer",
"different",
"not_comparable",
"unspecified"
],
"type": "string"
},
"match_level": {
"enum": [
"exact_model",
"vendor_os",
"architecture_os",
"os_family"
],
"type": "string"
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"operating_system": {
"type": "string"
},
"requires_platform_confirmation": {
"type": "boolean"
},
"vendor": {
"type": "string"
},
"version_match": {
"enum": [
"exact",
"explicit_range",
"branch",
"unbounded",
"same_branch_fallback"
],
"type": "string"
},
"versions": {
"additionalProperties": false,
"properties": {
"maximum": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"minimum": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"requested": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"minimum",
"maximum",
"requested"
],
"type": "object"
}
},
"required": [
"vendor",
"model",
"operating_system",
"versions"
],
"type": "object"
},
"assurance": {
"additionalProperties": false,
"properties": {
"confidence_explanation": {
"type": "string"
},
"independent_confirmations": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"lab_validated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"next_review_at": {
"type": "string"
},
"validation_level": {
"enum": [
"legacy_migrated",
"documentation_reviewed",
"batfish_modeled",
"runtime_lab_validated"
],
"type": "string"
}
},
"required": [
"validation_level",
"independent_confirmations",
"confidence_explanation",
"next_review_at",
"lab_validated_at"
],
"type": "object"
},
"cli_mode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"command": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"conflicts": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"type": "string"
},
"severity": {
"enum": [
"informational",
"warning",
"blocking"
],
"type": "string"
}
},
"required": [
"severity",
"description"
],
"type": "object"
},
"type": "array"
},
"dangerous": {
"type": "boolean"
},
"kind": {
"enum": [
"command",
"workflow",
"diagnostic",
"concept",
"change",
"upgrade"
],
"type": "string"
},
"last_verified_at": {
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"prerequisites": {
"items": {
"type": "string"
},
"type": "array"
},
"procedure": {
"items": {
"type": "string"
},
"type": "array"
},
"quality_score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"revision_ref": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"risks": {
"items": {
"type": "string"
},
"type": "array"
},
"rollback": {
"items": {
"type": "string"
},
"type": "array"
},
"summary": {
"type": "string"
},
"title": {
"type": "string"
},
"verification": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"revision_ref",
"kind",
"title",
"summary",
"applicability",
"cli_mode",
"command",
"procedure",
"prerequisites",
"risks",
"verification",
"rollback",
"last_verified_at",
"confidence",
"quality_score",
"dangerous",
"assurance",
"conflicts",
"limitations"
],
"type": "object"
},
"type": "array"
},
"learning": {
"additionalProperties": false,
"properties": {
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"message": {
"type": "string"
},
"needs_context": {
"type": "boolean"
},
"status": {
"enum": [
"diagnosing",
"discovering",
"processing",
"rechecking",
"queued",
"not_required",
"unavailable"
],
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
},
"next_action": {
"enum": [
"use_answer",
"request_expert_answer"
],
"type": "string"
},
"unknown": {
"type": "boolean"
}
},
"required": [
"context",
"answers",
"cross_platform_examples",
"unknown",
"next_action"
],
"type": "object"
}
},
{
"description": "List installed, compatible knowledge domain packs and their declared capabilities.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_knowledge_domains",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domains": {
"items": {
"additionalProperties": false,
"properties": {
"capabilities": {
"additionalProperties": false,
"properties": {
"artifacts": {
"default": false,
"type": "boolean"
},
"continuous_learning": {
"default": false,
"type": "boolean"
},
"lab_validation": {
"default": false,
"type": "boolean"
},
"relations": {
"default": false,
"type": "boolean"
},
"search": {
"default": true,
"type": "boolean"
},
"spatial": {
"default": false,
"type": "boolean"
},
"workflows": {
"default": false,
"type": "boolean"
}
},
"required": [
"search",
"workflows",
"continuous_learning",
"artifacts",
"spatial",
"relations",
"lab_validation"
],
"type": "object"
},
"context_dimensions": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"display_name": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"key": {
"pattern": "^[a-z][a-z0-9._-]{1,63}$",
"type": "string"
},
"required": {
"type": "boolean"
},
"value_type": {
"enum": [
"string",
"number",
"boolean",
"date",
"enum",
"json"
],
"type": "string"
}
},
"required": [
"key",
"display_name",
"description",
"value_type",
"required"
],
"type": "object"
},
"maxItems": 32,
"minItems": 1,
"type": "array"
},
"core_compatibility": {
"additionalProperties": false,
"properties": {
"maximum": {
"pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-[0-9A-Za-z.-]+)?$",
"type": "string"
},
"minimum": {
"pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-[0-9A-Za-z.-]+)?$",
"type": "string"
}
},
"required": [
"minimum"
],
"type": "object"
},
"description": {
"maxLength": 500,
"minLength": 10,
"type": "string"
},
"display_name": {
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"id": {
"pattern": "^[a-z0-9][a-z0-9-]{1,62}$",
"type": "string"
},
"record_types": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"display_name": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"id": {
"pattern": "^[a-z][a-z0-9._-]{1,63}$",
"type": "string"
}
},
"required": [
"id",
"display_name",
"description"
],
"type": "object"
},
"maxItems": 64,
"minItems": 1,
"type": "array"
},
"schema_version": {
"const": "1",
"type": "string"
},
"version": {
"pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-[0-9A-Za-z.-]+)?$",
"type": "string"
}
},
"required": [
"schema_version",
"id",
"version",
"display_name",
"description",
"core_compatibility",
"context_dimensions",
"record_types",
"capabilities"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"domains"
],
"type": "object"
}
},
{
"description": "Run deterministic search in one domain using that pack’s validated context and public-record schema. Network queries may create or update a tracked research demand for missing or incomplete knowledge.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"items": {
"$ref": "#/definitions/__schema0"
},
"type": "array"
},
{
"additionalProperties": {
"$ref": "#/definitions/__schema0"
},
"propertyNames": {
"type": "string"
},
"type": "object"
}
]
}
},
"properties": {
"context": {
"additionalProperties": {
"$ref": "#/definitions/__schema0"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"domain_id": {
"pattern": "^[a-z0-9][a-z0-9-]{1,62}$",
"type": "string"
},
"limit": {
"default": 5,
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"question": {
"maxLength": 2000,
"minLength": 3,
"type": "string"
}
},
"required": [
"domain_id",
"question",
"context"
],
"type": "object"
},
"name": "query_domain_knowledge",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"items": {
"$ref": "#/definitions/__schema0"
},
"type": "array"
},
{
"additionalProperties": {
"$ref": "#/definitions/__schema0"
},
"propertyNames": {
"type": "string"
},
"type": "object"
}
]
}
},
"properties": {
"answer_status": {
"enum": [
"complete",
"partial",
"unknown"
],
"type": "string"
},
"answers": {
"items": {
"additionalProperties": {
"$ref": "#/definitions/__schema0"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"context": {
"additionalProperties": {
"$ref": "#/definitions/__schema0"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"coverage": {
"items": {
"additionalProperties": false,
"properties": {
"answer_refs": {
"items": {
"type": "string"
},
"type": "array"
},
"capability": {
"type": "string"
},
"label": {
"type": "string"
},
"status": {
"enum": [
"covered",
"missing"
],
"type": "string"
}
},
"required": [
"capability",
"label",
"status",
"answer_refs"
],
"type": "object"
},
"type": "array"
},
"cross_platform_examples": {
"items": {
"additionalProperties": {
"$ref": "#/definitions/__schema0"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"domain_id": {
"pattern": "^[a-z0-9][a-z0-9-]{1,62}$",
"type": "string"
},
"learning": {
"additionalProperties": false,
"properties": {
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"message": {
"type": "string"
},
"needs_context": {
"type": "boolean"
},
"status": {
"enum": [
"diagnosing",
"discovering",
"processing",
"rechecking",
"queued",
"not_required",
"unavailable"
],
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
},
"next_action": {
"enum": [
"use_answer",
"knowledge_not_found"
],
"type": "string"
},
"unknown": {
"type": "boolean"
}
},
"required": [
"domain_id",
"context",
"answers",
"cross_platform_examples",
"unknown",
"next_action"
],
"type": "object"
}
},
{
"description": "Return deterministic, version-scoped commands, diagnostics, and concepts for a network question. Missing or incomplete knowledge may create or update a tracked research demand. No device commands are executed.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"context": {
"properties": {
"model": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"operating_system": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"runtime_mode": {
"enum": [
"normal",
"rescue",
"installer",
"update",
"uninstall",
"recovery",
"diagnostic"
],
"type": "string"
},
"shell_environment": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"vendor": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"version": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z0-9][A-Za-z0-9()._\\-/]*$",
"type": "string"
}
},
"type": "object"
},
"limit": {
"default": 3,
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"question": {
"maxLength": 2000,
"minLength": 3,
"type": "string"
}
},
"required": [
"question",
"context"
],
"type": "object"
},
"name": "query_network_knowledge",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"answer_status": {
"enum": [
"complete",
"partial",
"unknown"
],
"type": "string"
},
"answers": {
"items": {
"additionalProperties": false,
"properties": {
"applicability": {
"additionalProperties": false,
"properties": {
"assurance_level": {
"enum": [
"exact",
"compatible",
"generic",
"best_effort"
],
"type": "string"
},
"context_relation": {
"enum": [
"same_model",
"same_software_family",
"portable",
"same_vendor",
"cross_platform"
],
"type": "string"
},
"documented_version_relation": {
"enum": [
"older",
"newer",
"different",
"not_comparable",
"unspecified"
],
"type": "string"
},
"match_level": {
"enum": [
"exact_model",
"vendor_os",
"architecture_os",
"os_family"
],
"type": "string"
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"operating_system": {
"type": "string"
},
"requires_platform_confirmation": {
"type": "boolean"
},
"vendor": {
"type": "string"
},
"version_match": {
"enum": [
"exact",
"explicit_range",
"branch",
"unbounded",
"same_branch_fallback"
],
"type": "string"
},
"versions": {
"additionalProperties": false,
"properties": {
"maximum": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"minimum": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"requested": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"minimum",
"maximum",
"requested"
],
"type": "object"
}
},
"required": [
"vendor",
"model",
"operating_system",
"versions"
],
"type": "object"
},
"assurance": {
"additionalProperties": false,
"properties": {
"confidence_explanation": {
"type": "string"
},
"independent_confirmations": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"lab_validated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"next_review_at": {
"type": "string"
},
"validation_level": {
"enum": [
"legacy_migrated",
"documentation_reviewed",
"batfish_modeled",
"runtime_lab_validated"
],
"type": "string"
}
},
"required": [
"validation_level",
"independent_confirmations",
"confidence_explanation",
"next_review_at",
"lab_validated_at"
],
"type": "object"
},
"cli_mode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"command": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"conflicts": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"type": "string"
},
"severity": {
"enum": [
"informational",
"warning",
"blocking"
],
"type": "string"
}
},
"required": [
"severity",
"description"
],
"type": "object"
},
"type": "array"
},
"dangerous": {
"type": "boolean"
},
"kind": {
"enum": [
"command",
"workflow",
"diagnostic",
"concept",
"change",
"upgrade"
],
"type": "string"
},
"last_verified_at": {
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"prerequisites": {
"items": {
"type": "string"
},
"type": "array"
},
"procedure": {
"items": {
"type": "string"
},
"type": "array"
},
"quality_score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"revision_ref": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"risks": {
"items": {
"type": "string"
},
"type": "array"
},
"rollback": {
"items": {
"type": "string"
},
"type": "array"
},
"summary": {
"type": "string"
},
"title": {
"type": "string"
},
"verification": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"revision_ref",
"kind",
"title",
"summary",
"applicability",
"cli_mode",
"command",
"procedure",
"prerequisites",
"risks",
"verification",
"rollback",
"last_verified_at",
"confidence",
"quality_score",
"dangerous",
"assurance",
"conflicts",
"limitations"
],
"type": "object"
},
"type": "array"
},
"context": {
"additionalProperties": false,
"properties": {
"ambiguities": {
"items": {
"type": "string"
},
"type": "array"
},
"applicable_version": {
"type": "string"
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"model_resolved": {
"type": "boolean"
},
"operating_system": {
"type": "string"
},
"operating_system_slug": {
"type": "string"
},
"platform_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"portable_operating_system": {
"type": "boolean"
},
"resolution_confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"runtime_mode": {
"anyOf": [
{
"enum": [
"normal",
"rescue",
"installer",
"update",
"uninstall",
"recovery",
"diagnostic"
],
"type": "string"
},
{
"type": "null"
}
]
},
"shell_environment": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"software_family": {
"type": "string"
},
"software_family_slug": {
"type": "string"
},
"vendor": {
"type": "string"
},
"vendor_resolved": {
"type": "boolean"
},
"vendor_slug": {
"type": "string"
},
"version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"vendor",
"vendor_slug",
"model",
"platform_slug",
"operating_system",
"operating_system_slug",
"version",
"applicable_version",
"resolution_confidence",
"ambiguities"
],
"type": "object"
},
"coverage": {
"items": {
"additionalProperties": false,
"properties": {
"answer_refs": {
"items": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"type": "array"
},
"capability": {
"type": "string"
},
"label": {
"type": "string"
},
"status": {
"enum": [
"covered",
"missing"
],
"type": "string"
}
},
"required": [
"capability",
"label",
"status",
"answer_refs"
],
"type": "object"
},
"type": "array"
},
"cross_platform_examples": {
"items": {
"additionalProperties": false,
"properties": {
"applicability": {
"additionalProperties": false,
"properties": {
"assurance_level": {
"enum": [
"exact",
"compatible",
"generic",
"best_effort"
],
"type": "string"
},
"context_relation": {
"enum": [
"same_model",
"same_software_family",
"portable",
"same_vendor",
"cross_platform"
],
"type": "string"
},
"documented_version_relation": {
"enum": [
"older",
"newer",
"different",
"not_comparable",
"unspecified"
],
"type": "string"
},
"match_level": {
"enum": [
"exact_model",
"vendor_os",
"architecture_os",
"os_family"
],
"type": "string"
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"operating_system": {
"type": "string"
},
"requires_platform_confirmation": {
"type": "boolean"
},
"vendor": {
"type": "string"
},
"version_match": {
"enum": [
"exact",
"explicit_range",
"branch",
"unbounded",
"same_branch_fallback"
],
"type": "string"
},
"versions": {
"additionalProperties": false,
"properties": {
"maximum": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"minimum": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"requested": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"minimum",
"maximum",
"requested"
],
"type": "object"
}
},
"required": [
"vendor",
"model",
"operating_system",
"versions"
],
"type": "object"
},
"assurance": {
"additionalProperties": false,
"properties": {
"confidence_explanation": {
"type": "string"
},
"independent_confirmations": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"lab_validated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"next_review_at": {
"type": "string"
},
"validation_level": {
"enum": [
"legacy_migrated",
"documentation_reviewed",
"batfish_modeled",
"runtime_lab_validated"
],
"type": "string"
}
},
"required": [
"validation_level",
"independent_confirmations",
"confidence_explanation",
"next_review_at",
"lab_validated_at"
],
"type": "object"
},
"cli_mode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"command": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"conflicts": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"type": "string"
},
"severity": {
"enum": [
"informational",
"warning",
"blocking"
],
"type": "string"
}
},
"required": [
"severity",
"description"
],
"type": "object"
},
"type": "array"
},
"dangerous": {
"type": "boolean"
},
"kind": {
"enum": [
"command",
"workflow",
"diagnostic",
"concept",
"change",
"upgrade"
],
"type": "string"
},
"last_verified_at": {
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"prerequisites": {
"items": {
"type": "string"
},
"type": "array"
},
"procedure": {
"items": {
"type": "string"
},
"type": "array"
},
"quality_score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"revision_ref": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"risks": {
"items": {
"type": "string"
},
"type": "array"
},
"rollback": {
"items": {
"type": "string"
},
"type": "array"
},
"summary": {
"type": "string"
},
"title": {
"type": "string"
},
"verification": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"revision_ref",
"kind",
"title",
"summary",
"applicability",
"cli_mode",
"command",
"procedure",
"prerequisites",
"risks",
"verification",
"rollback",
"last_verified_at",
"confidence",
"quality_score",
"dangerous",
"assurance",
"conflicts",
"limitations"
],
"type": "object"
},
"type": "array"
},
"learning": {
"additionalProperties": false,
"properties": {
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"message": {
"type": "string"
},
"needs_context": {
"type": "boolean"
},
"status": {
"enum": [
"diagnosing",
"discovering",
"processing",
"rechecking",
"queued",
"not_required",
"unavailable"
],
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
},
"next_action": {
"enum": [
"use_answer",
"request_expert_answer"
],
"type": "string"
},
"unknown": {
"type": "boolean"
}
},
"required": [
"context",
"answers",
"cross_platform_examples",
"unknown",
"next_action"
],
"type": "object"
}
},
{
"description": "Record the original network question for priority research. Provide missing context or explain why an answer was not useful. Feedback alone does not change or quarantine published knowledge.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"context": {
"additionalProperties": false,
"default": {},
"properties": {
"model": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"operating_system": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"runtime_mode": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"shell_environment": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"vendor": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"version": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z0-9][A-Za-z0-9()._\\-/]*$",
"type": "string"
}
},
"type": "object"
},
"question": {
"maxLength": 2000,
"minLength": 3,
"type": "string"
},
"reason": {
"maxLength": 1000,
"minLength": 3,
"type": "string"
},
"revision_refs": {
"default": [],
"items": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"maxItems": 5,
"type": "array"
}
},
"required": [
"question",
"reason"
],
"type": "object"
},
"name": "report_knowledge_gap",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"learning": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"active_tasks": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"elapsed_seconds": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"last_error_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"last_progress_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"message": {
"type": "string"
},
"needs_context": {
"type": "boolean"
},
"queued_tasks": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"revision_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"stage": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"type": "string"
}
},
"required": [
"id",
"status",
"stage",
"message",
"needs_context",
"elapsed_seconds",
"last_progress_at",
"last_error_code",
"queued_tasks",
"active_tasks",
"revision_ref"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"learning"
],
"type": "object"
}
},
{
"description": "Create a durable research task when deterministic knowledge has no applicable answer.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"context": {
"properties": {
"model": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"operating_system": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"runtime_mode": {
"enum": [
"normal",
"rescue",
"installer",
"update",
"uninstall",
"recovery",
"diagnostic"
],
"type": "string"
},
"shell_environment": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"vendor": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"version": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z0-9][A-Za-z0-9()._\\-/]*$",
"type": "string"
}
},
"type": "object"
},
"idempotency_key": {
"maxLength": 128,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]+$",
"type": "string"
},
"question": {
"maxLength": 2000,
"minLength": 8,
"type": "string"
}
},
"required": [
"question",
"context"
],
"type": "object"
},
"name": "request_expert_answer",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"access_token": {
"maxLength": 128,
"minLength": 32,
"type": "string"
},
"answer": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"applicability": {
"additionalProperties": false,
"properties": {
"assurance_level": {
"enum": [
"exact",
"compatible",
"generic",
"best_effort"
],
"type": "string"
},
"context_relation": {
"enum": [
"same_model",
"same_software_family",
"portable",
"same_vendor",
"cross_platform"
],
"type": "string"
},
"documented_version_relation": {
"enum": [
"older",
"newer",
"different",
"not_comparable",
"unspecified"
],
"type": "string"
},
"match_level": {
"enum": [
"exact_model",
"vendor_os",
"architecture_os",
"os_family"
],
"type": "string"
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"operating_system": {
"type": "string"
},
"requires_platform_confirmation": {
"type": "boolean"
},
"vendor": {
"type": "string"
},
"version_match": {
"enum": [
"exact",
"explicit_range",
"branch",
"unbounded",
"same_branch_fallback"
],
"type": "string"
},
"versions": {
"additionalProperties": false,
"properties": {
"maximum": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"minimum": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"requested": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"minimum",
"maximum",
"requested"
],
"type": "object"
}
},
"required": [
"vendor",
"model",
"operating_system",
"versions"
],
"type": "object"
},
"assurance": {
"additionalProperties": false,
"properties": {
"confidence_explanation": {
"type": "string"
},
"independent_confirmations": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"lab_validated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"next_review_at": {
"type": "string"
},
"validation_level": {
"enum": [
"legacy_migrated",
"documentation_reviewed",
"batfish_modeled",
"runtime_lab_validated"
],
"type": "string"
}
},
"required": [
"validation_level",
"independent_confirmations",
"confidence_explanation",
"next_review_at",
"lab_validated_at"
],
"type": "object"
},
"cli_mode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"command": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"conflicts": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"type": "string"
},
"severity": {
"enum": [
"informational",
"warning",
"blocking"
],
"type": "string"
}
},
"required": [
"severity",
"description"
],
"type": "object"
},
"type": "array"
},
"dangerous": {
"type": "boolean"
},
"kind": {
"enum": [
"command",
"workflow",
"diagnostic",
"concept",
"change",
"upgrade"
],
"type": "string"
},
"last_verified_at": {
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"prerequisites": {
"items": {
"type": "string"
},
"type": "array"
},
"procedure": {
"items": {
"type": "string"
},
"type": "array"
},
"quality_score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"revision_ref": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"risks": {
"items": {
"type": "string"
},
"type": "array"
},
"rollback": {
"items": {
"type": "string"
},
"type": "array"
},
"summary": {
"type": "string"
},
"title": {
"type": "string"
},
"verification": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"revision_ref",
"kind",
"title",
"summary",
"applicability",
"cli_mode",
"command",
"procedure",
"prerequisites",
"risks",
"verification",
"rollback",
"last_verified_at",
"confidence",
"quality_score",
"dangerous",
"assurance",
"conflicts",
"limitations"
],
"type": "object"
},
{
"type": "null"
}
]
},
"created_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"failure": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
{
"type": "null"
}
]
},
"input_request": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"milestones": {
"items": {
"additionalProperties": false,
"properties": {
"created_at": {
"type": "string"
},
"message": {
"type": "string"
},
"progress_percent": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"stage": {
"type": "string"
}
},
"required": [
"stage",
"progress_percent",
"message",
"created_at"
],
"type": "object"
},
"type": "array"
},
"poll_after_ms": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"progress_percent": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"published_release_sequence": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"stage": {
"enum": [
"queued",
"researching",
"conflict_check",
"validating",
"publishing",
"completed",
"failed",
"cancelled"
],
"type": "string"
},
"status": {
"enum": [
"queued",
"claimed",
"researching",
"input_required",
"validating",
"publishing",
"completed",
"failed",
"cancelled",
"expired"
],
"type": "string"
},
"task_id": {
"type": "string"
}
},
"required": [
"task_id",
"status",
"created_at",
"expires_at",
"input_request",
"answer",
"failure",
"poll_after_ms",
"stage",
"progress_percent",
"milestones",
"published_release_sequence"
],
"type": "object"
}
},
{
"description": "Resolve vendor, model/platform, portable software family, operating system, and version context.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"model": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"operating_system": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"runtime_mode": {
"enum": [
"normal",
"rescue",
"installer",
"update",
"uninstall",
"recovery",
"diagnostic"
],
"type": "string"
},
"shell_environment": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"vendor": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"version": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z0-9][A-Za-z0-9()._\\-/]*$",
"type": "string"
}
},
"type": "object"
},
"name": "resolve_network_context",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"ambiguities": {
"items": {
"type": "string"
},
"type": "array"
},
"applicable_version": {
"type": "string"
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"model_resolved": {
"type": "boolean"
},
"operating_system": {
"type": "string"
},
"operating_system_slug": {
"type": "string"
},
"platform_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"portable_operating_system": {
"type": "boolean"
},
"resolution_confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"runtime_mode": {
"anyOf": [
{
"enum": [
"normal",
"rescue",
"installer",
"update",
"uninstall",
"recovery",
"diagnostic"
],
"type": "string"
},
{
"type": "null"
}
]
},
"shell_environment": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"software_family": {
"type": "string"
},
"software_family_slug": {
"type": "string"
},
"vendor": {
"type": "string"
},
"vendor_resolved": {
"type": "boolean"
},
"vendor_slug": {
"type": "string"
},
"version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"vendor",
"vendor_slug",
"model",
"platform_slug",
"operating_system",
"operating_system_slug",
"version",
"applicable_version",
"resolution_confidence",
"ambiguities"
],
"type": "object"
}
},
{
"description": "Deterministic advisory review of commands or a configuration diff. It always returns available guidance and never executes a command. Missing or incomplete knowledge may create or update a tracked research demand.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"commands": {
"items": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"config_diff": {
"maxLength": 32000,
"type": "string"
},
"context": {
"properties": {
"model": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"operating_system": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"runtime_mode": {
"enum": [
"normal",
"rescue",
"installer",
"update",
"uninstall",
"recovery",
"diagnostic"
],
"type": "string"
},
"shell_environment": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"vendor": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"version": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z0-9][A-Za-z0-9()._\\-/]*$",
"type": "string"
}
},
"type": "object"
},
"intent": {
"maxLength": 2000,
"minLength": 5,
"type": "string"
}
},
"required": [
"intent",
"context"
],
"type": "object"
},
"name": "review_network_change",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"approval_required": {
"type": "boolean"
},
"blast_radius": {
"items": {
"type": "string"
},
"type": "array"
},
"decision": {
"enum": [
"allowed_with_checks",
"manual_review_required",
"blocked",
"unknown"
],
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"matched_rules": {
"items": {
"type": "string"
},
"type": "array"
},
"operational_guidance": {
"items": {
"type": "string"
},
"type": "array"
},
"prechecks": {
"items": {
"type": "string"
},
"type": "array"
},
"risk_level": {
"enum": [
"low",
"medium",
"high",
"critical"
],
"type": "string"
},
"rollback": {
"items": {
"type": "string"
},
"type": "array"
},
"stop_conditions": {
"items": {
"type": "string"
},
"type": "array"
},
"unknown_commands": {
"items": {
"type": "string"
},
"type": "array"
},
"verification_plan": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"type": "string"
},
"id": {
"type": "string"
},
"required": {
"type": "boolean"
}
},
"required": [
"id",
"description",
"required"
],
"type": "object"
},
"type": "array"
},
"verification_token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"verification_token_expires_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"decision",
"risk_level",
"blast_radius",
"matched_rules",
"unknown_commands",
"operational_guidance",
"prechecks",
"stop_conditions",
"verification_plan",
"rollback",
"approval_required",
"verification_token",
"verification_token_expires_at",
"limitations"
],
"type": "object"
}
},
{
"description": "Submit correctness, freshness, safety, or completeness feedback without including private logs.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"access_token": {
"maxLength": 128,
"minLength": 32,
"type": "string"
},
"category": {
"enum": [
"correct",
"incorrect",
"outdated",
"unsafe",
"incomplete",
"other"
],
"type": "string"
},
"comment": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"rating": {
"maximum": 1,
"minimum": -1,
"type": "integer"
},
"revision_ref": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"sample_contribution": {
"properties": {
"consent": {
"const": true,
"type": "boolean"
},
"consent_version": {
"const": "2026-07-01",
"type": "string"
},
"detected_context": {
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"sanitized_payload": {
"minLength": 1,
"type": "string"
},
"snapshot_type": {
"enum": [
"show_version",
"config",
"log",
"topology",
"other"
],
"type": "string"
}
},
"required": [
"consent",
"consent_version",
"snapshot_type",
"sanitized_payload"
],
"type": "object"
},
"task_id": {
"pattern": "^ekt_[A-Za-z0-9_-]{32}$",
"type": "string"
}
},
"required": [
"category"
],
"type": "object"
},
"name": "submit_feedback",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"accepted": {
"const": true,
"type": "boolean"
},
"contribution_id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"feedback_id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
}
},
"required": [
"accepted",
"feedback_id"
],
"type": "object"
}
},
{
"description": "Evaluate bounded before/after outputs against the signed verification plan returned by review_network_change.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"after_snapshot": {
"maxLength": 30000,
"type": "string"
},
"before_snapshot": {
"maxLength": 30000,
"type": "string"
},
"verification_token": {
"maxLength": 16000,
"minLength": 40,
"type": "string"
}
},
"required": [
"verification_token",
"before_snapshot",
"after_snapshot"
],
"type": "object"
},
"name": "verify_network_change",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"checks": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"type": "string"
},
"evidence": {
"type": "string"
},
"id": {
"type": "string"
},
"status": {
"enum": [
"passed",
"failed",
"indeterminate"
],
"type": "string"
}
},
"required": [
"id",
"description",
"status",
"evidence"
],
"type": "object"
},
"type": "array"
},
"next_action": {
"type": "string"
},
"result": {
"enum": [
"passed",
"failed",
"partial",
"indeterminate"
],
"type": "string"
},
"retention": {
"const": "not_stored",
"type": "string"
},
"rollback_recommended": {
"type": "boolean"
}
},
"required": [
"result",
"checks",
"rollback_recommended",
"next_action",
"retention"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:48e7363aa9979396db1717f6a0081d84821b5315c57c4b55877fa9145d8311b5 | sha256sum