sandbox-agent/factory/packages/client/src/keys.ts

export type ActorKey = string[];

export function workspaceKey(workspaceId: string): ActorKey {
  return ["ws", workspaceId];
}

export function projectKey(workspaceId: string, repoId: string): ActorKey {
  return ["ws", workspaceId, "project", repoId];
}

export function handoffKey(workspaceId: string, repoId: string, handoffId: string): ActorKey {
  return ["ws", workspaceId, "project", repoId, "handoff", handoffId];
}

export function sandboxInstanceKey(
  workspaceId: string,
  providerId: string,
  sandboxId: string
): ActorKey {
  return ["ws", workspaceId, "provider", providerId, "sandbox", sandboxId];
}

export function historyKey(workspaceId: string, repoId: string): ActorKey {
  return ["ws", workspaceId, "project", repoId, "history"];
}

export function projectPrSyncKey(workspaceId: string, repoId: string): ActorKey {
  return ["ws", workspaceId, "project", repoId, "pr-sync"];
}

export function projectBranchSyncKey(workspaceId: string, repoId: string): ActorKey {
  return ["ws", workspaceId, "project", repoId, "branch-sync"];
}

export function handoffStatusSyncKey(
  workspaceId: string,
  repoId: string,
  handoffId: string,
  sandboxId: string,
  sessionId: string
): ActorKey {
  // Include sandbox + session so multiple sandboxes/sessions can be tracked per handoff.
  return ["ws", workspaceId, "project", repoId, "handoff", handoffId, "status-sync", sandboxId, sessionId];
}