Method buildCoreWorkspace

engine/server/session_workspaces.go:578–611

buildCoreWorkspace converts the internal workspace detection result into the public core.Workspace. For local workspaces, it stores the host path (directories are resolved lazily). For remote, it stores the prebuiltRootfs.

(
	ctx context.Context,
	_ *daggerClient,
	detected *workspace.Workspace,
	isLocal bool,
	prebuiltRootfs dagql.ObjectResult[*core.Directory],
	address string,
)

// the public core.Workspace. For local workspaces, it stores the host path
// (directories are resolved lazily). For remote, it stores the prebuiltRootfs.
func (srv *Server) buildCoreWorkspace(
	ctx context.Context,
	_ *daggerClient,
	detected *workspace.Workspace,
	isLocal bool,
	prebuiltRootfs dagql.ObjectResult[*core.Directory],
	address string,
) (*core.Workspace, error) {
	// Capture the current client ID for routing host filesystem operations.
	clientMetadata, err := engine.ClientMetadataFromContext(ctx)
	if err != nil {
		return nil, fmt.Errorf("client metadata: %w", err)
	}

	coreWS := &core.Workspace{
		Address:  address,
		Path:     detected.Path,
		ClientID: clientMetadata.ClientID,
	}
	if coreWS.Address == "" {
		coreWS.Address = localWorkspaceAddress(detected.Root, detected.Path)
	}

	if isLocal {
		// Local: store host path only. Directories are resolved lazily
		// via per-call host.directory() in resolveRootfs.
		coreWS.SetHostPath(detected.Root)
	} else {
		// Remote: store the cloned git tree.
		coreWS.SetRootfs(prebuiltRootfs)
	}

	return coreWS, nil
}

func localWorkspaceAddress(root, workspacePath string) string {
	workspaceDir := filepath.Join(root, workspacePath)