Function newTaskHeartbeatCommand

internal/cli/task.go:1639–1685

(deps commandDeps)

}

func newTaskHeartbeatCommand(deps commandDeps) *cobra.Command {
	var leaseSeconds int64

	cmd := &cobra.Command{
		Use:   "heartbeat <run-id>",
		Short: "Extend a claimed task run lease for the current agent session",
		Args:  cobra.ExactArgs(1),
		Example: `  # Extend the active session-bound lease
  agh task heartbeat run-123

	  # Request a specific lease duration
  agh task heartbeat run-123 --lease-seconds 300`,
		RunE: func(cmd *cobra.Command, args []string) error {
			runID, err := requiredAgentTaskRunID(args[0])
			if err != nil {
				return err
			}
			if err := validateAgentTaskLeaseSeconds(leaseSeconds); err != nil {
				return err
			}
			request := AgentTaskHeartbeatRequest{
				LeaseSeconds: leaseSeconds,
			}

			client, err := clientFromDeps(deps)
			if err != nil {
				return err
			}
			credentials, err := requireAgentCommandIdentity(
				cmd.Context(),
				deps,
				client,
				agentActionCLI("task.heartbeat"),
			)
			if err != nil {
				return err
			}
			record, err := client.AgentTaskHeartbeat(cmd.Context(), runID, request, credentials)
			if err != nil {
				return err
			}
			return writeCommandOutput(cmd, agentTaskLeaseBundle(record))
		},
	}
	cmd.Flags().Int64Var(&leaseSeconds, "lease-seconds", 0, "Lease duration in seconds")
	return cmd
}

func newTaskCompleteCommand(deps commandDeps) *cobra.Command {
	var resultRaw string