flameox

Overview Schema Source Related Servers Discussions Admin

extract_perfetto

Extract profiler insights by running versioned curated queries on local Perfetto traces, enabling comparison and audit without uploading code or data.

Instructions

Run versioned curated queries through a configured local Trace Processor.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`run_id`	Yes
`artifact_id`	No

Output Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed59 schema fields changedv0.1.15Aug 30, 2026

removedOutput schema / $defs / ConfigureInferenceRecovery

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "kind": {
-      "const": "configure_inference",
-      "title": "Kind",
-      "type": "string"
-    },
-    "next_tool": {
-      "enum": [
-        "configure_inference_server",
-        "list_inference_configurations"
-      ],
-      "title": "Next Tool",
-      "type": "string"
-    },
-    "retry_after_ms": {
-      "default": null,
-      "title": "Retry After Ms",
-      "type": "null"
-    },
-    "safe_to_repeat_same_call": {
-      "const": false,
-      "default": false,
-      "title": "Safe To Repeat Same Call",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "kind",
-    "next_tool"
-  ],
-  "title": "ConfigureInferenceRecovery",
-  "type": "object"
-}

removedOutput schema / $defs / ConfigureWorkloadRecovery

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "context": {
-      "anyOf": [
-        {
-          "$ref": "#/$defs/ConfigureWorkloadRecoveryContext"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null
-    },
-    "kind": {
-      "const": "configure_workload",
-      "title": "Kind",
-      "type": "string"
-    },
-    "next_tool": {
-      "const": "configure_workload",
-      "title": "Next Tool",
-      "type": "string"
-    },
-    "retry_after_ms": {
-      "default": null,
-      "title": "Retry After Ms",
-      "type": "null"
-    },
-    "safe_to_repeat_same_call": {
-      "const": false,
-      "default": false,
-      "title": "Safe To Repeat Same Call",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "kind",
-    "next_tool"
-  ],
-  "title": "ConfigureWorkloadRecovery",
-  "type": "object"
-}

removedOutput schema / $defs / ConfigureWorkloadRecoveryContext

Removed value: -{
-  "additionalProperties": false,
-  "description": "Typed arguments for the safe structured configuration recovery.",
-  "properties": {
-    "config_path": {
-      "const": "flameox.toml",
-      "default": "flameox.toml",
-      "title": "Config Path",
-      "type": "string"
-    },
-    "kind": {
-      "const": "configure_workload",
-      "title": "Kind",
-      "type": "string"
-    },
-    "operation": {
-      "const": "create",
-      "default": "create",
-      "title": "Operation",
-      "type": "string"
-    }
-  },
-  "required": [
-    "kind"
-  ],
-  "title": "ConfigureWorkloadRecoveryContext",
-  "type": "object"
-}

removedOutput schema / $defs / DiscoverArtifactsRecovery

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "kind": {
-      "const": "discover_artifacts",
-      "title": "Kind",
-      "type": "string"
-    },
-    "next_tool": {
-      "const": "list_artifacts",
-      "title": "Next Tool",
-      "type": "string"
-    },
-    "retry_after_ms": {
-      "default": null,
-      "title": "Retry After Ms",
-      "type": "null"
-    },
-    "safe_to_repeat_same_call": {
-      "const": false,
-      "default": false,
-      "title": "Safe To Repeat Same Call",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "kind",
-    "next_tool"
-  ],
-  "title": "DiscoverArtifactsRecovery",
-  "type": "object"
-}

removedOutput schema / $defs / DiscoverRunsRecovery

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "kind": {
-      "const": "discover_runs",
-      "title": "Kind",
-      "type": "string"
-    },
-    "next_tool": {
-      "const": "list_runs",
-      "title": "Next Tool",
-      "type": "string"
-    },
-    "retry_after_ms": {
-      "default": null,
-      "title": "Retry After Ms",
-      "type": "null"
-    },
-    "safe_to_repeat_same_call": {
-      "const": false,
-      "default": false,
-      "title": "Safe To Repeat Same Call",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "kind",
-    "next_tool"
-  ],
-  "title": "DiscoverRunsRecovery",
-  "type": "object"
-}

removedOutput schema / $defs / DiscoverWorkflowsRecovery

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "kind": {
-      "const": "discover_workflows",
-      "title": "Kind",
-      "type": "string"
-    },
-    "next_tool": {
-      "enum": [
-        "list_declared_workflows",
-        "get_declared_workflow"
-      ],
-      "title": "Next Tool",
-      "type": "string"
-    },
-    "retry_after_ms": {
-      "default": null,
-      "title": "Retry After Ms",
-      "type": "null"
-    },
-    "safe_to_repeat_same_call": {
-      "const": false,
-      "default": false,
-      "title": "Safe To Repeat Same Call",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "kind",
-    "next_tool"
-  ],
-  "title": "DiscoverWorkflowsRecovery",
-  "type": "object"
-}

changedOutput schema / $defs / ErrorCode / enum

Previous value: -[
-  "INVALID_ARGUMENTS",
-  "WORKSPACE_NOT_FOUND",
-  "WORKSPACE_INVALID",
-  "RUN_NOT_FOUND",
-  "CAPABILITY_UNAVAILABLE",
-  "INVALID_CAPTURE_PLAN",
-  "EXECUTION_REFUSED",
-  "PROCESS_FAILED",
-  "PROCESS_TIMEOUT",
-  "PROCESS_CANCELLED",
-  "ARTIFACT_TOO_LARGE",
-  "ARTIFACT_INTEGRITY_FAILED",
-  "ARTIFACT_PARSE_FAILED",
-  "EVIDENCE_SCHEMA_MISMATCH",
-  "COMPARISON_INVALID",
-  "QUERY_BUDGET_EXCEEDED",
-  "STORAGE_QUOTA_EXCEEDED",
-  "WRITE_LOCK_TIMEOUT",
-  "SENSITIVE_ARTIFACT_REFUSED",
-  "REVISION_CONFLICT",
-  "STALE_CURSOR",
-  "INTERNAL_ERROR"
-]New value: +[
+  "INVALID_ARGUMENTS",
+  "WORKSPACE_NOT_FOUND",
+  "WORKSPACE_INVALID",
+  "RUN_NOT_FOUND",
+  "CAPABILITY_UNAVAILABLE",
+  "INVALID_CAPTURE_PLAN",
+  "PLAN_ID_MISMATCH",
+  "PLAN_TOKEN_UNKNOWN",
+  "PLAN_TOKEN_EXPIRED",
+  "PLAN_TOKEN_CONSUMED",
+  "EXECUTION_REFUSED",
+  "PROCESS_FAILED",
+  "PROCESS_TIMEOUT",
+  "PROCESS_CANCELLED",
+  "ARTIFACT_TOO_LARGE",
+  "ARTIFACT_NOT_FOUND",
+  "ARTIFACT_INTEGRITY_FAILED",
+  "ARTIFACT_PARSE_FAILED",
+  "ADAPTER_INCOMPATIBLE",
+  "EVIDENCE_SCHEMA_MISMATCH",
+  "COMPARISON_INVALID",
+  "QUERY_BUDGET_EXCEEDED",
+  "STORAGE_QUOTA_EXCEEDED",
+  "WRITE_LOCK_TIMEOUT",
+  "LOCK_ORDER_VIOLATION",
+  "SENSITIVE_ARTIFACT_REFUSED",
+  "REVISION_CONFLICT",
+  "STALE_CURSOR",
+  "INTERNAL_ERROR"
+]

