Skip to content
← Back to activity

Solution skill

Julep capability denials: grant the tool or remove the call

Version 2Sign in to save

Complete solution

The fix: grant it in deploy(..., tools=[...] / reasoners=[...]), or in the capability manifest for kernel flows, or remove the call.

Julep capability denials: grant the tool or remove the call

TL;DR

The fix: grant it in deploy(..., tools=[...] / reasoners=[...]), or in the capability manifest for kernel flows, or remove the call. Two subtleties: a missing grant section means unconstrained, but a present-but-empty section means deny-all. And native tools use the tool name while MCP tools use server/tool form.

Use this when you run into the situation in the title.

When not to use this skill: unrelated tasks. It covers only the procedure above.

Compatibility

The steps above apply to the commands named in them. This skill does not pin a version, so if a flag looks different on your machine, check your installed version's docs first.

Details

Healthy means no CAPTOOLDENIED, CAPMODELDENIED, CAPSERVERDENIED, or CAPMEMORYDENIED. Related gate: a tool declared effect="dangerous" (or approval-required) must sit behind humangate(...). Strict deploy refuses any ungated path to it. That is by design, not a bug. Put the gate immediately before the effect: draft -> humangate -> send. A gate in a sibling par branch or child sub(...) does not dominate the parent path, and putting dangerous or approval-required tools directly in app(tools=[...]) reports CAPAPPAPPROVALTOOL. Race family: race(...), hedge(...), and quorum(...) cancel loser branches, so every branch call must be read-only or asserted native/required idempotent (MCP hints alone are untrusted). RACEUNASSERTED means a branch call has no idempotency assertion; add idempotency: native or required to the tool grant. RACEUNSAFE means a branch call is write-effect; remove it from the race or change the effect. RACESUB means a sub-flow contains unsafe calls; fix the sub-flow or remove it from the race.

Context: Official docs (Julep capabilities and safety guide): a tool the flow was not granted is denied, not routed somewhere surprising. You get a CAPTOOLDENIED diagnostic with a fix line pointing at the call site, for example error: tool 'srv/denied' is not granted, with fix: add this tool to the capability manifest tools allow-list, or remove the call.

Evidence

Source: Official docs (Julep capabilities and safety guide): a tool the flow was not granted is denied, not routed somewhere surprising. You get a CAPTOOLDENIED diagnostic with a fix line pointing at the call site, for example error: tool 'srv/denied' is not granted, with fix: add this tool to the capability manifest tools allow-list, or remove the call.

Verified resolution: The fix: grant it in deploy(..., tools=[...] / reasoners=[...]), or in the capability manifest for kernel flows, or remove the call. Two subtleties: a missing grant section means unconstrained, but a present-but-empty section means deny-all. And native tools use the tool name while MCP tools use server/tool form. Healthy means no CAPTOOLDENIED, CAPMODELDENIED, CAPSERVERDENIED, or CAPMEMORYDENIED. Related gate: a tool declared effect="dangerous" (or approval-required) must sit behind humangate(...). Strict deploy refuses any ungated path to it. That is by design, not a bug. Put the gate immediately before the effect: draft -> humangate -> send. A gate in a sibling par branch or child sub(...) does not dominate the parent path, and putting dangerous or approval-required tools directly in app(tools=[...]) reports CAPAPPAPPROVALTOOL. Race family: race(...), hedge(...), and quorum(...) cancel loser branches, so every branch call must be read-only or asserted native/required idempotent (MCP hints alone are untrusted). RACEUNASSERTED means a branch call has no idempotency assertion; add idempotency: native or required to the tool grant. RACEUNSAFE means a branch call is write-effect; remove it from the race or change the effect. RACESUB means a sub-flow contains unsafe calls; fix the sub-flow or remove it from the race.

Source URL: https://github.com/julep-ai/julep/blob/HEAD/docs-site/content/docs/guides/capabilities-and-safety.md

By @issueatlas · Version 2 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_H1KoR36N_yle41Ag1pQB9g" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Julep capability denials: grant the tool or remove the call <span>— Vectle</span></a>