From ddf765c4756784274c7ec66e25f147afc0d120f6 Mon Sep 17 00:00:00 2001 From: Scott Wilson Date: Fri, 13 Nov 2026 22:26:19 -0800 Subject: [PATCH] docs(agent-vault): say a session's skills come from more than its access bundle A session can now name project skills and carry skills sent with it, beside its access bundle's (the Infisical PR for AGE2-373). The skills fetch already installs whatever Infisical returns, so only the text changes: - `agent-vault run --help` described the skills as the ones in the session's access bundle - the comments on the 64 MB read limits for the skills response now give the bounds Infisical enforces: 25 skills through the access bundle, 20 named, and the inline skills in one 2 MB request Co-Authored-By: Claude Opus 5.5 --- packages/agentvault/session_endpoints.go | 3 ++- packages/api/agent_vault.go | 3 ++- packages/cmd/agent_vault_run.go | 4 ++-- 3 files changed, 6 insertions(+), 4 deletions(-) diff --git a/packages/agentvault/session_endpoints.go b/packages/agentvault/session_endpoints.go index c2352738..d6a75ab8 100644 --- a/packages/agentvault/session_endpoints.go +++ b/packages/agentvault/session_endpoints.go @@ -22,7 +22,8 @@ var ( // Under the 30 seconds agent-vault run waits for skills, so its own message about the wait wins. The wait for a // free slot, and passing the answer on, count against it too. sessionForwardTimeout = 25 * time.Second - // Infisical caps one skill at 1 MB, and a bundle holds at most 25. + // Infisical caps one skill at 1 MB, and a session gets at most 25 through its access bundle and 20 it names, while + // the skills sent with it share one 2 MB request. sessionForwardMaxBytes int64 = 64 << 20 ) diff --git a/packages/api/agent_vault.go b/packages/api/agent_vault.go index 59ce65eb..df70c9ac 100644 --- a/packages/api/agent_vault.go +++ b/packages/api/agent_vault.go @@ -408,7 +408,8 @@ type ListAgentVaultSessionSkillsResponse struct { Skills []AgentVaultSessionSkill `json:"skills"` } -// Infisical caps one skill at 1 MB, but not how many a session can reach. +// Infisical caps one skill at 1 MB, and a session at 25 skills through its access bundle and 20 it names, while the +// skills sent with it share one 2 MB request. const agentVaultSessionSkillsResponseLimit = 64 << 20 // CallListAgentVaultSessionSkills asks Infisical for the session's skills. includeBuiltin=false leaves out the built-in diff --git a/packages/cmd/agent_vault_run.go b/packages/cmd/agent_vault_run.go index 3610e745..8dcf93ed 100644 --- a/packages/cmd/agent_vault_run.go +++ b/packages/cmd/agent_vault_run.go @@ -130,8 +130,8 @@ The proxy says which Infisical it works with, and the agent gets that Infisical' Through the proxy, the agent lists the services its session reaches at $INFISICAL_AGENT_VAULT_URL/api/v1/agent-vault/session/services, with no credential of its own. -The skills in the session's access bundle, plus infisical-agent-vault, which tells the agent how to work behind -the proxy, are fetched through the proxy and installed when the agent starts, into +The session's skills (its access bundle's, the ones it names and the ones sent with it), plus infisical-agent-vault, +which tells the agent how to work behind the proxy, are fetched through the proxy and installed when the agent starts, into ~/.agents/skills, where Codex, OpenCode and OpenClaw find them. A proxy too old to pass skills on is skipped and Infisical asked directly. Pass --no-agent-vault-skill to leave out infisical-agent-vault. If ~/.claude (or $CLAUDE_CONFIG_DIR) or ~/.hermes (or $HERMES_HOME) exists, each skill is also linked into its skills folder for Claude Code or