removedOutput schema / $defs / ExtractPerfettoRecovery

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "context": {
-      "anyOf": [
-        {
-          "$ref": "#/$defs/ExtractPerfettoRecoveryContext"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null
-    },
-    "kind": {
-      "const": "extract_perfetto",
-      "title": "Kind",
-      "type": "string"
-    },
-    "next_tool": {
-      "const": "extract_perfetto",
-      "title": "Next Tool",
-      "type": "string"
-    },
-    "retry_after_ms": {
-      "default": null,
-      "title": "Retry After Ms",
-      "type": "null"
-    },
-    "safe_to_repeat_same_call": {
-      "const": true,
-      "default": true,
-      "title": "Safe To Repeat Same Call",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "kind",
-    "next_tool"
-  ],
-  "title": "ExtractPerfettoRecovery",
-  "type": "object"
-}

removedOutput schema / $defs / ExtractPerfettoRecoveryContext

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "kind": {
-      "const": "extract_perfetto",
-      "title": "Kind",
-      "type": "string"
-    },
-    "run_id": {
-      "minLength": 1,
-      "title": "Run Id",
-      "type": "string"
-    }
-  },
-  "required": [
-    "kind",
-    "run_id"
-  ],
-  "title": "ExtractPerfettoRecoveryContext",
-  "type": "object"
-}

removedOutput schema / $defs / FailurePayload / properties / schema_version

Removed value: -{
-  "const": 1,
-  "title": "Schema Version",
-  "type": "integer"
-}

changedOutput schema / $defs / FailurePayload / required

Previous value: -[
-  "schema_version",
-  "ok",
-  "result",
-  "error"
-]New value: +[
+  "ok",
+  "result",
+  "error"
+]

removedOutput schema / $defs / ImportArtifactRecovery

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "kind": {
-      "const": "import_artifact",
-      "title": "Kind",
-      "type": "string"
-    },
-    "next_tool": {
-      "const": "import_artifact",
-      "title": "Next Tool",
-      "type": "string"
-    },
-    "retry_after_ms": {
-      "default": null,
-      "title": "Retry After Ms",
-      "type": "null"
-    },
-    "safe_to_repeat_same_call": {
-      "const": false,
-      "default": false,
-      "title": "Safe To Repeat Same Call",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "kind",
-    "next_tool"
-  ],
-  "title": "ImportArtifactRecovery",
-  "type": "object"
-}

removedOutput schema / $defs / InitializeWorkspaceRecovery

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "kind": {
-      "const": "initialize_workspace",
-      "title": "Kind",
-      "type": "string"
-    },
-    "next_tool": {
-      "const": "initialize_workspace",
-      "title": "Next Tool",
-      "type": "string"
-    },
-    "retry_after_ms": {
-      "default": null,
-      "title": "Retry After Ms",
-      "type": "null"
-    },
-    "safe_to_repeat_same_call": {
-      "const": false,
-      "default": false,
-      "title": "Safe To Repeat Same Call",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "kind",
-    "next_tool"
-  ],
-  "title": "InitializeWorkspaceRecovery",
-  "type": "object"
-}

removedOutput schema / $defs / InspectCapabilitiesRecovery

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "kind": {
-      "const": "inspect_capabilities",
-      "title": "Kind",
-      "type": "string"
-    },
-    "next_tool": {
-      "const": "list_capabilities",
-      "title": "Next Tool",
-      "type": "string"
-    },
-    "retry_after_ms": {
-      "default": null,
-      "title": "Retry After Ms",
-      "type": "null"
-    },
-    "safe_to_repeat_same_call": {
-      "const": false,
-      "default": false,
-      "title": "Safe To Repeat Same Call",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "kind",
-    "next_tool"
-  ],
-  "title": "InspectCapabilitiesRecovery",
-  "type": "object"
-}

removedOutput schema / $defs / InspectWorkloadConfigurationRecovery

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "kind": {
-      "const": "inspect_workload_configuration",
-      "title": "Kind",
-      "type": "string"
-    },
-    "next_tool": {
-      "const": "workload_configuration_status",
-      "title": "Next Tool",
-      "type": "string"
-    },
-    "retry_after_ms": {
-      "default": null,
-      "title": "Retry After Ms",
-      "type": "null"
-    },
-    "safe_to_repeat_same_call": {
-      "const": false,
-      "default": false,
-      "title": "Safe To Repeat Same Call",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "kind",
-    "next_tool"
-  ],
-  "title": "InspectWorkloadConfigurationRecovery",
-  "type": "object"
-}

removedOutput schema / $defs / ManualConfigurationRecoveryContext

Removed value: -{
-  "additionalProperties": false,
-  "description": "Typed context for configuration that cannot be safely rewritten by MCP.",
-  "properties": {
-    "config_path": {
-      "const": "flameox.toml",
-      "default": "flameox.toml",
-      "title": "Config Path",
-      "type": "string"
-    },
-    "diagnostic": {
-      "maxLength": 500,
-      "title": "Diagnostic",
-      "type": "string"
-    },
-    "kind": {
-      "const": "manual_configuration",
-      "title": "Kind",
-      "type": "string"
-    },
-    "verification_tool": {
-      "const": "workload_configuration_status",
-      "default": "workload_configuration_status",
-      "title": "Verification Tool",
-      "type": "string"
-    }
-  },
-  "required": [
-    "kind",
-    "diagnostic"
-  ],
-  "title": "ManualConfigurationRecoveryContext",
-  "type": "object"
-}

