Skip to content

feat(tools): binding.invoke tracing for tool-call visibility#121

Open
NathanFlurry wants to merge 1 commit into
mainfrom
nathan/binding-invoke-tracing
Open

feat(tools): binding.invoke tracing for tool-call visibility#121
NathanFlurry wants to merge 1 commit into
mainfrom
nathan/binding-invoke-tracing

Conversation

@NathanFlurry

@NathanFlurry NathanFlurry commented Jun 24, 2026

Copy link
Copy Markdown
Member

What

Add tracing to resolve_toolkit_command in crates/sidecar/src/tools.rs — the binding.invoke resolution + policy gate that runs when a guest invokes a registered host tool. Today this path is completely silent, so a host-tool call can't be observed.

New events (target secure_exec_sidecar::tools):

  • debug! — resolving tool callback (callback_key)
  • warn! — unknown tool callback
  • warn! — blocked by binding.invoke policy
  • info! — resolved tool callback (callback_key, timeout_ms)

Why

Debugging a tool-call hang in a consumer (timed out waiting for sidecar protocol frame for ext, "hangs before the tool fires"), the sidecar emitted nothing on the tool path. These four events make the hop visible: was the tool resolved, was it unknown, or was it blocked by policy — which splits "stuck in resolution/policy" from "stuck in the host round-trip."

Notes

  • Purely additive (tracing only); no control-flow change.
  • Surfaces only when the consuming sidecar enables RUST_LOG/EnvFilter — pairs with the agent-os PR that makes agentos-sidecar logging configurable (rivet/agentos#1517).
  • cargo check passes.

Add debug/warn/info tracing to resolve_toolkit_command (the binding.invoke
resolution + policy gate) so a host-tool call is observable end-to-end:
resolving, unknown-callback, blocked-by-policy, and resolved (with timeout_ms).
Emitted on the secure_exec_sidecar::tools target; surfaces once the consuming
sidecar enables RUST_LOG/EnvFilter (see the agent-os configurable-logging PR).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@railway-app

railway-app Bot commented Jun 24, 2026

Copy link
Copy Markdown

🚅 Deployed to the secure-exec-pr-121 environment in rivet-frontend

Service Status Web Updated (UTC)
secure-exec 😴 Sleeping (View Logs) Jun 24, 2026 at 4:06 am

🚅 Deployed to the secure-exec-pr-121 environment in secure-exec

Service Status Web Updated (UTC)
secure-exec 😴 Sleeping (View Logs) Web Jun 27, 2026 at 10:18 am

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant