Resolve before acting#
The generic targets.resolve tool uses connected provider target discovery to return resolved, ambiguous or not-found outcomes. It does not invent endpoint IDs or create missing provider capabilities.
Permissions#
The generic permission is targets.resolve. Runtime resolver/provider read permissions can also be required for the selected provider/kind. Use an exact already-established candidate or clarify ambiguity before constructing a consequential execution.
Exact registered tools#
targets.resolvetargets.resolve
Resolve one or many logical target references in one call using the registered provider plugins. Reuse only confirmed top-level targets as exact IDs in operational tools. For a named container and its members, create one container selector and set desired_kind to the member kind instead of repeating the container name in a second selector.
Registration: RiskLevel.READ / ApprovalMode.NEVER · enabled
resolved target payload with confirmation/ambiguity information Runtime RBAC can raise deny or force approval even where metadata says NEVER/POLICY; static metadata is not final policy.
Exact input schema
{
"type": "object",
"required": [
"selectors"
],
"additionalProperties": false,
"properties": {
"selectors": {
"type": "array",
"minItems": 1,
"maxItems": 500,
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"minLength": 1,
"description": "Semantic source kind selected from the currently available target providers. Do not invent unsupported kinds."
},
"query": {
"type": "string",
"minLength": 1,
"description": "Primary target identity or search phrase. Keep it focused on the entity being resolved. For several independent targets create separate selector objects. A container and its members are not independent targets: use one container selector with desired_kind set to the member kind."
},
"scope": {
"type": "string",
"enum": [
"one",
"many",
"all"
],
"description": "Expected result cardinality. 'many' is also appropriate when one resolved container expands to multiple member targets."
},
"provider": {
"type": "string",
"minLength": 1,
"description": "Optional explicit provider name. Use only a provider available in the current runtime."
},
"attributes": {
"type": "object",
"description": "Optional structured target attributes supported by the selected provider. Do not invent provider-specific fields.",
"additionalProperties": true
}
},
"required": [
"kind"
],
"additionalProperties": false
}
},
"desired_kind": {
"type": "string",
"minLength": 1
},
"context": {
"type": "object",
"description": "Optional provider context such as tenant, organization, database or site identifiers. Keys are provider-defined.",
"additionalProperties": true
}
}
}