removedOutput schema / $defs / ManualRecovery

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "context": {
-      "anyOf": [
-        {
-          "$ref": "#/$defs/ManualConfigurationRecoveryContext"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null
-    },
-    "kind": {
-      "const": "manual",
-      "title": "Kind",
-      "type": "string"
-    },
-    "next_tool": {
-      "default": null,
-      "title": "Next Tool",
-      "type": "null"
-    },
-    "retry_after_ms": {
-      "default": null,
-      "title": "Retry After Ms",
-      "type": "null"
-    },
-    "safe_to_repeat_same_call": {
-      "const": false,
-      "default": false,
-      "title": "Safe To Repeat Same Call",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "kind"
-  ],
-  "title": "ManualRecovery",
-  "type": "object"
-}

removedOutput schema / $defs / PerfettoExtractionResult

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "artifact_id": {
-      "title": "Artifact Id",
-      "type": "string"
-    },
-    "call_edge_count": {
-      "title": "Call Edge Count",
-      "type": "integer"
-    },
-    "corpus_commit_id": {
-      "title": "Corpus Commit Id",
-      "type": "string"
-    },
-    "frame_count": {
-      "title": "Frame Count",
-      "type": "integer"
-    },
-    "limitations": {
-      "items": {
-        "type": "string"
-      },
-      "title": "Limitations",
-      "type": "array"
-    },
-    "query_version": {
-      "title": "Query Version",
-      "type": "string"
-    },
-    "representative_stack_count": {
-      "title": "Representative Stack Count",
-      "type": "integer"
-    },
-    "run_id": {
-      "title": "Run Id",
-      "type": "string"
-    },
-    "schema_version": {
-      "default": 1,
-      "title": "Schema Version",
-      "type": "integer"
-    },
-    "slice_count": {
-      "title": "Slice Count",
-      "type": "integer"
-    },
-    "trace_event_count": {
-      "title": "Trace Event Count",
-      "type": "integer"
-    },
-    "trace_processor_path": {
-      "title": "Trace Processor Path",
-      "type": "string"
-    },
-    "trace_processor_sha256": {
-      "title": "Trace Processor Sha256",
-      "type": "string"
-    },
-    "truncated": {
-      "default": false,
-      "title": "Truncated",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "run_id",
-    "artifact_id",
-    "trace_processor_path",
-    "trace_processor_sha256",
-    "query_version",
-    "slice_count",
-    "frame_count",
-    "call_edge_count",
-    "representative_stack_count",
-    "trace_event_count",
-    "corpus_commit_id",
-    "limitations"
-  ],
-  "title": "PerfettoExtractionResult",
-  "type": "object"
-}

removedOutput schema / $defs / PrepareAdapterRecovery

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "kind": {
-      "const": "prepare_adapter",
-      "title": "Kind",
-      "type": "string"
-    },
-    "next_tool": {
-      "const": "prepare_adapter",
-      "title": "Next Tool",
-      "type": "string"
-    },
-    "retry_after_ms": {
-      "default": null,
-      "title": "Retry After Ms",
-      "type": "null"
-    },
-    "safe_to_repeat_same_call": {
-      "const": true,
-      "default": true,
-      "title": "Safe To Repeat Same Call",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "kind",
-    "next_tool"
-  ],
-  "title": "PrepareAdapterRecovery",
-  "type": "object"
-}

removedOutput schema / $defs / PrepareWorkloadDependenciesRecovery

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "kind": {
-      "const": "prepare_workload_dependencies",
-      "title": "Kind",
-      "type": "string"
-    },
-    "next_tool": {
-      "const": "prepare_workload_dependencies",
-      "title": "Next Tool",
-      "type": "string"
-    },
-    "retry_after_ms": {
-      "default": null,
-      "title": "Retry After Ms",
-      "type": "null"
-    },
-    "safe_to_repeat_same_call": {
-      "const": true,
-      "default": true,
-      "title": "Safe To Repeat Same Call",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "kind",
-    "next_tool"
-  ],
-  "title": "PrepareWorkloadDependenciesRecovery",
-  "type": "object"
-}

removedOutput schema / $defs / RecoveryAction / discriminator / mapping / configure_inference
```
Removed value: -"#/$defs/ConfigureInferenceRecovery"
```
removedOutput schema / $defs / RecoveryAction / discriminator / mapping / configure_workload
```
Removed value: -"#/$defs/ConfigureWorkloadRecovery"
```
removedOutput schema / $defs / RecoveryAction / discriminator / mapping / discover_artifacts
```
Removed value: -"#/$defs/DiscoverArtifactsRecovery"
```
removedOutput schema / $defs / RecoveryAction / discriminator / mapping / discover_runs
```
Removed value: -"#/$defs/DiscoverRunsRecovery"
```
removedOutput schema / $defs / RecoveryAction / discriminator / mapping / discover_workflows
```
Removed value: -"#/$defs/DiscoverWorkflowsRecovery"
```
addedOutput schema / $defs / RecoveryAction / discriminator / mapping / external
```
Added value: +"#/$defs/RecoveryExternalAction"
```
removedOutput schema / $defs / RecoveryAction / discriminator / mapping / extract_perfetto
```
Removed value: -"#/$defs/ExtractPerfettoRecovery"
```
removedOutput schema / $defs / RecoveryAction / discriminator / mapping / import_artifact
```
Removed value: -"#/$defs/ImportArtifactRecovery"
```
removedOutput schema / $defs / RecoveryAction / discriminator / mapping / initialize_workspace
```
Removed value: -"#/$defs/InitializeWorkspaceRecovery"
```
removedOutput schema / $defs / RecoveryAction / discriminator / mapping / inspect_capabilities
```
Removed value: -"#/$defs/InspectCapabilitiesRecovery"
```
removedOutput schema / $defs / RecoveryAction / discriminator / mapping / inspect_workload_configuration
```
Removed value: -"#/$defs/InspectWorkloadConfigurationRecovery"
```

changedOutput schema / $defs / RecoveryAction / discriminator / mapping / manual

Previous value: -"#/$defs/ManualRecovery"New value: +"#/$defs/RecoveryManualAction"

removedOutput schema / $defs / RecoveryAction / discriminator / mapping / prepare_adapter
```
Removed value: -"#/$defs/PrepareAdapterRecovery"
```
removedOutput schema / $defs / RecoveryAction / discriminator / mapping / prepare_workload_dependencies
```
Removed value: -"#/$defs/PrepareWorkloadDependenciesRecovery"
```
changedOutput schema / $defs / RecoveryAction / discriminator / mapping / repeat_same_call
```
Previous value: -"#/$defs/RepeatSameCallRecovery"New value: +"#/$defs/RetryRecovery"
```
removedOutput schema / $defs / RecoveryAction / discriminator / mapping / replan_capture
```
Removed value: -"#/$defs/ReplanCaptureRecovery"
```
removedOutput schema / $defs / RecoveryAction / discriminator / mapping / replan_inference
```
Removed value: -"#/$defs/ReplanInferenceRecovery"
```
removedOutput schema / $defs / RecoveryAction / discriminator / mapping / start_capability_setup
```
Removed value: -"#/$defs/StartCapabilitySetupRecovery"
```
addedOutput schema / $defs / RecoveryAction / discriminator / mapping / tool
```
Added value: +"#/$defs/RecoveryToolAction"
```
changedOutput schema / $defs / RecoveryAction / discriminator / mapping / wait_then_repeat
```
Previous value: -"#/$defs/WaitThenRepeatRecovery"New value: +"#/$defs/RetryRecovery"
```

changedOutput schema / $defs / RecoveryAction / oneOf

