Add star repo onboarding flow (#232)

factory/packages/backend/src/actors/workspace/actions.ts

@@ -25,6 +25,8 @@ import type {
   RepoStackActionInput,
   RepoStackActionResult,
   RepoRecord,
+  StarSandboxAgentRepoInput,
+  StarSandboxAgentRepoResult,
   SwitchResult,
   WorkspaceUseInput,
 } from "@openhandoff/shared";
@@ -59,6 +61,7 @@ interface RepoOverviewInput {
 }
 
 const WORKSPACE_QUEUE_NAMES = ["workspace.command.addRepo", "workspace.command.createHandoff", "workspace.command.refreshProviderProfiles"] as const;
+const SANDBOX_AGENT_REPO = "rivet-dev/sandbox-agent";
 
 type WorkspaceQueueName = (typeof WORKSPACE_QUEUE_NAMES)[number];
 
@@ -415,6 +418,16 @@ export const workspaceActions = {
     );
   },
 
+  async starSandboxAgentRepo(c: any, input: StarSandboxAgentRepoInput): Promise<StarSandboxAgentRepoResult> {
+    assertWorkspace(c, input.workspaceId);
+    const { driver } = getActorRuntimeContext();
+    await driver.github.starRepository(SANDBOX_AGENT_REPO);
+    return {
+      repo: SANDBOX_AGENT_REPO,
+      starredAt: Date.now(),
+    };
+  },
+
   async getWorkbench(c: any, input: WorkspaceUseInput): Promise<HandoffWorkbenchSnapshot> {
     assertWorkspace(c, input.workspaceId);
     return await buildWorkbenchSnapshot(c);

factory/packages/backend/src/driver.ts

@@ -24,7 +24,7 @@ import {
   gitSpiceSyncRepo,
   gitSpiceTrackBranch,
 } from "./integrations/git-spice/index.js";
-import { listPullRequests, createPr } from "./integrations/github/index.js";
+import { listPullRequests, createPr, starRepository } from "./integrations/github/index.js";
 import { SandboxAgentClient } from "./integrations/sandbox-agent/client.js";
 import { DaytonaClient } from "./integrations/daytona/client.js";
 
@@ -59,6 +59,7 @@ export interface StackDriver {
 export interface GithubDriver {
   listPullRequests(repoPath: string): Promise<PullRequestSnapshot[]>;
   createPr(repoPath: string, headBranch: string, title: string, body?: string): Promise<{ number: number; url: string }>;
+  starRepository(repoFullName: string): Promise<void>;
 }
 
 export interface SandboxAgentClientLike {
@@ -131,6 +132,7 @@ export function createDefaultDriver(): BackendDriver {
     github: {
       listPullRequests,
       createPr,
+      starRepository,
     },
     sandboxAgent: {
       createClient: (opts) => {

factory/packages/backend/src/integrations/github/index.ts

@@ -167,6 +167,18 @@ export async function createPr(repoPath: string, headBranch: string, title: stri
   return { number, url };
 }
 
+export async function starRepository(repoFullName: string): Promise<void> {
+  try {
+    await execFileAsync("gh", ["api", "--method", "PUT", `user/starred/${repoFullName}`], {
+      maxBuffer: 1024 * 1024,
+    });
+  } catch (error) {
+    const message =
+      error instanceof Error ? error.message : `Failed to star GitHub repository ${repoFullName}. Ensure GitHub auth is configured for the backend.`;
+    throw new Error(message);
+  }
+}
+
 export async function getAllowedMergeMethod(repoPath: string): Promise<"squash" | "rebase" | "merge"> {
   try {
     // Get the repo owner/name from gh