Method StartTaskSession

internal/daemon/task_runtime.go:125–185

(
	ctx context.Context,
	spec *taskpkg.StartTaskSession,
)

}

func (b *taskSessionBridge) StartTaskSession(
	ctx context.Context,
	spec *taskpkg.StartTaskSession,
) (*taskpkg.SessionRef, error) {
	if ctx == nil {
		return nil, errors.New("daemon: start task session context is required")
	}
	if spec == nil {
		return nil, errors.New("daemon: start task session spec is required")
	}

	opts := session.CreateOpts{
		AgentName: taskSessionAgentName(spec.Task),
		Provider:  "",
		Name:      taskSessionName(spec),
		Channel:   taskRunSessionChannel(spec.Run),
		Type:      session.SessionTypeSystem,
	}
	applyTaskSessionWorkerProfile(&opts, spec.ExecutionProfile)
	applyTaskSessionSandboxProfile(&opts, spec.ExecutionProfile)
	applyTaskSessionRuntimeProfile(&opts, spec.ExecutionProfile)
	switch spec.Task.Scope.Normalize() {
	case taskpkg.ScopeWorkspace:
		opts.Workspace = strings.TrimSpace(spec.Task.WorkspaceID)
	case taskpkg.ScopeGlobal:
		if b.globalWorkspacePath == "" {
			return nil, errors.New("daemon: task session bridge global workspace path is required")
		}
		opts.WorkspacePath = b.globalWorkspacePath
	default:
		return nil, fmt.Errorf(
			"%w: unsupported task scope %q for task session start",
			taskpkg.ErrValidation,
			spec.Task.Scope,
		)
	}
	if b.contextOverlay != nil {
		overlay, err := b.contextOverlay.TaskRunPromptOverlay(ctx, spec.Task, spec.Run, spec.ExecutionProfile)
		if err != nil {
			return nil, fmt.Errorf("daemon: render task session context overlay: %w", err)
		}
		opts.PromptOverlay = joinPromptOverlays(opts.PromptOverlay, overlay)
	}

	created, err := b.sessions.Create(ctx, opts)
	if err != nil {
		return nil, err
	}
	if created == nil {
		return nil, fmt.Errorf("%w: task session bridge create returned nil session", taskpkg.ErrValidation)
	}
	info := created.Info()
	if info == nil {
		return nil, fmt.Errorf("%w: task session bridge create returned nil session info", taskpkg.ErrValidation)
	}
	return &taskpkg.SessionRef{
		SessionID:   strings.TrimSpace(info.ID),
		WorkspaceID: strings.TrimSpace(info.WorkspaceID),