Previous value: -[
-  {
-    "$ref": "#/$defs/RepeatSameCallRecovery"
-  },
-  {
-    "$ref": "#/$defs/WaitThenRepeatRecovery"
-  },
-  {
-    "$ref": "#/$defs/ReplanCaptureRecovery"
-  },
-  {
-    "$ref": "#/$defs/InitializeWorkspaceRecovery"
-  },
-  {
-    "$ref": "#/$defs/ConfigureWorkloadRecovery"
-  },
-  {
-    "$ref": "#/$defs/InspectWorkloadConfigurationRecovery"
-  },
-  {
-    "$ref": "#/$defs/StartCapabilitySetupRecovery"
-  },
-  {
-    "$ref": "#/$defs/PrepareAdapterRecovery"
-  },
-  {
-    "$ref": "#/$defs/PrepareWorkloadDependenciesRecovery"
-  },
-  {
-    "$ref": "#/$defs/InspectCapabilitiesRecovery"
-  },
-  {
-    "$ref": "#/$defs/DiscoverWorkflowsRecovery"
-  },
-  {
-    "$ref": "#/$defs/DiscoverRunsRecovery"
-  },
-  {
-    "$ref": "#/$defs/DiscoverArtifactsRecovery"
-  },
-  {
-    "$ref": "#/$defs/ImportArtifactRecovery"
-  },
-  {
-    "$ref": "#/$defs/ExtractPerfettoRecovery"
-  },
-  {
-    "$ref": "#/$defs/ConfigureInferenceRecovery"
-  },
-  {
-    "$ref": "#/$defs/ReplanInferenceRecovery"
-  },
-  {
-    "$ref": "#/$defs/ManualRecovery"
-  }
-]New value: +[
+  {
+    "$ref": "#/$defs/RetryRecovery"
+  },
+  {
+    "$ref": "#/$defs/RecoveryToolAction"
+  },
+  {
+    "$ref": "#/$defs/RecoveryManualAction"
+  },
+  {
+    "$ref": "#/$defs/RecoveryExternalAction"
+  }
+]

addedOutput schema / $defs / RecoveryExternalAction

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "instruction": {
+      "maxLength": 500,
+      "minLength": 1,
+      "title": "Instruction",
+      "type": "string"
+    },
+    "kind": {
+      "const": "external",
+      "default": "external",
+      "title": "Kind",
+      "type": "string"
+    },
+    "retry_after_ms": {
+      "default": null,
+      "title": "Retry After Ms",
+      "type": "null"
+    },
+    "safe_to_repeat_same_call": {
+      "const": false,
+      "default": false,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    },
+    "system": {
+      "maxLength": 100,
+      "minLength": 1,
+      "title": "System",
+      "type": "string"
+    }
+  },
+  "required": [
+    "instruction",
+    "system"
+  ],
+  "title": "RecoveryExternalAction",
+  "type": "object"
+}

addedOutput schema / $defs / RecoveryManualAction

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "instruction": {
+      "maxLength": 500,
+      "minLength": 1,
+      "title": "Instruction",
+      "type": "string"
+    },
+    "kind": {
+      "const": "manual",
+      "default": "manual",
+      "title": "Kind",
+      "type": "string"
+    },
+    "missing_arguments": {
+      "default": [],
+      "items": {
+        "type": "string"
+      },
+      "title": "Missing Arguments",
+      "type": "array"
+    },
+    "retry_after_ms": {
+      "default": null,
+      "title": "Retry After Ms",
+      "type": "null"
+    },
+    "safe_to_repeat_same_call": {
+      "const": false,
+      "default": false,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "instruction"
+  ],
+  "title": "RecoveryManualAction",
+  "type": "object"
+}

addedOutput schema / $defs / RecoveryToolAction

Added value: +{
+  "additionalProperties": false,
+  "description": "One executable MCP recovery action with a concrete tool name.",
+  "properties": {
+    "arguments": {
+      "additionalProperties": true,
+      "title": "Arguments",
+      "type": "object"
+    },
+    "kind": {
+      "const": "tool",
+      "default": "tool",
+      "title": "Kind",
+      "type": "string"
+    },
+    "retry_after_ms": {
+      "default": null,
+      "title": "Retry After Ms",
+      "type": "null"
+    },
+    "safe_to_repeat_same_call": {
+      "const": false,
+      "default": false,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    },
+    "tool_name": {
+      "$ref": "#/$defs/ToolName"
+    }
+  },
+  "required": [
+    "tool_name"
+  ],
+  "title": "RecoveryToolAction",
+  "type": "object"
+}

removedOutput schema / $defs / RepeatSameCallRecovery

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "kind": {
-      "const": "repeat_same_call",
-      "title": "Kind",
-      "type": "string"
-    },
-    "next_tool": {
-      "default": null,
-      "title": "Next Tool",
-      "type": "null"
-    },
-    "retry_after_ms": {
-      "minimum": 0,
-      "title": "Retry After Ms",
-      "type": "integer"
-    },
-    "safe_to_repeat_same_call": {
-      "const": true,
-      "default": true,
-      "title": "Safe To Repeat Same Call",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "kind",
-    "retry_after_ms"
-  ],
-  "title": "RepeatSameCallRecovery",
-  "type": "object"
-}

removedOutput schema / $defs / ReplanCaptureRecovery

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "kind": {
-      "const": "replan_capture",
-      "title": "Kind",
-      "type": "string"
-    },
-    "next_tool": {
-      "const": "plan_capture",
-      "title": "Next Tool",
-      "type": "string"
-    },
-    "retry_after_ms": {
-      "default": null,
-      "title": "Retry After Ms",
-      "type": "null"
-    },
-    "safe_to_repeat_same_call": {
-      "const": false,
-      "default": false,
-      "title": "Safe To Repeat Same Call",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "kind",
-    "next_tool"
-  ],
-  "title": "ReplanCaptureRecovery",
-  "type": "object"
-}

removedOutput schema / $defs / ReplanInferenceRecovery

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "kind": {
-      "const": "replan_inference",
-      "title": "Kind",
-      "type": "string"
-    },
-    "next_tool": {
-      "const": "plan_inference_scenario",
-      "title": "Next Tool",
-      "type": "string"
-    },
-    "retry_after_ms": {
-      "default": null,
-      "title": "Retry After Ms",
-      "type": "null"
-    },
-    "safe_to_repeat_same_call": {
-      "const": false,
-      "default": false,
-      "title": "Safe To Repeat Same Call",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "kind",
-    "next_tool"
-  ],
-  "title": "ReplanInferenceRecovery",
-  "type": "object"
-}

addedOutput schema / $defs / RetryRecovery

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "kind": {
+      "enum": [
+        "repeat_same_call",
+        "wait_then_repeat"
+      ],
+      "title": "Kind",
+      "type": "string"
+    },
+    "retry_after_ms": {
+      "minimum": 0,
+      "title": "Retry After Ms",
+      "type": "integer"
+    },
+    "safe_to_repeat_same_call": {
+      "const": true,
+      "default": true,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "kind",
+    "retry_after_ms"
+  ],
+  "title": "RetryRecovery",
+  "type": "object"
+}

removedOutput schema / $defs / StartCapabilitySetupRecovery

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "kind": {
-      "const": "start_capability_setup",
-      "title": "Kind",
-      "type": "string"
-    },
-    "next_tool": {
-      "const": "start_capability_setup",
-      "title": "Next Tool",
-      "type": "string"
-    },
-    "retry_after_ms": {
-      "default": null,
-      "title": "Retry After Ms",
-      "type": "null"
-    },
-    "safe_to_repeat_same_call": {
-      "const": true,
-      "default": true,
-      "title": "Safe To Repeat Same Call",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "kind",
-    "next_tool"
-  ],
-  "title": "StartCapabilitySetupRecovery",
-  "type": "object"
-}

