mirror of
https://github.com/harivansh-afk/sandbox-agent.git
synced 2026-04-16 21:03:46 +00:00
eacbc602e7
Refactors Foundry around organization/repository ownership and adds an organization-scoped GitHub state actor plus a user-scoped GitHub auth actor, removing the old project PR/branch sync actors and repo PR cache. Updates sandbox provisioning to rely on sandbox-agent for in-sandbox work, hardens Daytona startup and image-build behavior, and surfaces runtime and task-startup errors more clearly in the UI. Extends workbench and GitHub state handling to track merged PR state, adds runtime-issue tracking, refreshes client/test/config wiring, and documents the main live Foundry test flow plus actor coordination rules. Also updates the remaining Sandbox Agent install-version references in docs/examples to the current pinned minor channel. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| 00-end-to-end-async-realtime-plan.md | ||
| 01-task-creation-bootstrap-only.md | ||
| 02-repo-overview-from-cached-projection.md | ||
| 03-repo-actions-via-background-workflow.md | ||
| 04-workbench-session-creation-without-inline-provisioning.md | ||
| 05-workbench-snapshot-from-derived-state.md | ||
| 06-daytona-provisioning-staged-background-flow.md | ||
| 07-auth-identity-simplification.md | ||
| README.md | ||
Async Action Fixes Handoff
Purpose
This folder contains implementation briefs for removing long-running synchronous waits from Foundry request and action paths.
Start with 00-end-to-end-async-realtime-plan.md. It is the umbrella plan for the broader migration away from monolithic snapshots and polling, and it adds the missing runtime hardening and subscription-lifecycle work that the numbered implementation briefs did not previously cover.
The governing policy now lives in foundry/CLAUDE.md:
- always await
send(...) - default to
wait: false - only use
wait: truefor short, bounded mutations - do not force repo/provider sync in read paths
- only block until the minimum client-needed resource exists
Shared Context
- Backend actor entry points live under
foundry/packages/backend/src/actors. - Provider-backed long-running work lives under
foundry/packages/backend/src/providers. - The main UI consumers are:
foundry/packages/frontend/src/components/workspace-dashboard.tsxfoundry/packages/frontend/src/components/mock-layout.tsxfoundry/packages/client/src/remote/workbench-client.ts
- Existing non-blocking examples already exist in app-shell GitHub auth/import flows. Use those as the reference pattern for request returns plus background completion.
Suggested Implementation Order
00-end-to-end-async-realtime-plan.md01-task-creation-bootstrap-only.md03-repo-actions-via-background-workflow.md06-daytona-provisioning-staged-background-flow.md- App shell realtime subscription work from
00-end-to-end-async-realtime-plan.md 02-repo-overview-from-cached-projection.md- Workspace summary projection work from
00-end-to-end-async-realtime-plan.md 04-workbench-session-creation-without-inline-provisioning.md05-workbench-snapshot-from-derived-state.md- Task-detail direct subscription work from
00-end-to-end-async-realtime-plan.md 07-auth-identity-simplification.md
Why This Order
- Runtime hardening and the first async workflow items remove the highest-risk correctness and timeout issues first.
- App shell realtime is a smaller migration than the workbench and removes the current polling loop early.
- Workspace summary and task-detail subscription work are easier once long-running mutations already report durable background state.
- Auth simplification is important, but it should not block the snapshot/polling/runtime fixes.
Fresh Agent Checklist
Before implementing any item:
- Read
foundry/CLAUDE.mdruntime and actor rules. - Read the specific item doc in this folder.
- Confirm the current code paths named in that doc still match the repo.
- Preserve actor single-writer ownership.
- Prefer workflow status and push updates over synchronous completion.