Serveur MCP

CliDeck MCP — Network Knowledge

com.clideck/network-knowledge
Cloud et infrastructure Outils développeur Public et accessible MCP 2025-11-25

Ce que fait ce MCP

Provides deterministic network-device knowledge, topology and path analysis, upgrade planning, configuration review, and change verification without executing commands.

advise_network_upgrade
Advise Network Upgrade
Return exact-model, exact-version upgrade prerequisites, risks, checks, and rollback without downloading software.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['model', 'current_version', 'target_version'], 'properties': {'model': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'target_version': {'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9()._\\-/]*$', 'maxLength': 64, 'minLength': 1}, 'current_version': {'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9()._\\-/]*$', 'maxLength': 64, 'minLength': 1}, 'enabled_features': {'type': 'array', 'items': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'default': [], 'maxItems': 30}, 'operating_system': {'type': 'string', 'default': 'IOS XE', 'maxLength': 240, 'minLength': 1}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'applicability', 'breaking_changes', 'security_advisories', 'prerequisites', 'procedure', 'verification', 'rollback', 'reload_expected', 'next_action', 'assurance', 'limitations'], 'properties': {'status': {'enum': ['supported_with_checks', 'blocked', 'unknown'], 'type': 'string'}, 'rollback': {'type': 'array', 'items': {'type': 'string'}}, 'assurance': {'type': 'object', 'required': ['validation_level', 'last_verified_at', 'confidence'], 'properties': {'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'last_verified_at': {'type': 'string'}, 'validation_level': {'type': 'string', 'const': 'documentation_reviewed'}}, 'additionalProperties': False}, 'procedure': {'type': 'array', 'items': {'type': 'string'}}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'next_action': {'enum': ['use_advice', 'request_expert_answer'], 'type': 'string'}, 'verification': {'type': 'array', 'items': {'type': 'string'}}, 'applicability': {'type': 'object', 'required': ['vendor', 'model', 'operating_system', 'current_version', 'target_version'], 'properties': {'model': {'type': 'string'}, 'vendor': {'type': 'string'}, 'target_version': {'type': 'string'}, 'current_version': {'type': 'string'}, 'operating_system': {'type': 'string'}}, 'additionalProperties': False}, 'prerequisites': {'type': 'array', 'items': {'type': 'string'}}, 'reload_expected': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'breaking_changes': {'type': 'array', 'items': {'type': 'string'}}, 'security_advisories': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'applicability', 'disposition'], 'properties': {'id': {'type': 'string'}, 'disposition': {'type': 'string'}, 'applicability': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
analyze_device_snapshot
Analyze Device Snapshot
Detect vendor, model, operating system, and version from bounded CLI output while redacting sensitive values. Input is not stored.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['snapshot'], 'properties': {'snapshot': {'type': 'string', 'minLength': 1}, 'snapshot_type': {'enum': ['auto', 'show_version', 'config', 'log', 'topology', 'other'], 'type': 'string', 'default': 'auto'}, 'redaction_profile': {'enum': ['secrets_only', 'strict'], 'type': 'string', 'default': 'strict'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['context', 'snapshot_type', 'sanitized_snapshot', 'redactions', 'retention', 'limitations'], 'properties': {'context': {'anyOf': [{'type': 'object', 'required': ['vendor', 'model', 'operating_system', 'version', 'support_level', 'confidence', 'ambiguities'], 'properties': {'model': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'vendor': {'type': 'string'}, 'version': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'ambiguities': {'type': 'array', 'items': {'type': 'string'}}, 'support_level': {'enum': ['deep', 'recognized'], 'type': 'string'}, 'operating_system': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'retention': {'type': 'string', 'const': 'not_stored'}, 'redactions': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'count'], 'properties': {'type': {'type': 'string'}, 'count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}}, 'additionalProperties': False}}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'snapshot_type': {'enum': ['show_version', 'config', 'log', 'topology', 'other'], 'type': 'string'}, 'sanitized_snapshot': {'type': 'string'}}, 'additionalProperties': False}
analyze_network_path
Analyze Network Path
Build a bounded topology and packet-path graph from supplied CDP, LLDP, route, and traceroute outputs without storing them.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['snapshots'], 'properties': {'source': {'type': 'string', 'maxLength': 120}, 'snapshots': {'type': 'array', 'items': {'type': 'object', 'required': ['device_hint', 'output_type', 'content'], 'properties': {'content': {'type': 'string', 'maxLength': 16000, 'minLength': 1}, 'device_hint': {'type': 'string', 'maxLength': 120, 'minLength': 1}, 'output_type': {'enum': ['auto', 'cdp', 'lldp', 'route', 'traceroute'], 'type': 'string'}}}, 'maxItems': 8, 'minItems': 1}, 'destination': {'type': 'string', 'maxLength': 120}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['nodes', 'edges', 'paths', 'probable_fault_domain', 'findings', 'unparsed_inputs', 'parse_diagnostics', 'retention', 'limitations'], 'properties': {'edges': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'source', 'target', 'local_interface', 'remote_interface', 'protocol'], 'properties': {'id': {'type': 'string'}, 'source': {'type': 'string'}, 'target': {'type': 'string'}, 'protocol': {'enum': ['cdp', 'lldp', 'route', 'traceroute'], 'type': 'string'}, 'local_interface': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'remote_interface': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'nodes': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'label', 'kind', 'attributes'], 'properties': {'id': {'type': 'string'}, 'kind': {'enum': ['device', 'hop', 'network', 'unknown'], 'type': 'string'}, 'label': {'type': 'string'}, 'attributes': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}}, 'additionalProperties': False}}, 'paths': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'destination', 'hops', 'complete'], 'properties': {'hops': {'type': 'array', 'items': {'type': 'string'}}, 'source': {'type': 'string'}, 'complete': {'type': 'boolean'}, 'destination': {'type': 'string'}}, 'additionalProperties': False}}, 'findings': {'type': 'array', 'items': {'type': 'string'}}, 'retention': {'type': 'string', 'const': 'not_stored'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'unparsed_inputs': {'type': 'array', 'items': {'type': 'string'}}, 'parse_diagnostics': {'type': 'array', 'items': {'type': 'object', 'required': ['snapshot_index', 'requested_type', 'detected_type', 'status', 'records_parsed', 'warnings'], 'properties': {'status': {'enum': ['parsed', 'partial', 'unparsed'], 'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'detected_type': {'anyOf': [{'enum': ['cdp', 'lldp', 'route', 'traceroute'], 'type': 'string'}, {'type': 'null'}]}, 'records_parsed': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'requested_type': {'enum': ['auto', 'cdp', 'lldp', 'route', 'traceroute'], 'type': 'string'}, 'snapshot_index': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}}, 'probable_fault_domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}
cancel_expert_task
Cancel Expert Task
Cancel a non-terminal expert task.
Destructif Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['task_id'], 'properties': {'task_id': {'type': 'string', 'pattern': '^ekt_[A-Za-z0-9_-]{32}$'}, 'access_token': {'type': 'string', 'maxLength': 128, 'minLength': 32}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['task_id', 'status', 'created_at', 'expires_at', 'input_request', 'answer', 'failure', 'poll_after_ms', 'stage', 'progress_percent', 'milestones', 'published_release_sequence'], 'properties': {'stage': {'enum': ['queued', 'researching', 'conflict_check', 'validating', 'publishing', 'completed', 'failed', 'cancelled'], 'type': 'string'}, 'answer': {'anyOf': [{'type': 'object', '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'], 'properties': {'kind': {'enum': ['command', 'workflow', 'diagnostic', 'concept', 'change', 'upgrade'], 'type': 'string'}, 'risks': {'type': 'array', 'items': {'type': 'string'}}, 'title': {'type': 'string'}, 'command': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'summary': {'type': 'string'}, 'cli_mode': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'rollback': {'type': 'array', 'items': {'type': 'string'}}, 'assurance': {'type': 'object', 'required': ['validation_level', 'independent_confirmations', 'confidence_explanation', 'next_review_at', 'lab_validated_at'], 'properties': {'next_review_at': {'type': 'string'}, 'lab_validated_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'validation_level': {'enum': ['legacy_migrated', 'documentation_reviewed', 'batfish_modeled', 'runtime_lab_validated'], 'type': 'string'}, 'confidence_explanation': {'type': 'string'}, 'independent_confirmations': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}}, 'additionalProperties': False}, 'conflicts': {'type': 'array', 'items': {'type': 'object', 'required': ['severity', 'description'], 'properties': {'severity': {'enum': ['informational', 'warning', 'blocking'], 'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}}, 'dangerous': {'type': 'boolean'}, 'procedure': {'type': 'array', 'items': {'type': 'string'}}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'revision_ref': {'type': 'string', '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)$'}, 'verification': {'type': 'array', 'items': {'type': 'string'}}, 'applicability': {'type': 'object', 'required': ['vendor', 'model', 'operating_system', 'versions'], 'properties': {'model': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'vendor': {'type': 'string'}, 'versions': {'type': 'object', 'required': ['minimum', 'maximum', 'requested'], 'properties': {'maximum': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'minimum': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'requested': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'match_level': {'enum': ['exact_model', 'vendor_os', 'architecture_os', 'os_family'], 'type': 'string'}, 'version_match': {'enum': ['exact', 'explicit_range', 'branch', 'unbounded', 'same_branch_fallback'], 'type': 'string'}, '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'}, 'operating_system': {'type': 'string'}, 'documented_version_relation': {'enum': ['older', 'newer', 'different', 'not_comparable', 'unspecified'], 'type': 'string'}, 'requires_platform_confirmation': {'type': 'boolean'}}, 'additionalProperties': False}, 'prerequisites': {'type': 'array', 'items': {'type': 'string'}}, 'quality_score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'last_verified_at': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'status': {'enum': ['queued', 'claimed', 'researching', 'input_required', 'validating', 'publishing', 'completed', 'failed', 'cancelled', 'expired'], 'type': 'string'}, 'failure': {'anyOf': [{'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'task_id': {'type': 'string'}, 'created_at': {'type': 'string'}, 'expires_at': {'type': 'string'}, 'milestones': {'type': 'array', 'items': {'type': 'object', 'required': ['stage', 'progress_percent', 'message', 'created_at'], 'properties': {'stage': {'type': 'string'}, 'message': {'type': 'string'}, 'created_at': {'type': 'string'}, 'progress_percent': {'type': 'integer', 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}}, 'input_request': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'poll_after_ms': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'progress_percent': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'published_release_sequence': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}]}}, 'additionalProperties': False}
continue_expert_task
Continue Expert Task
Provide bounded additional input requested by the researcher.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['task_id', 'message'], 'properties': {'message': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'task_id': {'type': 'string', 'pattern': '^ekt_[A-Za-z0-9_-]{32}$'}, 'access_token': {'type': 'string', 'maxLength': 128, 'minLength': 32}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['task_id', 'status', 'created_at', 'expires_at', 'input_request', 'answer', 'failure', 'poll_after_ms', 'stage', 'progress_percent', 'milestones', 'published_release_sequence'], 'properties': {'stage': {'enum': ['queued', 'researching', 'conflict_check', 'validating', 'publishing', 'completed', 'failed', 'cancelled'], 'type': 'string'}, 'answer': {'anyOf': [{'type': 'object', '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'], 'properties': {'kind': {'enum': ['command', 'workflow', 'diagnostic', 'concept', 'change', 'upgrade'], 'type': 'string'}, 'risks': {'type': 'array', 'items': {'type': 'string'}}, 'title': {'type': 'string'}, 'command': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'summary': {'type': 'string'}, 'cli_mode': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'rollback': {'type': 'array', 'items': {'type': 'string'}}, 'assurance': {'type': 'object', 'required': ['validation_level', 'independent_confirmations', 'confidence_explanation', 'next_review_at', 'lab_validated_at'], 'properties': {'next_review_at': {'type': 'string'}, 'lab_validated_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'validation_level': {'enum': ['legacy_migrated', 'documentation_reviewed', 'batfish_modeled', 'runtime_lab_validated'], 'type': 'string'}, 'confidence_explanation': {'type': 'string'}, 'independent_confirmations': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}}, 'additionalProperties': False}, 'conflicts': {'type': 'array', 'items': {'type': 'object', 'required': ['severity', 'description'], 'properties': {'severity': {'enum': ['informational', 'warning', 'blocking'], 'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}}, 'dangerous': {'type': 'boolean'}, 'procedure': {'type': 'array', 'items': {'type': 'string'}}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'revision_ref': {'type': 'string', '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)$'}, 'verification': {'type': 'array', 'items': {'type': 'string'}}, 'applicability': {'type': 'object', 'required': ['vendor', 'model', 'operating_system', 'versions'], 'properties': {'model': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'vendor': {'type': 'string'}, 'versions': {'type': 'object', 'required': ['minimum', 'maximum', 'requested'], 'properties': {'maximum': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'minimum': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'requested': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'match_level': {'enum': ['exact_model', 'vendor_os', 'architecture_os', 'os_family'], 'type': 'string'}, 'version_match': {'enum': ['exact', 'explicit_range', 'branch', 'unbounded', 'same_branch_fallback'], 'type': 'string'}, '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'}, 'operating_system': {'type': 'string'}, 'documented_version_relation': {'enum': ['older', 'newer', 'different', 'not_comparable', 'unspecified'], 'type': 'string'}, 'requires_platform_confirmation': {'type': 'boolean'}}, 'additionalProperties': False}, 'prerequisites': {'type': 'array', 'items': {'type': 'string'}}, 'quality_score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'last_verified_at': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'status': {'enum': ['queued', 'claimed', 'researching', 'input_required', 'validating', 'publishing', 'completed', 'failed', 'cancelled', 'expired'], 'type': 'string'}, 'failure': {'anyOf': [{'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'task_id': {'type': 'string'}, 'created_at': {'type': 'string'}, 'expires_at': {'type': 'string'}, 'milestones': {'type': 'array', 'items': {'type': 'object', 'required': ['stage', 'progress_percent', 'message', 'created_at'], 'properties': {'stage': {'type': 'string'}, 'message': {'type': 'string'}, 'created_at': {'type': 'string'}, 'progress_percent': {'type': 'integer', 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}}, 'input_request': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'poll_after_ms': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'progress_percent': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'published_release_sequence': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}]}}, 'additionalProperties': False}
describe_knowledge_domain
Describe Knowledge Domain
Return the context and public-record contracts for one installed knowledge domain.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domain_id'], 'properties': {'domain_id': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9-]{1,62}$'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['manifest', 'schemas'], 'properties': {'schemas': {'type': 'object', 'required': ['context', 'public_record'], 'properties': {'context': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'$ref': '#/definitions/__schema0'}}, 'public_record': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'$ref': '#/definitions/__schema0'}}}, 'additionalProperties': False}, 'manifest': {'type': 'object', 'required': ['schema_version', 'id', 'version', 'display_name', 'description', 'core_compatibility', 'context_dimensions', 'record_types', 'capabilities'], 'properties': {'id': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9-]{1,62}$'}, 'version': {'type': 'string', 'pattern': '^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-[0-9A-Za-z.-]+)?$'}, 'description': {'type': 'string', 'maxLength': 500, 'minLength': 10}, 'capabilities': {'type': 'object', 'required': ['search', 'workflows', 'continuous_learning', 'artifacts', 'spatial', 'relations', 'lab_validation'], 'properties': {'search': {'type': 'boolean', 'default': True}, 'spatial': {'type': 'boolean', 'default': False}, 'artifacts': {'type': 'boolean', 'default': False}, 'relations': {'type': 'boolean', 'default': False}, 'workflows': {'type': 'boolean', 'default': False}, 'lab_validation': {'type': 'boolean', 'default': False}, 'continuous_learning': {'type': 'boolean', 'default': False}}, 'additionalProperties': False}, 'display_name': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'record_types': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'display_name', 'description'], 'properties': {'id': {'type': 'string', 'pattern': '^[a-z][a-z0-9._-]{1,63}$'}, 'description': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'display_name': {'type': 'string', 'maxLength': 80, 'minLength': 1}}, 'additionalProperties': False}, 'maxItems': 64, 'minItems': 1}, 'schema_version': {'type': 'string', 'const': '1'}, 'context_dimensions': {'type': 'array', 'items': {'type': 'object', 'required': ['key', 'display_name', 'description', 'value_type', 'required'], 'properties': {'key': {'type': 'string', 'pattern': '^[a-z][a-z0-9._-]{1,63}$'}, 'required': {'type': 'boolean'}, 'value_type': {'enum': ['string', 'number', 'boolean', 'date', 'enum', 'json'], 'type': 'string'}, 'description': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'display_name': {'type': 'string', 'maxLength': 80, 'minLength': 1}}, 'additionalProperties': False}, 'maxItems': 32, 'minItems': 1}, 'core_compatibility': {'type': 'object', 'required': ['minimum'], 'properties': {'maximum': {'type': 'string', 'pattern': '^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-[0-9A-Za-z.-]+)?$'}, 'minimum': {'type': 'string', 'pattern': '^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-[0-9A-Za-z.-]+)?$'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'definitions': {'__schema0': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}, {'type': 'null'}, {'type': 'array', 'items': {'$ref': '#/definitions/__schema0'}}, {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'$ref': '#/definitions/__schema0'}}]}}, 'additionalProperties': False}
get_expert_task
Get Expert Task
Poll an expert research task by opaque ID and access token.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['task_id'], 'properties': {'task_id': {'type': 'string', 'pattern': '^ekt_[A-Za-z0-9_-]{32}$'}, 'access_token': {'type': 'string', 'maxLength': 128, 'minLength': 32}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['task_id', 'status', 'created_at', 'expires_at', 'input_request', 'answer', 'failure', 'poll_after_ms', 'stage', 'progress_percent', 'milestones', 'published_release_sequence'], 'properties': {'stage': {'enum': ['queued', 'researching', 'conflict_check', 'validating', 'publishing', 'completed', 'failed', 'cancelled'], 'type': 'string'}, 'answer': {'anyOf': [{'type': 'object', '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'], 'properties': {'kind': {'enum': ['command', 'workflow', 'diagnostic', 'concept', 'change', 'upgrade'], 'type': 'string'}, 'risks': {'type': 'array', 'items': {'type': 'string'}}, 'title': {'type': 'string'}, 'command': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'summary': {'type': 'string'}, 'cli_mode': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'rollback': {'type': 'array', 'items': {'type': 'string'}}, 'assurance': {'type': 'object', 'required': ['validation_level', 'independent_confirmations', 'confidence_explanation', 'next_review_at', 'lab_validated_at'], 'properties': {'next_review_at': {'type': 'string'}, 'lab_validated_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'validation_level': {'enum': ['legacy_migrated', 'documentation_reviewed', 'batfish_modeled', 'runtime_lab_validated'], 'type': 'string'}, 'confidence_explanation': {'type': 'string'}, 'independent_confirmations': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}}, 'additionalProperties': False}, 'conflicts': {'type': 'array', 'items': {'type': 'object', 'required': ['severity', 'description'], 'properties': {'severity': {'enum': ['informational', 'warning', 'blocking'], 'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}}, 'dangerous': {'type': 'boolean'}, 'procedure': {'type': 'array', 'items': {'type': 'string'}}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'revision_ref': {'type': 'string', '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)$'}, 'verification': {'type': 'array', 'items': {'type': 'string'}}, 'applicability': {'type': 'object', 'required': ['vendor', 'model', 'operating_system', 'versions'], 'properties': {'model': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'vendor': {'type': 'string'}, 'versions': {'type': 'object', 'required': ['minimum', 'maximum', 'requested'], 'properties': {'maximum': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'minimum': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'requested': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'match_level': {'enum': ['exact_model', 'vendor_os', 'architecture_os', 'os_family'], 'type': 'string'}, 'version_match': {'enum': ['exact', 'explicit_range', 'branch', 'unbounded', 'same_branch_fallback'], 'type': 'string'}, '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'}, 'operating_system': {'type': 'string'}, 'documented_version_relation': {'enum': ['older', 'newer', 'different', 'not_comparable', 'unspecified'], 'type': 'string'}, 'requires_platform_confirmation': {'type': 'boolean'}}, 'additionalProperties': False}, 'prerequisites': {'type': 'array', 'items': {'type': 'string'}}, 'quality_score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'last_verified_at': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'status': {'enum': ['queued', 'claimed', 'researching', 'input_required', 'validating', 'publishing', 'completed', 'failed', 'cancelled', 'expired'], 'type': 'string'}, 'failure': {'anyOf': [{'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'task_id': {'type': 'string'}, 'created_at': {'type': 'string'}, 'expires_at': {'type': 'string'}, 'milestones': {'type': 'array', 'items': {'type': 'object', 'required': ['stage', 'progress_percent', 'message', 'created_at'], 'properties': {'stage': {'type': 'string'}, 'message': {'type': 'string'}, 'created_at': {'type': 'string'}, 'progress_percent': {'type': 'integer', 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}}, 'input_request': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'poll_after_ms': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'progress_percent': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'published_release_sequence': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}]}}, 'additionalProperties': False}
get_knowledge_provenance
Get Knowledge Provenance
Return safe source metadata for up to five active knowledge revisions.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['revision_refs'], 'properties': {'revision_refs': {'type': 'array', 'items': {'type': 'string', '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)$'}, 'maxItems': 5, 'minItems': 1}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['revisions'], 'properties': {'revisions': {'type': 'array', 'items': {'type': 'object', 'required': ['revision_ref', 'sources'], 'properties': {'sources': {'type': 'array', 'items': {'type': 'object', 'required': ['source_ref', 'source_kind', 'title', 'url', 'document_version', 'document_date', 'verified_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'pattern': '^https:\\/\\/.*'}, 'title': {'type': 'string'}, 'source_ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_kind': {'enum': ['official_web', 'admin_web', 'admin_document', 'pasted_text', 'field_log'], 'type': 'string'}, 'verified_at': {'type': 'string'}, 'document_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'document_version': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'revision_ref': {'type': 'string', '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)$'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
get_network_workflow
Get Network Workflow
Return a deterministic, ordered workflow including safety, verification, and rollback.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['goal', 'context'], 'properties': {'goal': {'type': 'string', 'maxLength': 2000, 'minLength': 3}, 'limit': {'type': 'integer', 'default': 1, 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'context': {'type': 'object', 'properties': {'model': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'vendor': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'version': {'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9()._\\-/]*$', 'maxLength': 64, 'minLength': 1}, 'runtime_mode': {'enum': ['normal', 'rescue', 'installer', 'update', 'uninstall', 'recovery', 'diagnostic'], 'type': 'string'}, 'operating_system': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'shell_environment': {'type': 'string', 'maxLength': 120, 'minLength': 1}}}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['context', 'answers', 'cross_platform_examples', 'unknown', 'next_action'], 'properties': {'answers': {'type': 'array', 'items': {'type': 'object', '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'], 'properties': {'kind': {'enum': ['command', 'workflow', 'diagnostic', 'concept', 'change', 'upgrade'], 'type': 'string'}, 'risks': {'type': 'array', 'items': {'type': 'string'}}, 'title': {'type': 'string'}, 'command': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'summary': {'type': 'string'}, 'cli_mode': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'rollback': {'type': 'array', 'items': {'type': 'string'}}, 'assurance': {'type': 'object', 'required': ['validation_level', 'independent_confirmations', 'confidence_explanation', 'next_review_at', 'lab_validated_at'], 'properties': {'next_review_at': {'type': 'string'}, 'lab_validated_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'validation_level': {'enum': ['legacy_migrated', 'documentation_reviewed', 'batfish_modeled', 'runtime_lab_validated'], 'type': 'string'}, 'confidence_explanation': {'type': 'string'}, 'independent_confirmations': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}}, 'additionalProperties': False}, 'conflicts': {'type': 'array', 'items': {'type': 'object', 'required': ['severity', 'description'], 'properties': {'severity': {'enum': ['informational', 'warning', 'blocking'], 'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}}, 'dangerous': {'type': 'boolean'}, 'procedure': {'type': 'array', 'items': {'type': 'string'}}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'revision_ref': {'type': 'string', '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)$'}, 'verification': {'type': 'array', 'items': {'type': 'string'}}, 'applicability': {'type': 'object', 'required': ['vendor', 'model', 'operating_system', 'versions'], 'properties': {'model': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'vendor': {'type': 'string'}, 'versions': {'type': 'object', 'required': ['minimum', 'maximum', 'requested'], 'properties': {'maximum': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'minimum': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'requested': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'match_level': {'enum': ['exact_model', 'vendor_os', 'architecture_os', 'os_family'], 'type': 'string'}, 'version_match': {'enum': ['exact', 'explicit_range', 'branch', 'unbounded', 'same_branch_fallback'], 'type': 'string'}, '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'}, 'operating_system': {'type': 'string'}, 'documented_version_relation': {'enum': ['older', 'newer', 'different', 'not_comparable', 'unspecified'], 'type': 'string'}, 'requires_platform_confirmation': {'type': 'boolean'}}, 'additionalProperties': False}, 'prerequisites': {'type': 'array', 'items': {'type': 'string'}}, 'quality_score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'last_verified_at': {'type': 'string'}}, 'additionalProperties': False}}, 'context': {'type': 'object', 'required': ['vendor', 'vendor_slug', 'model', 'platform_slug', 'operating_system', 'operating_system_slug', 'version', 'applicable_version', 'resolution_confidence', 'ambiguities'], 'properties': {'model': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'vendor': {'type': 'string'}, 'version': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'ambiguities': {'type': 'array', 'items': {'type': 'string'}}, 'vendor_slug': {'type': 'string'}, 'runtime_mode': {'anyOf': [{'enum': ['normal', 'rescue', 'installer', 'update', 'uninstall', 'recovery', 'diagnostic'], 'type': 'string'}, {'type': 'null'}]}, 'platform_slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'model_resolved': {'type': 'boolean'}, 'software_family': {'type': 'string'}, 'vendor_resolved': {'type': 'boolean'}, 'operating_system': {'type': 'string'}, 'shell_environment': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'applicable_version': {'type': 'string'}, 'software_family_slug': {'type': 'string'}, 'operating_system_slug': {'type': 'string'}, 'resolution_confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'portable_operating_system': {'type': 'boolean'}}, 'additionalProperties': False}, 'unknown': {'type': 'boolean'}, 'coverage': {'type': 'array', 'items': {'type': 'object', 'required': ['capability', 'label', 'status', 'answer_refs'], 'properties': {'label': {'type': 'string'}, 'status': {'enum': ['covered', 'missing'], 'type': 'string'}, 'capability': {'type': 'string'}, 'answer_refs': {'type': 'array', 'items': {'type': 'string', '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)$'}}}, 'additionalProperties': False}}, 'learning': {'type': 'object', 'required': ['status'], 'properties': {'status': {'enum': ['diagnosing', 'discovering', 'processing', 'rechecking', 'queued', 'not_required', 'unavailable'], 'type': 'string'}}, 'additionalProperties': False}, 'next_action': {'enum': ['use_answer', 'request_expert_answer'], 'type': 'string'}, 'answer_status': {'enum': ['complete', 'partial', 'unknown'], 'type': 'string'}, 'cross_platform_examples': {'type': 'array', 'items': {'type': 'object', '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'], 'properties': {'kind': {'enum': ['command', 'workflow', 'diagnostic', 'concept', 'change', 'upgrade'], 'type': 'string'}, 'risks': {'type': 'array', 'items': {'type': 'string'}}, 'title': {'type': 'string'}, 'command': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'summary': {'type': 'string'}, 'cli_mode': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'rollback': {'type': 'array', 'items': {'type': 'string'}}, 'assurance': {'type': 'object', 'required': ['validation_level', 'independent_confirmations', 'confidence_explanation', 'next_review_at', 'lab_validated_at'], 'properties': {'next_review_at': {'type': 'string'}, 'lab_validated_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'validation_level': {'enum': ['legacy_migrated', 'documentation_reviewed', 'batfish_modeled', 'runtime_lab_validated'], 'type': 'string'}, 'confidence_explanation': {'type': 'string'}, 'independent_confirmations': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}}, 'additionalProperties': False}, 'conflicts': {'type': 'array', 'items': {'type': 'object', 'required': ['severity', 'description'], 'properties': {'severity': {'enum': ['informational', 'warning', 'blocking'], 'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}}, 'dangerous': {'type': 'boolean'}, 'procedure': {'type': 'array', 'items': {'type': 'string'}}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'revision_ref': {'type': 'string', '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)$'}, 'verification': {'type': 'array', 'items': {'type': 'string'}}, 'applicability': {'type': 'object', 'required': ['vendor', 'model', 'operating_system', 'versions'], 'properties': {'model': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'vendor': {'type': 'string'}, 'versions': {'type': 'object', 'required': ['minimum', 'maximum', 'requested'], 'properties': {'maximum': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'minimum': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'requested': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'match_level': {'enum': ['exact_model', 'vendor_os', 'architecture_os', 'os_family'], 'type': 'string'}, 'version_match': {'enum': ['exact', 'explicit_range', 'branch', 'unbounded', 'same_branch_fallback'], 'type': 'string'}, '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'}, 'operating_system': {'type': 'string'}, 'documented_version_relation': {'enum': ['older', 'newer', 'different', 'not_comparable', 'unspecified'], 'type': 'string'}, 'requires_platform_confirmation': {'type': 'boolean'}}, 'additionalProperties': False}, 'prerequisites': {'type': 'array', 'items': {'type': 'string'}}, 'quality_score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'last_verified_at': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
list_knowledge_domains
List Knowledge Domains
List installed, compatible knowledge domain packs and their declared capabilities.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domains'], 'properties': {'domains': {'type': 'array', 'items': {'type': 'object', 'required': ['schema_version', 'id', 'version', 'display_name', 'description', 'core_compatibility', 'context_dimensions', 'record_types', 'capabilities'], 'properties': {'id': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9-]{1,62}$'}, 'version': {'type': 'string', 'pattern': '^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-[0-9A-Za-z.-]+)?$'}, 'description': {'type': 'string', 'maxLength': 500, 'minLength': 10}, 'capabilities': {'type': 'object', 'required': ['search', 'workflows', 'continuous_learning', 'artifacts', 'spatial', 'relations', 'lab_validation'], 'properties': {'search': {'type': 'boolean', 'default': True}, 'spatial': {'type': 'boolean', 'default': False}, 'artifacts': {'type': 'boolean', 'default': False}, 'relations': {'type': 'boolean', 'default': False}, 'workflows': {'type': 'boolean', 'default': False}, 'lab_validation': {'type': 'boolean', 'default': False}, 'continuous_learning': {'type': 'boolean', 'default': False}}, 'additionalProperties': False}, 'display_name': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'record_types': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'display_name', 'description'], 'properties': {'id': {'type': 'string', 'pattern': '^[a-z][a-z0-9._-]{1,63}$'}, 'description': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'display_name': {'type': 'string', 'maxLength': 80, 'minLength': 1}}, 'additionalProperties': False}, 'maxItems': 64, 'minItems': 1}, 'schema_version': {'type': 'string', 'const': '1'}, 'context_dimensions': {'type': 'array', 'items': {'type': 'object', 'required': ['key', 'display_name', 'description', 'value_type', 'required'], 'properties': {'key': {'type': 'string', 'pattern': '^[a-z][a-z0-9._-]{1,63}$'}, 'required': {'type': 'boolean'}, 'value_type': {'enum': ['string', 'number', 'boolean', 'date', 'enum', 'json'], 'type': 'string'}, 'description': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'display_name': {'type': 'string', 'maxLength': 80, 'minLength': 1}}, 'additionalProperties': False}, 'maxItems': 32, 'minItems': 1}, 'core_compatibility': {'type': 'object', 'required': ['minimum'], 'properties': {'maximum': {'type': 'string', 'pattern': '^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-[0-9A-Za-z.-]+)?$'}, 'minimum': {'type': 'string', 'pattern': '^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-[0-9A-Za-z.-]+)?$'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'additionalProperties': False}
query_domain_knowledge
Query Domain Knowledge
Run deterministic search in one domain using that pack’s validated context and public-record schema.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domain_id', 'question', 'context'], 'properties': {'limit': {'type': 'integer', 'default': 5, 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'context': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'$ref': '#/definitions/__schema0'}}, 'question': {'type': 'string', 'maxLength': 2000, 'minLength': 3}, 'domain_id': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9-]{1,62}$'}}, 'definitions': {'__schema0': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}, {'type': 'null'}, {'type': 'array', 'items': {'$ref': '#/definitions/__schema0'}}, {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'$ref': '#/definitions/__schema0'}}]}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domain_id', 'context', 'answers', 'cross_platform_examples', 'unknown', 'next_action'], 'properties': {'answers': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'$ref': '#/definitions/__schema0'}}}, 'context': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'$ref': '#/definitions/__schema0'}}, 'unknown': {'type': 'boolean'}, 'coverage': {'type': 'array', 'items': {'type': 'object', 'required': ['capability', 'label', 'status', 'answer_refs'], 'properties': {'label': {'type': 'string'}, 'status': {'enum': ['covered', 'missing'], 'type': 'string'}, 'capability': {'type': 'string'}, 'answer_refs': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'learning': {'type': 'object', 'required': ['status'], 'properties': {'status': {'enum': ['diagnosing', 'discovering', 'processing', 'rechecking', 'queued', 'not_required', 'unavailable'], 'type': 'string'}}, 'additionalProperties': False}, 'domain_id': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9-]{1,62}$'}, 'next_action': {'enum': ['use_answer', 'knowledge_not_found'], 'type': 'string'}, 'answer_status': {'enum': ['complete', 'partial', 'unknown'], 'type': 'string'}, 'cross_platform_examples': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'$ref': '#/definitions/__schema0'}}}}, 'definitions': {'__schema0': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}, {'type': 'null'}, {'type': 'array', 'items': {'$ref': '#/definitions/__schema0'}}, {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'$ref': '#/definitions/__schema0'}}]}}, 'additionalProperties': False}
query_network_knowledge
Query Network Knowledge
Return deterministic, version-scoped commands, diagnostics, and concepts for a network question.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['question', 'context'], 'properties': {'limit': {'type': 'integer', 'default': 3, 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'context': {'type': 'object', 'properties': {'model': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'vendor': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'version': {'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9()._\\-/]*$', 'maxLength': 64, 'minLength': 1}, 'runtime_mode': {'enum': ['normal', 'rescue', 'installer', 'update', 'uninstall', 'recovery', 'diagnostic'], 'type': 'string'}, 'operating_system': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'shell_environment': {'type': 'string', 'maxLength': 120, 'minLength': 1}}}, 'question': {'type': 'string', 'maxLength': 2000, 'minLength': 3}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['context', 'answers', 'cross_platform_examples', 'unknown', 'next_action'], 'properties': {'answers': {'type': 'array', 'items': {'type': 'object', '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'], 'properties': {'kind': {'enum': ['command', 'workflow', 'diagnostic', 'concept', 'change', 'upgrade'], 'type': 'string'}, 'risks': {'type': 'array', 'items': {'type': 'string'}}, 'title': {'type': 'string'}, 'command': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'summary': {'type': 'string'}, 'cli_mode': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'rollback': {'type': 'array', 'items': {'type': 'string'}}, 'assurance': {'type': 'object', 'required': ['validation_level', 'independent_confirmations', 'confidence_explanation', 'next_review_at', 'lab_validated_at'], 'properties': {'next_review_at': {'type': 'string'}, 'lab_validated_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'validation_level': {'enum': ['legacy_migrated', 'documentation_reviewed', 'batfish_modeled', 'runtime_lab_validated'], 'type': 'string'}, 'confidence_explanation': {'type': 'string'}, 'independent_confirmations': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}}, 'additionalProperties': False}, 'conflicts': {'type': 'array', 'items': {'type': 'object', 'required': ['severity', 'description'], 'properties': {'severity': {'enum': ['informational', 'warning', 'blocking'], 'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}}, 'dangerous': {'type': 'boolean'}, 'procedure': {'type': 'array', 'items': {'type': 'string'}}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'revision_ref': {'type': 'string', '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)$'}, 'verification': {'type': 'array', 'items': {'type': 'string'}}, 'applicability': {'type': 'object', 'required': ['vendor', 'model', 'operating_system', 'versions'], 'properties': {'model': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'vendor': {'type': 'string'}, 'versions': {'type': 'object', 'required': ['minimum', 'maximum', 'requested'], 'properties': {'maximum': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'minimum': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'requested': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'match_level': {'enum': ['exact_model', 'vendor_os', 'architecture_os', 'os_family'], 'type': 'string'}, 'version_match': {'enum': ['exact', 'explicit_range', 'branch', 'unbounded', 'same_branch_fallback'], 'type': 'string'}, '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'}, 'operating_system': {'type': 'string'}, 'documented_version_relation': {'enum': ['older', 'newer', 'different', 'not_comparable', 'unspecified'], 'type': 'string'}, 'requires_platform_confirmation': {'type': 'boolean'}}, 'additionalProperties': False}, 'prerequisites': {'type': 'array', 'items': {'type': 'string'}}, 'quality_score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'last_verified_at': {'type': 'string'}}, 'additionalProperties': False}}, 'context': {'type': 'object', 'required': ['vendor', 'vendor_slug', 'model', 'platform_slug', 'operating_system', 'operating_system_slug', 'version', 'applicable_version', 'resolution_confidence', 'ambiguities'], 'properties': {'model': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'vendor': {'type': 'string'}, 'version': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'ambiguities': {'type': 'array', 'items': {'type': 'string'}}, 'vendor_slug': {'type': 'string'}, 'runtime_mode': {'anyOf': [{'enum': ['normal', 'rescue', 'installer', 'update', 'uninstall', 'recovery', 'diagnostic'], 'type': 'string'}, {'type': 'null'}]}, 'platform_slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'model_resolved': {'type': 'boolean'}, 'software_family': {'type': 'string'}, 'vendor_resolved': {'type': 'boolean'}, 'operating_system': {'type': 'string'}, 'shell_environment': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'applicable_version': {'type': 'string'}, 'software_family_slug': {'type': 'string'}, 'operating_system_slug': {'type': 'string'}, 'resolution_confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'portable_operating_system': {'type': 'boolean'}}, 'additionalProperties': False}, 'unknown': {'type': 'boolean'}, 'coverage': {'type': 'array', 'items': {'type': 'object', 'required': ['capability', 'label', 'status', 'answer_refs'], 'properties': {'label': {'type': 'string'}, 'status': {'enum': ['covered', 'missing'], 'type': 'string'}, 'capability': {'type': 'string'}, 'answer_refs': {'type': 'array', 'items': {'type': 'string', '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)$'}}}, 'additionalProperties': False}}, 'learning': {'type': 'object', 'required': ['status'], 'properties': {'status': {'enum': ['diagnosing', 'discovering', 'processing', 'rechecking', 'queued', 'not_required', 'unavailable'], 'type': 'string'}}, 'additionalProperties': False}, 'next_action': {'enum': ['use_answer', 'request_expert_answer'], 'type': 'string'}, 'answer_status': {'enum': ['complete', 'partial', 'unknown'], 'type': 'string'}, 'cross_platform_examples': {'type': 'array', 'items': {'type': 'object', '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'], 'properties': {'kind': {'enum': ['command', 'workflow', 'diagnostic', 'concept', 'change', 'upgrade'], 'type': 'string'}, 'risks': {'type': 'array', 'items': {'type': 'string'}}, 'title': {'type': 'string'}, 'command': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'summary': {'type': 'string'}, 'cli_mode': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'rollback': {'type': 'array', 'items': {'type': 'string'}}, 'assurance': {'type': 'object', 'required': ['validation_level', 'independent_confirmations', 'confidence_explanation', 'next_review_at', 'lab_validated_at'], 'properties': {'next_review_at': {'type': 'string'}, 'lab_validated_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'validation_level': {'enum': ['legacy_migrated', 'documentation_reviewed', 'batfish_modeled', 'runtime_lab_validated'], 'type': 'string'}, 'confidence_explanation': {'type': 'string'}, 'independent_confirmations': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}}, 'additionalProperties': False}, 'conflicts': {'type': 'array', 'items': {'type': 'object', 'required': ['severity', 'description'], 'properties': {'severity': {'enum': ['informational', 'warning', 'blocking'], 'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}}, 'dangerous': {'type': 'boolean'}, 'procedure': {'type': 'array', 'items': {'type': 'string'}}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'revision_ref': {'type': 'string', '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)$'}, 'verification': {'type': 'array', 'items': {'type': 'string'}}, 'applicability': {'type': 'object', 'required': ['vendor', 'model', 'operating_system', 'versions'], 'properties': {'model': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'vendor': {'type': 'string'}, 'versions': {'type': 'object', 'required': ['minimum', 'maximum', 'requested'], 'properties': {'maximum': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'minimum': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'requested': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'match_level': {'enum': ['exact_model', 'vendor_os', 'architecture_os', 'os_family'], 'type': 'string'}, 'version_match': {'enum': ['exact', 'explicit_range', 'branch', 'unbounded', 'same_branch_fallback'], 'type': 'string'}, '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'}, 'operating_system': {'type': 'string'}, 'documented_version_relation': {'enum': ['older', 'newer', 'different', 'not_comparable', 'unspecified'], 'type': 'string'}, 'requires_platform_confirmation': {'type': 'boolean'}}, 'additionalProperties': False}, 'prerequisites': {'type': 'array', 'items': {'type': 'string'}}, 'quality_score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'last_verified_at': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
request_expert_answer
Request Expert Answer
Create a durable research task when deterministic knowledge has no applicable answer.
Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['question', 'context'], 'properties': {'context': {'type': 'object', 'properties': {'model': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'vendor': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'version': {'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9()._\\-/]*$', 'maxLength': 64, 'minLength': 1}, 'runtime_mode': {'enum': ['normal', 'rescue', 'installer', 'update', 'uninstall', 'recovery', 'diagnostic'], 'type': 'string'}, 'operating_system': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'shell_environment': {'type': 'string', 'maxLength': 120, 'minLength': 1}}}, 'question': {'type': 'string', 'maxLength': 2000, 'minLength': 8}, 'idempotency_key': {'type': 'string', 'pattern': '^[A-Za-z0-9._:-]+$', 'maxLength': 128, 'minLength': 8}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['task_id', 'status', 'created_at', 'expires_at', 'input_request', 'answer', 'failure', 'poll_after_ms', 'stage', 'progress_percent', 'milestones', 'published_release_sequence'], 'properties': {'stage': {'enum': ['queued', 'researching', 'conflict_check', 'validating', 'publishing', 'completed', 'failed', 'cancelled'], 'type': 'string'}, 'answer': {'anyOf': [{'type': 'object', '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'], 'properties': {'kind': {'enum': ['command', 'workflow', 'diagnostic', 'concept', 'change', 'upgrade'], 'type': 'string'}, 'risks': {'type': 'array', 'items': {'type': 'string'}}, 'title': {'type': 'string'}, 'command': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'summary': {'type': 'string'}, 'cli_mode': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'rollback': {'type': 'array', 'items': {'type': 'string'}}, 'assurance': {'type': 'object', 'required': ['validation_level', 'independent_confirmations', 'confidence_explanation', 'next_review_at', 'lab_validated_at'], 'properties': {'next_review_at': {'type': 'string'}, 'lab_validated_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'validation_level': {'enum': ['legacy_migrated', 'documentation_reviewed', 'batfish_modeled', 'runtime_lab_validated'], 'type': 'string'}, 'confidence_explanation': {'type': 'string'}, 'independent_confirmations': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}}, 'additionalProperties': False}, 'conflicts': {'type': 'array', 'items': {'type': 'object', 'required': ['severity', 'description'], 'properties': {'severity': {'enum': ['informational', 'warning', 'blocking'], 'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}}, 'dangerous': {'type': 'boolean'}, 'procedure': {'type': 'array', 'items': {'type': 'string'}}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'revision_ref': {'type': 'string', '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)$'}, 'verification': {'type': 'array', 'items': {'type': 'string'}}, 'applicability': {'type': 'object', 'required': ['vendor', 'model', 'operating_system', 'versions'], 'properties': {'model': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'vendor': {'type': 'string'}, 'versions': {'type': 'object', 'required': ['minimum', 'maximum', 'requested'], 'properties': {'maximum': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'minimum': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'requested': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'match_level': {'enum': ['exact_model', 'vendor_os', 'architecture_os', 'os_family'], 'type': 'string'}, 'version_match': {'enum': ['exact', 'explicit_range', 'branch', 'unbounded', 'same_branch_fallback'], 'type': 'string'}, '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'}, 'operating_system': {'type': 'string'}, 'documented_version_relation': {'enum': ['older', 'newer', 'different', 'not_comparable', 'unspecified'], 'type': 'string'}, 'requires_platform_confirmation': {'type': 'boolean'}}, 'additionalProperties': False}, 'prerequisites': {'type': 'array', 'items': {'type': 'string'}}, 'quality_score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'last_verified_at': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'status': {'enum': ['queued', 'claimed', 'researching', 'input_required', 'validating', 'publishing', 'completed', 'failed', 'cancelled', 'expired'], 'type': 'string'}, 'failure': {'anyOf': [{'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'task_id': {'type': 'string'}, 'created_at': {'type': 'string'}, 'expires_at': {'type': 'string'}, 'milestones': {'type': 'array', 'items': {'type': 'object', 'required': ['stage', 'progress_percent', 'message', 'created_at'], 'properties': {'stage': {'type': 'string'}, 'message': {'type': 'string'}, 'created_at': {'type': 'string'}, 'progress_percent': {'type': 'integer', 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}}, 'access_token': {'type': 'string', 'maxLength': 128, 'minLength': 32}, 'input_request': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'poll_after_ms': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'progress_percent': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'published_release_sequence': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}]}}, 'additionalProperties': False}
resolve_network_context
Resolve Network Context
Resolve vendor, model/platform, portable software family, operating system, and version context.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'model': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'vendor': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'version': {'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9()._\\-/]*$', 'maxLength': 64, 'minLength': 1}, 'runtime_mode': {'enum': ['normal', 'rescue', 'installer', 'update', 'uninstall', 'recovery', 'diagnostic'], 'type': 'string'}, 'operating_system': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'shell_environment': {'type': 'string', 'maxLength': 120, 'minLength': 1}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['vendor', 'vendor_slug', 'model', 'platform_slug', 'operating_system', 'operating_system_slug', 'version', 'applicable_version', 'resolution_confidence', 'ambiguities'], 'properties': {'model': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'vendor': {'type': 'string'}, 'version': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'ambiguities': {'type': 'array', 'items': {'type': 'string'}}, 'vendor_slug': {'type': 'string'}, 'runtime_mode': {'anyOf': [{'enum': ['normal', 'rescue', 'installer', 'update', 'uninstall', 'recovery', 'diagnostic'], 'type': 'string'}, {'type': 'null'}]}, 'platform_slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'model_resolved': {'type': 'boolean'}, 'software_family': {'type': 'string'}, 'vendor_resolved': {'type': 'boolean'}, 'operating_system': {'type': 'string'}, 'shell_environment': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'applicable_version': {'type': 'string'}, 'software_family_slug': {'type': 'string'}, 'operating_system_slug': {'type': 'string'}, 'resolution_confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'portable_operating_system': {'type': 'boolean'}}, 'additionalProperties': False}
review_network_change
Review Network Change
Deterministic advisory review of commands or a configuration diff. It always returns available guidance and never executes a command.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['intent', 'context'], 'properties': {'intent': {'type': 'string', 'maxLength': 2000, 'minLength': 5}, 'context': {'type': 'object', 'properties': {'model': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'vendor': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'version': {'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9()._\\-/]*$', 'maxLength': 64, 'minLength': 1}, 'runtime_mode': {'enum': ['normal', 'rescue', 'installer', 'update', 'uninstall', 'recovery', 'diagnostic'], 'type': 'string'}, 'operating_system': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'shell_environment': {'type': 'string', 'maxLength': 120, 'minLength': 1}}}, 'commands': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'maxItems': 100}, 'config_diff': {'type': 'string', 'maxLength': 32000}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', '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'], 'properties': {'decision': {'enum': ['allowed_with_checks', 'manual_review_required', 'blocked', 'unknown'], 'type': 'string'}, 'rollback': {'type': 'array', 'items': {'type': 'string'}}, 'prechecks': {'type': 'array', 'items': {'type': 'string'}}, 'risk_level': {'enum': ['low', 'medium', 'high', 'critical'], 'type': 'string'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'blast_radius': {'type': 'array', 'items': {'type': 'string'}}, 'matched_rules': {'type': 'array', 'items': {'type': 'string'}}, 'stop_conditions': {'type': 'array', 'items': {'type': 'string'}}, 'unknown_commands': {'type': 'array', 'items': {'type': 'string'}}, 'approval_required': {'type': 'boolean'}, 'verification_plan': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'required'], 'properties': {'id': {'type': 'string'}, 'required': {'type': 'boolean'}, 'description': {'type': 'string'}}, 'additionalProperties': False}}, 'verification_token': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'operational_guidance': {'type': 'array', 'items': {'type': 'string'}}, 'verification_token_expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}
submit_feedback
Submit Feedback
Submit correctness, freshness, safety, or completeness feedback without including private logs.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['category'], 'properties': {'rating': {'type': 'integer', 'maximum': 1, 'minimum': -1}, 'comment': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'task_id': {'type': 'string', 'pattern': '^ekt_[A-Za-z0-9_-]{32}$'}, 'category': {'enum': ['correct', 'incorrect', 'outdated', 'unsafe', 'incomplete', 'other'], 'type': 'string'}, 'access_token': {'type': 'string', 'maxLength': 128, 'minLength': 32}, 'revision_ref': {'type': 'string', '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)$'}, 'sample_contribution': {'type': 'object', 'required': ['consent', 'consent_version', 'snapshot_type', 'sanitized_payload'], 'properties': {'consent': {'type': 'boolean', 'const': True}, 'snapshot_type': {'enum': ['show_version', 'config', 'log', 'topology', 'other'], 'type': 'string'}, 'consent_version': {'type': 'string', 'const': '2026-07-01'}, 'detected_context': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}, 'sanitized_payload': {'type': 'string', 'minLength': 1}}}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['accepted', 'feedback_id'], 'properties': {'accepted': {'type': 'boolean', 'const': True}, 'feedback_id': {'type': 'string', '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)$'}, 'contribution_id': {'type': 'string', '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)$'}}, 'additionalProperties': False}
verify_network_change
Verify Network Change
Evaluate bounded before/after outputs against the signed verification plan returned by review_network_change.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['verification_token', 'before_snapshot', 'after_snapshot'], 'properties': {'after_snapshot': {'type': 'string', 'maxLength': 30000}, 'before_snapshot': {'type': 'string', 'maxLength': 30000}, 'verification_token': {'type': 'string', 'maxLength': 16000, 'minLength': 40}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['result', 'checks', 'rollback_recommended', 'next_action', 'retention'], 'properties': {'checks': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'status', 'evidence'], 'properties': {'id': {'type': 'string'}, 'status': {'enum': ['passed', 'failed', 'indeterminate'], 'type': 'string'}, 'evidence': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}}, 'result': {'enum': ['passed', 'failed', 'partial', 'indeterminate'], 'type': 'string'}, 'retention': {'type': 'string', 'const': 'not_stored'}, 'next_action': {'type': 'string'}, 'rollback_recommended': {'type': 'boolean'}}, 'additionalProperties': False}
Ajouté
analyze_network_path
17 September 2026 12:34
Ajouté
advise_network_upgrade
17 September 2026 12:34
Ajouté
verify_network_change
17 September 2026 12:34
Ajouté
review_network_change
17 September 2026 12:34
Ajouté
analyze_device_snapshot
17 September 2026 12:34
Ajouté
submit_feedback
17 September 2026 12:34
Ajouté
cancel_expert_task
17 September 2026 12:34
Ajouté
continue_expert_task
17 September 2026 12:34
Ajouté
get_expert_task
17 September 2026 12:34
Ajouté
request_expert_answer
17 September 2026 12:34
Ajouté
get_network_workflow
17 September 2026 12:34
Ajouté
get_knowledge_provenance
17 September 2026 12:34
Ajouté
query_network_knowledge
17 September 2026 12:34
Ajouté
resolve_network_context
17 September 2026 12:34
Ajouté
query_domain_knowledge
17 September 2026 12:34
Ajouté
describe_knowledge_domain
17 September 2026 12:34
Ajouté
list_knowledge_domains
17 September 2026 12:34