removedOutput schema / $defs / SuccessPayload_PerfettoExtractionResult_ / properties / result / $ref
```
Removed value: -"#/$defs/PerfettoExtractionResult"
```
addedOutput schema / $defs / SuccessPayload_PerfettoExtractionResult_ / properties / result / additionalProperties
```
Added value: +false
```

addedOutput schema / $defs / SuccessPayload_PerfettoExtractionResult_ / properties / result / properties

Added value: +{
+  "artifact_id": {
+    "title": "Artifact Id",
+    "type": "string"
+  },
+  "call_edge_count": {
+    "title": "Call Edge Count",
+    "type": "integer"
+  },
+  "corpus_commit_id": {
+    "title": "Corpus Commit Id",
+    "type": "string"
+  },
+  "frame_count": {
+    "title": "Frame Count",
+    "type": "integer"
+  },
+  "limitations": {
+    "items": {
+      "type": "string"
+    },
+    "title": "Limitations",
+    "type": "array"
+  },
+  "query_version": {
+    "title": "Query Version",
+    "type": "string"
+  },
+  "representative_stack_count": {
+    "title": "Representative Stack Count",
+    "type": "integer"
+  },
+  "run_id": {
+    "title": "Run Id",
+    "type": "string"
+  },
+  "slice_count": {
+    "title": "Slice Count",
+    "type": "integer"
+  },
+  "trace_event_count": {
+    "title": "Trace Event Count",
+    "type": "integer"
+  },
+  "trace_processor_path": {
+    "title": "Trace Processor Path",
+    "type": "string"
+  },
+  "trace_processor_sha256": {
+    "title": "Trace Processor Sha256",
+    "type": "string"
+  },
+  "truncated": {
+    "default": false,
+    "title": "Truncated",
+    "type": "boolean"
+  }
+}

addedOutput schema / $defs / SuccessPayload_PerfettoExtractionResult_ / properties / result / required

Added value: +[
+  "run_id",
+  "artifact_id",
+  "trace_processor_path",
+  "trace_processor_sha256",
+  "query_version",
+  "slice_count",
+  "frame_count",
+  "call_edge_count",
+  "representative_stack_count",
+  "trace_event_count",
+  "corpus_commit_id",
+  "limitations"
+]

addedOutput schema / $defs / SuccessPayload_PerfettoExtractionResult_ / properties / result / title
```
Added value: +"PerfettoExtractionResult"
```
addedOutput schema / $defs / SuccessPayload_PerfettoExtractionResult_ / properties / result / type
```
Added value: +"object"
```
removedOutput schema / $defs / SuccessPayload_PerfettoExtractionResult_ / properties / schema_version
```
Removed value: -{
-  "const": 1,
-  "title": "Schema Version",
-  "type": "integer"
-}
```

changedOutput schema / $defs / SuccessPayload_PerfettoExtractionResult_ / required

Previous value: -[
-  "schema_version",
-  "ok",
-  "result",
-  "error"
-]New value: +[
+  "ok",
+  "result",
+  "error"
+]

addedOutput schema / $defs / ToolName

Added value: +{
+  "enum": [
+    "initialize_workspace",
+    "workload_configuration_status",
+    "configure_workload",
+    "list_capabilities",
+    "start_capability_setup",
+    "get_capability_setup",
+    "prepare_adapter",
+    "prepare_workload_dependencies",
+    "list_declared_workflows",
+    "get_declared_workflow",
+    "plan_fault_experiment",
+    "plan_capture",
+    "start_detached_capture",
+    "get_detached_capture",
+    "rebuild_catalog",
+    "list_runs",
+    "list_artifacts",
+    "preview_artifact",
+    "get_native_viewer_plan",
+    "import_artifact",
+    "import_xctrace",
+    "extract_perfetto",
+    "extract_memray",
+    "get_extraction",
+    "extract_nsight_systems",
+    "extract_nsight_compute",
+    "extract_compute_sanitizer",
+    "configure_inference_server",
+    "list_inference_configurations",
+    "plan_inference_scenario",
+    "execute_reduction",
+    "get_reduction",
+    "analyze_memory",
+    "analyze_nsight_compute"
+  ],
+  "title": "ToolName",
+  "type": "string"
+}

removedOutput schema / $defs / WaitThenRepeatRecovery

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "kind": {
-      "const": "wait_then_repeat",
-      "title": "Kind",
-      "type": "string"
-    },
-    "next_tool": {
-      "default": null,
-      "title": "Next Tool",
-      "type": "null"
-    },
-    "retry_after_ms": {
-      "minimum": 0,
-      "title": "Retry After Ms",
-      "type": "integer"
-    },
-    "safe_to_repeat_same_call": {
-      "const": true,
-      "default": true,
-      "title": "Safe To Repeat Same Call",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "kind",
-    "retry_after_ms"
-  ],
-  "title": "WaitThenRepeatRecovery",
-  "type": "object"
-}

Changed41 schema fields changedv0.1.12Aug 10, 2026

removedInput schema / additionalProperties
```
Removed value: -false
```

addedOutput schema / $defs / ConfigureInferenceRecovery

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "kind": {
+      "const": "configure_inference",
+      "title": "Kind",
+      "type": "string"
+    },
+    "next_tool": {
+      "enum": [
+        "configure_inference_server",
+        "list_inference_configurations"
+      ],
+      "title": "Next Tool",
+      "type": "string"
+    },
+    "retry_after_ms": {
+      "default": null,
+      "title": "Retry After Ms",
+      "type": "null"
+    },
+    "safe_to_repeat_same_call": {
+      "const": false,
+      "default": false,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "kind",
+    "next_tool"
+  ],
+  "title": "ConfigureInferenceRecovery",
+  "type": "object"
+}

addedOutput schema / $defs / ConfigureWorkloadRecovery

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "context": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/ConfigureWorkloadRecoveryContext"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
+    "kind": {
+      "const": "configure_workload",
+      "title": "Kind",
+      "type": "string"
+    },
+    "next_tool": {
+      "const": "configure_workload",
+      "title": "Next Tool",
+      "type": "string"
+    },
+    "retry_after_ms": {
+      "default": null,
+      "title": "Retry After Ms",
+      "type": "null"
+    },
+    "safe_to_repeat_same_call": {
+      "const": false,
+      "default": false,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "kind",
+    "next_tool"
+  ],
+  "title": "ConfigureWorkloadRecovery",
+  "type": "object"
+}

addedOutput schema / $defs / DiscoverArtifactsRecovery

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "kind": {
+      "const": "discover_artifacts",
+      "title": "Kind",
+      "type": "string"
+    },
+    "next_tool": {
+      "const": "list_artifacts",
+      "title": "Next Tool",
+      "type": "string"
+    },
+    "retry_after_ms": {
+      "default": null,
+      "title": "Retry After Ms",
+      "type": "null"
+    },
+    "safe_to_repeat_same_call": {
+      "const": false,
+      "default": false,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "kind",
+    "next_tool"
+  ],
+  "title": "DiscoverArtifactsRecovery",
+  "type": "object"
+}

