docs(design): agent mounts, one derived durable folder per agent#5215
Draft
mmabrouk wants to merge 1 commit into
Draft
docs(design): agent mounts, one derived durable folder per agent#5215mmabrouk wants to merge 1 commit into
mmabrouk wants to merge 1 commit into
Conversation
Design workspace for agent-scoped mounts: identity minted into the reserved mount slug from the workflow artifact id (JP's mechanism), no schema change, no wire change, no configuration. Context, research with code pointers, decisions D1-D4, four slices, six open questions for review. Claude-Session: https://claude.ai/code/session_01QHXdTFZjipBCPX3PkeWbh6
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
Important Review skippedDraft detected. Please check the settings in the CodeRabbit UI or the ⚙️ Run configurationConfiguration used: Organization UI Review profile: CHILL Plan: Pro Plus Run ID: You can disable this status message by setting the Use the checkbox below for a quick retry:
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Today an agent has no storage of its own: every run's files live in the session's mount (or an ephemeral temp dir for sessionless runs) and are invisible to the agent's other conversations. After this project, every agent has one durable folder, mounted into all of its runs next to the session cwd, browsable from the frontend.
This PR is the design workspace, no code. It captures the mechanism JP settled in his voice note (2026-07-11) plus the review that sharpened it:
__ag__agent__<artifact_id>__default), upserted on the existingunique(project_id, slug)constraint,session_idstays NULL. No migration, no new column, no uniqueness machinery.runContext.workflow.artifact.id; it signs the agent mount best-effort and mounts it at<cwd>-agent, local and Daytona, exposing the path via one env var.POST /mounts/agents/sign(runner) andPOST /mounts/agents/query(frontend lookup; read never creates). The frontend reuses the existing mount file browser.How to review:
plan.mdis the document to comment on; it ends with six open questions (slug shape, endpoint placement, mount point constant, query semantics, frontend slice ownership, run-type coverage).context.mdholds the why and the rejected alternatives;research.mdthe code facts with file:line pointers.Depends on nothing; builds on the transcript-mounts pattern from #5197 (applied to the tree, unmerged), so the runner slice tracks that PR's final shape.
https://claude.ai/code/session_01QHXdTFZjipBCPX3PkeWbh6