Method runNativeCommand

pkg/tools/builtin/shell/shell.go:278–328

(timeoutCtx, ctx context.Context, command, cwd string, timeout time.Duration)

const waitDelayAfterShellExit = 500 * time.Millisecond

func (h *shellHandler) runNativeCommand(timeoutCtx, ctx context.Context, command, cwd string, timeout time.Duration) *tools.ToolCallResult {
	// Cancellation is handled manually below (timeoutCtx + Process.Kill +
	// process group + WaitDelay), so we use exec.Command rather than
	// exec.CommandContext to keep that flow in one place.
	command, cmdEnv := h.applyAskpass(ctx, command)
	cmd := exec.Command(h.shell, append(h.shellArgsPrefix, command)...) //nolint:noctx // see comment above
	cmd.Env = cmdEnv
	cmd.Dir = cwd
	cmd.SysProcAttr = platformSpecificSysProcAttr()
	cmd.WaitDelay = waitDelayAfterShellExit

	output := newCommandOutput(ctx)
	cmd.Stdout = output
	cmd.Stderr = output

	if err := cmd.Start(); err != nil {
		return tools.ResultError(fmt.Sprintf("Error starting command: %s", err))
	}

	pg, err := createProcessGroup(cmd.Process)
	if err != nil {
		// Successfully started the child but couldn't install it in its own
		// process group: clean it up before bailing out.
		reapSpawnedChild(cmd, pg)
		return tools.ResultError(fmt.Sprintf("Error creating process group: %s", err))
	}

	done := make(chan error, 1)
	go func() {
		done <- cmd.Wait()
	}()

	var cmdErr error
	select {
	case <-timeoutCtx.Done():
		_ = kill(cmd.Process, pg)
		// Wait for cmd.Wait() to complete so that the internal pipe-copy
		// goroutines finish writing to output before we read it.
		// Use a grace period: if SIGTERM is ignored, escalate to SIGKILL.
		select {
		case <-done:
		case <-time.After(3 * time.Second):
			_ = cmd.Process.Kill()
			<-done
		}
	case cmdErr = <-done:
	}

	formattedOutput := formatCommandOutput(timeoutCtx, ctx, cmdErr, output.String(), timeout)
	return tools.ResultSuccess(formattedOutput)
}

func (h *shellHandler) RunShellBackground(ctx context.Context, params RunShellBackgroundArgs) (*tools.ToolCallResult, error) {
	if strings.TrimSpace(params.Cmd) == "" {