addedOutput schema / $defs / DiscoverRunsRecovery

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "kind": {
+      "const": "discover_runs",
+      "title": "Kind",
+      "type": "string"
+    },
+    "next_tool": {
+      "const": "list_runs",
+      "title": "Next Tool",
+      "type": "string"
+    },
+    "retry_after_ms": {
+      "default": null,
+      "title": "Retry After Ms",
+      "type": "null"
+    },
+    "safe_to_repeat_same_call": {
+      "const": false,
+      "default": false,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "kind",
+    "next_tool"
+  ],
+  "title": "DiscoverRunsRecovery",
+  "type": "object"
+}

addedOutput schema / $defs / DiscoverWorkflowsRecovery

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "kind": {
+      "const": "discover_workflows",
+      "title": "Kind",
+      "type": "string"
+    },
+    "next_tool": {
+      "enum": [
+        "list_declared_workflows",
+        "get_declared_workflow"
+      ],
+      "title": "Next Tool",
+      "type": "string"
+    },
+    "retry_after_ms": {
+      "default": null,
+      "title": "Retry After Ms",
+      "type": "null"
+    },
+    "safe_to_repeat_same_call": {
+      "const": false,
+      "default": false,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "kind",
+    "next_tool"
+  ],
+  "title": "DiscoverWorkflowsRecovery",
+  "type": "object"
+}

addedOutput schema / $defs / ErrorCode

Added value: +{
+  "enum": [
+    "INVALID_ARGUMENTS",
+    "WORKSPACE_NOT_FOUND",
+    "WORKSPACE_INVALID",
+    "RUN_NOT_FOUND",
+    "CAPABILITY_UNAVAILABLE",
+    "INVALID_CAPTURE_PLAN",
+    "EXECUTION_REFUSED",
+    "PROCESS_FAILED",
+    "PROCESS_TIMEOUT",
+    "PROCESS_CANCELLED",
+    "ARTIFACT_TOO_LARGE",
+    "ARTIFACT_INTEGRITY_FAILED",
+    "ARTIFACT_PARSE_FAILED",
+    "EVIDENCE_SCHEMA_MISMATCH",
+    "COMPARISON_INVALID",
+    "QUERY_BUDGET_EXCEEDED",
+    "STORAGE_QUOTA_EXCEEDED",
+    "WRITE_LOCK_TIMEOUT",
+    "SENSITIVE_ARTIFACT_REFUSED",
+    "REVISION_CONFLICT",
+    "STALE_CURSOR",
+    "INTERNAL_ERROR"
+  ],
+  "title": "ErrorCode",
+  "type": "string"
+}

addedOutput schema / $defs / ErrorDetail / properties / code / $ref
```
Added value: +"#/$defs/ErrorCode"
```
removedOutput schema / $defs / ErrorDetail / properties / code / title
```
Removed value: -"Code"
```
removedOutput schema / $defs / ErrorDetail / properties / code / type
```
Removed value: -"string"
```

addedOutput schema / $defs / ExtractPerfettoRecovery

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "context": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/ExtractPerfettoRecoveryContext"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
+    "kind": {
+      "const": "extract_perfetto",
+      "title": "Kind",
+      "type": "string"
+    },
+    "next_tool": {
+      "const": "extract_perfetto",
+      "title": "Next Tool",
+      "type": "string"
+    },
+    "retry_after_ms": {
+      "default": null,
+      "title": "Retry After Ms",
+      "type": "null"
+    },
+    "safe_to_repeat_same_call": {
+      "const": true,
+      "default": true,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "kind",
+    "next_tool"
+  ],
+  "title": "ExtractPerfettoRecovery",
+  "type": "object"
+}

removedOutput schema / $defs / FailurePayload / properties / ok / default
```
Removed value: -false
```
removedOutput schema / $defs / FailurePayload / properties / result / default
```
Removed value: -null
```
addedOutput schema / $defs / FailurePayload / properties / schema_version / const
```
Added value: +1
```
removedOutput schema / $defs / FailurePayload / properties / schema_version / default
```
Removed value: -1
```

changedOutput schema / $defs / FailurePayload / required

Previous value: -[
-  "error"
-]New value: +[
+  "schema_version",
+  "ok",
+  "result",
+  "error"
+]

addedOutput schema / $defs / ImportArtifactRecovery

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "kind": {
+      "const": "import_artifact",
+      "title": "Kind",
+      "type": "string"
+    },
+    "next_tool": {
+      "const": "import_artifact",
+      "title": "Next Tool",
+      "type": "string"
+    },
+    "retry_after_ms": {
+      "default": null,
+      "title": "Retry After Ms",
+      "type": "null"
+    },
+    "safe_to_repeat_same_call": {
+      "const": false,
+      "default": false,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "kind",
+    "next_tool"
+  ],
+  "title": "ImportArtifactRecovery",
+  "type": "object"
+}

addedOutput schema / $defs / InitializeWorkspaceRecovery

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "kind": {
+      "const": "initialize_workspace",
+      "title": "Kind",
+      "type": "string"
+    },
+    "next_tool": {
+      "const": "initialize_workspace",
+      "title": "Next Tool",
+      "type": "string"
+    },
+    "retry_after_ms": {
+      "default": null,
+      "title": "Retry After Ms",
+      "type": "null"
+    },
+    "safe_to_repeat_same_call": {
+      "const": false,
+      "default": false,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "kind",
+    "next_tool"
+  ],
+  "title": "InitializeWorkspaceRecovery",
+  "type": "object"
+}

addedOutput schema / $defs / InspectCapabilitiesRecovery

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "kind": {
+      "const": "inspect_capabilities",
+      "title": "Kind",
+      "type": "string"
+    },
+    "next_tool": {
+      "const": "list_capabilities",
+      "title": "Next Tool",
+      "type": "string"
+    },
+    "retry_after_ms": {
+      "default": null,
+      "title": "Retry After Ms",
+      "type": "null"
+    },
+    "safe_to_repeat_same_call": {
+      "const": false,
+      "default": false,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "kind",
+    "next_tool"
+  ],
+  "title": "InspectCapabilitiesRecovery",
+  "type": "object"
+}

addedOutput schema / $defs / InspectWorkloadConfigurationRecovery

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "kind": {
+      "const": "inspect_workload_configuration",
+      "title": "Kind",
+      "type": "string"
+    },
+    "next_tool": {
+      "const": "workload_configuration_status",
+      "title": "Next Tool",
+      "type": "string"
+    },
+    "retry_after_ms": {
+      "default": null,
+      "title": "Retry After Ms",
+      "type": "null"
+    },
+    "safe_to_repeat_same_call": {
+      "const": false,
+      "default": false,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "kind",
+    "next_tool"
+  ],
+  "title": "InspectWorkloadConfigurationRecovery",
+  "type": "object"
+}

addedOutput schema / $defs / ManualRecovery

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "context": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/ManualConfigurationRecoveryContext"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
+    "kind": {
+      "const": "manual",
+      "title": "Kind",
+      "type": "string"
+    },
+    "next_tool": {
+      "default": null,
+      "title": "Next Tool",
+      "type": "null"
+    },
+    "retry_after_ms": {
+      "default": null,
+      "title": "Retry After Ms",
+      "type": "null"
+    },
+    "safe_to_repeat_same_call": {
+      "const": false,
+      "default": false,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "kind"
+  ],
+  "title": "ManualRecovery",
+  "type": "object"
+}

