feat: Add streaming log endpoint for Actions workflow runs

[rossigee]

Summary

Adds a cursor-based streaming log endpoint for Actions workflow runs, allowing the UI and API consumers to poll step logs incrementally without downloading the full zip archive.

Note: This PR depends on #35382 (cancel, approve, and log download endpoints). Once that merges, the diff here will shrink to only the streaming-specific changes.

New endpoint

POST /repos/{owner}/{repo}/actions/runs/{run}/logs

Accepts a JSON body with per-step cursor positions and returns new log lines since each cursor:

{
  "logCursors": [
    { "step": 0, "cursor": 0, "expanded": true },
    { "step": 1, "cursor": 42, "expanded": true }
  ]
}

Returns:

{
  "stepsLog": [
    {
      "step": 0,
      "cursor": 5,
      "lines": [
        { "index": 1, "message": "...", "timestamp": 1234567890.123 }
      ],
      "started": 1234567890
    }
  ]
}

Design note

POST is used rather than GET because the request carries a structured array of per-step cursor state that doesn't map cleanly to query parameters (one cursor per expanded step, variable number). Open to discussion — if a simpler single-cursor GET endpoint is preferred, that can be explored here.

New files

• services/actions/log.go — ReadStepLogs service function
• New struct types in modules/structs/repo_actions.go: ActionLogCursor, ActionLogRequest, ActionLogStepLine, ActionLogStep, ActionLogResponse

Test plan

• TestAPIActionsGetWorkflowRunLogsStream passes (empty cursors, cursor with step, not-found)
• make lint-go — 0 issues

Co-Authored-By: Ross Golder ross@golder.org

[silverwind]

This seems useful for CLI use cases, similar to gh run watch <run-id>, maybe something to add to tea cli.

[Copilot]

Pull request overview

This PR adds a cursor-based streaming logs API for Actions workflow runs (to support incremental polling per step), and—due to the dependency on #35382—also includes related workflow run management/log download endpoints plus supporting conversions, swagger updates, and integration tests.

Changes:

• Add POST /repos/{owner}/{repo}/actions/runs/{run}/logs streaming endpoint returning per-step incremental log lines based on cursors.
• Add run/job log download endpoints and run management endpoints (cancel/approve), and wire routes + swagger.
• Extend Actions API structs/conversion (including created_at) and update integration/unit tests accordingly.

Reviewed changes

Copilot reviewed 15 out of 15 changed files in this pull request and generated 12 comments.

Show a summary per file

File	Description
services/actions/log.go	New ReadStepLogs service for cursor-based step log reads.
routers/api/v1/repo/actions_run.go	Implements cancel/approve, run logs download, job logs download, and streaming logs handlers.
routers/common/actions.go	Adds helper to zip/download all job logs; improves job log download error mapping.
modules/structs/repo_actions.go	Adds streaming log request/response structs; adds created_at to workflow run struct.
services/convert/convert.go	Updates Actions conversions (new ToActionWorkflowRun signature; adds CreatedAt).
services/actions/cancel.go	New service for cancelling runs by cancelling jobs and notifying downstream components.
routers/api/v1/api.go	Wires new Actions run routes (/cancel, /approve, /logs, job log download).
templates/swagger/v1_openapi3_json.tmpl	Documents new endpoints + adds created_at field to schema.
templates/swagger/v1_json.tmpl	Swagger v2 docs for new endpoints + adds created_at field to schema.
tests/integration/api_actions_run_test.go	Expands integration coverage for new Actions endpoints, including streaming logs.
services/actions/notifier.go	Adapts to new ToActionWorkflowRun signature.
services/webhook/notifier.go	Adapts to new ToActionWorkflowRun signature.
routers/api/v1/shared/action.go	Adapts list-runs conversion call to new ToActionWorkflowRun signature.
routers/api/v1/repo/action.go	Adapts existing run endpoints to new ToActionWorkflowRun signature.
services/convert/action_test.go	Updates unit test for updated workflow run conversion signature.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.