Skip to content

docs(agent-vault): say a session's skills come from more than its access bundle - #505

Open
scott-ray-wilson wants to merge 1 commit into
AGE2-372from
AGE2-373
Open

scott-ray-wilson wants to merge 1 commit into
AGE2-372from
AGE2-373

Conversation

@scott-ray-wilson

@scott-ray-wilson scott-ray-wilson commented Nov 14, 2026 •

Copy link
Copy Markdown
Contributor

Description 📣

Pairs with Infisical/infisical#9486 (AGE2-373), which stacks on Infisical/infisical#9483. That PR lets session creation name project skills one by one and send skills that last only as long as the session, beside the access bundle's skills.

GET /api/v1/agent-vault/session/skills already returns every skill a session gets, and the CLI installs whatever it returns: the response shape is unchanged, each skill still has an id, version and sha256, and the CLI checks the hash and keys its folders by name. So nothing the CLI does changes. Two places still described skills as coming from the access bundle:

  • infisical agent-vault run --help said the skills installed are "the skills in the session's access bundle". It now says the session's skills: its access bundle's, the ones it names and the ones sent with it
  • The comments on the 64 MB read limits for the skills response (sessionForwardMaxBytes on the proxy, agentVaultSessionSkillsResponseLimit in the API client) said a bundle holds at most 25 skills, or that nothing bounds a session's skills. They now give the bounds Infisical enforces, which keep the worst case under 64 MB: 25 skills through the access bundle, 20 named, and the inline skills in one 2 MB request

Stacked on #504 (AGE2-372).

Type ✨

  • Bug fix
  • New feature
  • Improvement
  • Breaking change
  • Documentation

Tests 🛠️

go build -o /tmp/infisical .
go vet ./packages/cmd/... ./packages/agentvault/... ./packages/api/...   # clean (the whole tree has one older finding in packages/pam)
go test ./packages/cmd/... ./packages/agentvault/... ./packages/api/...  # ok

With this build as both the proxy and agent-vault run, against an Infisical API running the AGE2-373 backend:

  • A member's session naming a project skill and sending one inline installed both, plus infisical-agent-vault
  • An admin's session with an access bundle and an inline skill of the same name as one of the bundle's installed the inline one in its place
  • After the member lost the access bundle, the next run installed only the inline skill
  • After the session was revoked, the run started without skills and said the session was revoked

  • New or changed commands follow CLI.md, and new commands and flags are recorded in packages/cmd/testdata/command_surface.json
  • Updated AGENTS.md files (if needed)
  • I have read the contributing guide, agreed and acknowledged the code of conduct. 📝

🤖 Generated with Claude Code

…ess 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 <noreply@anthropic.com>
@infisical-review-police

Copy link
Copy Markdown

💬 Discussion in Slack: #pr-review-cli-505-docs-agent-vault-say-a-session-s-skills-come-from-more-than-it

Posted by Review Police — reviews, comments, new commits, and CI failures will stream into this channel.

@linear

linear Bot commented Nov 14, 2026 •

Copy link
Copy Markdown

AGE2-373

AGE2-376

@veria-ai

veria-ai Bot commented Nov 14, 2026 •

Copy link
Copy Markdown
Contributor

PR overview

No security issues were found in this pull request.

Reviews

@greptile-apps

greptile-apps Bot commented Nov 14, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerView in GreptileConfidence Score: 5/5 Tier: plus

[Low impact] This text-only PR appears safe to merge.

Summary

Updates Agent Vault help to describe skills from access bundles, named project skills, and skills sent with a session.

  • The run help names every source of a session’s skills.
  • The response-limit comments explain all session skill bounds.

Reviews (2) · Last reviewed commit: "docs(agent-vault): say a session's skill..." · Reviewed by Greptile

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