addedOutput schema / $defs / PrepareAdapterRecovery

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "kind": {
+      "const": "prepare_adapter",
+      "title": "Kind",
+      "type": "string"
+    },
+    "next_tool": {
+      "const": "prepare_adapter",
+      "title": "Next Tool",
+      "type": "string"
+    },
+    "retry_after_ms": {
+      "default": null,
+      "title": "Retry After Ms",
+      "type": "null"
+    },
+    "safe_to_repeat_same_call": {
+      "const": true,
+      "default": true,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "kind",
+    "next_tool"
+  ],
+  "title": "PrepareAdapterRecovery",
+  "type": "object"
+}

addedOutput schema / $defs / PrepareWorkloadDependenciesRecovery

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "kind": {
+      "const": "prepare_workload_dependencies",
+      "title": "Kind",
+      "type": "string"
+    },
+    "next_tool": {
+      "const": "prepare_workload_dependencies",
+      "title": "Next Tool",
+      "type": "string"
+    },
+    "retry_after_ms": {
+      "default": null,
+      "title": "Retry After Ms",
+      "type": "null"
+    },
+    "safe_to_repeat_same_call": {
+      "const": true,
+      "default": true,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "kind",
+    "next_tool"
+  ],
+  "title": "PrepareWorkloadDependenciesRecovery",
+  "type": "object"
+}

removedOutput schema / $defs / RecoveryAction / additionalProperties
```
Removed value: -false
```

addedOutput schema / $defs / RecoveryAction / discriminator

Added value: +{
+  "mapping": {
+    "configure_inference": "#/$defs/ConfigureInferenceRecovery",
+    "configure_workload": "#/$defs/ConfigureWorkloadRecovery",
+    "discover_artifacts": "#/$defs/DiscoverArtifactsRecovery",
+    "discover_runs": "#/$defs/DiscoverRunsRecovery",
+    "discover_workflows": "#/$defs/DiscoverWorkflowsRecovery",
+    "extract_perfetto": "#/$defs/ExtractPerfettoRecovery",
+    "import_artifact": "#/$defs/ImportArtifactRecovery",
+    "initialize_workspace": "#/$defs/InitializeWorkspaceRecovery",
+    "inspect_capabilities": "#/$defs/InspectCapabilitiesRecovery",
+    "inspect_workload_configuration": "#/$defs/InspectWorkloadConfigurationRecovery",
+    "manual": "#/$defs/ManualRecovery",
+    "prepare_adapter": "#/$defs/PrepareAdapterRecovery",
+    "prepare_workload_dependencies": "#/$defs/PrepareWorkloadDependenciesRecovery",
+    "repeat_same_call": "#/$defs/RepeatSameCallRecovery",
+    "replan_capture": "#/$defs/ReplanCaptureRecovery",
+    "replan_inference": "#/$defs/ReplanInferenceRecovery",
+    "start_capability_setup": "#/$defs/StartCapabilitySetupRecovery",
+    "wait_then_repeat": "#/$defs/WaitThenRepeatRecovery"
+  },
+  "propertyName": "kind"
+}

addedOutput schema / $defs / RecoveryAction / oneOf

Added value: +[
+  {
+    "$ref": "#/$defs/RepeatSameCallRecovery"
+  },
+  {
+    "$ref": "#/$defs/WaitThenRepeatRecovery"
+  },
+  {
+    "$ref": "#/$defs/ReplanCaptureRecovery"
+  },
+  {
+    "$ref": "#/$defs/InitializeWorkspaceRecovery"
+  },
+  {
+    "$ref": "#/$defs/ConfigureWorkloadRecovery"
+  },
+  {
+    "$ref": "#/$defs/InspectWorkloadConfigurationRecovery"
+  },
+  {
+    "$ref": "#/$defs/StartCapabilitySetupRecovery"
+  },
+  {
+    "$ref": "#/$defs/PrepareAdapterRecovery"
+  },
+  {
+    "$ref": "#/$defs/PrepareWorkloadDependenciesRecovery"
+  },
+  {
+    "$ref": "#/$defs/InspectCapabilitiesRecovery"
+  },
+  {
+    "$ref": "#/$defs/DiscoverWorkflowsRecovery"
+  },
+  {
+    "$ref": "#/$defs/DiscoverRunsRecovery"
+  },
+  {
+    "$ref": "#/$defs/DiscoverArtifactsRecovery"
+  },
+  {
+    "$ref": "#/$defs/ImportArtifactRecovery"
+  },
+  {
+    "$ref": "#/$defs/ExtractPerfettoRecovery"
+  },
+  {
+    "$ref": "#/$defs/ConfigureInferenceRecovery"
+  },
+  {
+    "$ref": "#/$defs/ReplanInferenceRecovery"
+  },
+  {
+    "$ref": "#/$defs/ManualRecovery"
+  }
+]

removedOutput schema / $defs / RecoveryAction / properties

Removed value: -{
-  "context": {
-    "anyOf": [
-      {
-        "$ref": "#/$defs/RecoveryContext"
-      },
-      {
-        "type": "null"
-      }
-    ],
-    "default": null
-  },
-  "kind": {
-    "enum": [
-      "repeat_same_call",
-      "wait_then_repeat",
-      "replan_capture",
-      "initialize_workspace",
-      "configure_workload",
-      "inspect_workload_configuration",
-      "start_capability_setup",
-      "prepare_adapter",
-      "prepare_workload_dependencies",
-      "inspect_capabilities",
-      "discover_workflows",
-      "discover_runs",
-      "discover_artifacts",
-      "import_artifact",
-      "extract_perfetto",
-      "manual"
-    ],
-    "title": "Kind",
-    "type": "string"
-  },
-  "next_tool": {
-    "anyOf": [
-      {
-        "type": "string"
-      },
-      {
-        "type": "null"
-      }
-    ],
-    "default": null,
-    "title": "Next Tool"
-  },
-  "retry_after_ms": {
-    "anyOf": [
-      {
-        "minimum": 0,
-        "type": "integer"
-      },
-      {
-        "type": "null"
-      }
-    ],
-    "default": null,
-    "title": "Retry After Ms"
-  },
-  "safe_to_repeat_same_call": {
-    "title": "Safe To Repeat Same Call",
-    "type": "boolean"
-  }
-}

removedOutput schema / $defs / RecoveryAction / required

Removed value: -[
-  "kind",
-  "safe_to_repeat_same_call"
-]

removedOutput schema / $defs / RecoveryAction / title
```
Removed value: -"RecoveryAction"
```
removedOutput schema / $defs / RecoveryAction / type
```
Removed value: -"object"
```

removedOutput schema / $defs / RecoveryContext

Removed value: -{
-  "discriminator": {
-    "mapping": {
-      "configure_workload": "#/$defs/ConfigureWorkloadRecoveryContext",
-      "extract_perfetto": "#/$defs/ExtractPerfettoRecoveryContext",
-      "manual_configuration": "#/$defs/ManualConfigurationRecoveryContext"
-    },
-    "propertyName": "kind"
-  },
-  "oneOf": [
-    {
-      "$ref": "#/$defs/ConfigureWorkloadRecoveryContext"
-    },
-    {
-      "$ref": "#/$defs/ManualConfigurationRecoveryContext"
-    },
-    {
-      "$ref": "#/$defs/ExtractPerfettoRecoveryContext"
-    }
-  ]
-}

addedOutput schema / $defs / RepeatSameCallRecovery

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "kind": {
+      "const": "repeat_same_call",
+      "title": "Kind",
+      "type": "string"
+    },
+    "next_tool": {
+      "default": null,
+      "title": "Next Tool",
+      "type": "null"
+    },
+    "retry_after_ms": {
+      "minimum": 0,
+      "title": "Retry After Ms",
+      "type": "integer"
+    },
+    "safe_to_repeat_same_call": {
+      "const": true,
+      "default": true,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "kind",
+    "retry_after_ms"
+  ],
+  "title": "RepeatSameCallRecovery",
+  "type": "object"
+}

addedOutput schema / $defs / ReplanCaptureRecovery

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "kind": {
+      "const": "replan_capture",
+      "title": "Kind",
+      "type": "string"
+    },
+    "next_tool": {
+      "const": "plan_capture",
+      "title": "Next Tool",
+      "type": "string"
+    },
+    "retry_after_ms": {
+      "default": null,
+      "title": "Retry After Ms",
+      "type": "null"
+    },
+    "safe_to_repeat_same_call": {
+      "const": false,
+      "default": false,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "kind",
+    "next_tool"
+  ],
+  "title": "ReplanCaptureRecovery",
+  "type": "object"
+}

addedOutput schema / $defs / ReplanInferenceRecovery

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "kind": {
+      "const": "replan_inference",
+      "title": "Kind",
+      "type": "string"
+    },
+    "next_tool": {
+      "const": "plan_inference_scenario",
+      "title": "Next Tool",
+      "type": "string"
+    },
+    "retry_after_ms": {
+      "default": null,
+      "title": "Retry After Ms",
+      "type": "null"
+    },
+    "safe_to_repeat_same_call": {
+      "const": false,
+      "default": false,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "kind",
+    "next_tool"
+  ],
+  "title": "ReplanInferenceRecovery",
+  "type": "object"
+}

addedOutput schema / $defs / StartCapabilitySetupRecovery

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "kind": {
+      "const": "start_capability_setup",
+      "title": "Kind",
+      "type": "string"
+    },
+    "next_tool": {
+      "const": "start_capability_setup",
+      "title": "Next Tool",
+      "type": "string"
+    },
+    "retry_after_ms": {
+      "default": null,
+      "title": "Retry After Ms",
+      "type": "null"
+    },
+    "safe_to_repeat_same_call": {
+      "const": true,
+      "default": true,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "kind",
+    "next_tool"
+  ],
+  "title": "StartCapabilitySetupRecovery",
+  "type": "object"
+}

removedOutput schema / $defs / SuccessPayload_PerfettoExtractionResult_ / properties / error / default
```
Removed value: -null
```
removedOutput schema / $defs / SuccessPayload_PerfettoExtractionResult_ / properties / ok / default
```
Removed value: -true
```
addedOutput schema / $defs / SuccessPayload_PerfettoExtractionResult_ / properties / schema_version / const
```
Added value: +1
```
removedOutput schema / $defs / SuccessPayload_PerfettoExtractionResult_ / properties / schema_version / default
```
Removed value: -1
```

changedOutput schema / $defs / SuccessPayload_PerfettoExtractionResult_ / required

Previous value: -[
-  "result"
-]New value: +[
+  "schema_version",
+  "ok",
+  "result",
+  "error"
+]

addedOutput schema / $defs / WaitThenRepeatRecovery

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "kind": {
+      "const": "wait_then_repeat",
+      "title": "Kind",
+      "type": "string"
+    },
+    "next_tool": {
+      "default": null,
+      "title": "Next Tool",
+      "type": "null"
+    },
+    "retry_after_ms": {
+      "minimum": 0,
+      "title": "Retry After Ms",
+      "type": "integer"
+    },
+    "safe_to_repeat_same_call": {
+      "const": true,
+      "default": true,
+      "title": "Safe To Repeat Same Call",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "kind",
+    "retry_after_ms"
+  ],
+  "title": "WaitThenRepeatRecovery",
+  "type": "object"
+}

Changed1 schema field changedv0.1.11Aug 7, 2026

changedOutput schema / $defs / RecoveryAction / properties / kind / enum

Previous value: -[
-  "repeat_same_call",
-  "wait_then_repeat",
-  "replan_capture",
-  "initialize_workspace",
-  "configure_workload",
-  "inspect_workload_configuration",
-  "prepare_capabilities",
-  "prepare_adapter",
-  "prepare_workload_dependencies",
-  "inspect_capabilities",
-  "discover_workflows",
-  "discover_runs",
-  "discover_artifacts",
-  "import_artifact",
-  "extract_perfetto",
-  "manual"
-]New value: +[
+  "repeat_same_call",
+  "wait_then_repeat",
+  "replan_capture",
+  "initialize_workspace",
+  "configure_workload",
+  "inspect_workload_configuration",
+  "start_capability_setup",
+  "prepare_adapter",
+  "prepare_workload_dependencies",
+  "inspect_capabilities",
+  "discover_workflows",
+  "discover_runs",
+  "discover_artifacts",
+  "import_artifact",
+  "extract_perfetto",
+  "manual"
+]

First observedv0.1.9Aug 4, 2026

TDQS

C2.6/5.0

Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations indicate readOnlyHint=false and idempotentHint=false, yet the description does not clarify whether the tool returns results directly, creates an extraction record, or requires later retrieval via get_extraction. It adds minor context by saying queries are 'versioned' and the processor is 'local', but it omits any side effects, asynchrony, or setup implications.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence and front-loads the core action. The phrasing is economical, though terms like 'versioned curated queries' are jargon-heavy and could be simplified without losing content.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with extraction-like behavior and a sibling get_extraction, the description is too sparse to support correct invocation: it does not explain what inputs mean, whether output is synchronous, or how this relates to other extraction and retrieval tools. An output schema exists, so return structure is less of a gap, but overall usability remains weak.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description carried the full burden of explaining run_id and artifact_id. It mentions neither parameter, leaving the agent to infer meaning only from the parameter names and titles 'Run Id' and 'Artifact Id'. This is insufficient, especially for artifact_id's nullable default behavior.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: 'Run versioned curated queries through a configured local Trace Processor.' Combined with the name 'extract_perfetto', it is reasonably clear this extracts Perfetto trace data via a local processor, distinguishing it from extraction tools for other profilers. However, 'versioned curated queries' is somewhat vague about what data is produced.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is given about when to use this tool versus sibling extract_* tools or get_extraction. The mention of 'configured local Trace Processor' hints at a prerequisite but does not explicitly explain setup requirements, nor does it name alternatives or exclusion cases.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server