feat(gcp-cloud-run): live chunk-level render progress via the step-entries API#1904
Open
HackingCorp wants to merge 1 commit into
Open
feat(gcp-cloud-run): live chunk-level render progress via the step-entries API#1904HackingCorp wants to merge 1 commit into
HackingCorp wants to merge 1 commit into
Conversation
…tries API getRenderProgress reported overallProgress=0 until the execution succeeded, because the basic Executions API exposes no per-step data. This reads executions.stepEntries.list (REST — the gapic client has no surface for it yet) while the execution is ACTIVE and reports overallProgress on the same 10% plan + 80% chunks + 10% assemble split as the AWS adapter, plus new chunksCompleted/totalChunks fields. The appendSlots succeeded-entry count doubles as the planned chunk total before any chunk finishes. Best-effort: a missing workflowexecutions.stepEntries.list permission (part of roles/workflows.viewer) degrades to the old coarse snapshot; midFlightProgress:false skips the extra call per poll. CLI progress + --wait now print chunk counts.
HackingCorp
added a commit
to HackingCorp/ltc-motion
that referenced
this pull request
Jul 3, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Closes the biggest observability gap between the GCP and AWS adapters:
getRenderProgressreportedoverallProgress = 0for the whole life of an ACTIVE execution (the basic Executions API exposes no per-step data), while the Lambda adapter reads Step Functions history and shows live progress. Adopters couldn't render a progress bar on GCP.Changes
getRenderProgressnow reads the Cloud Workflows step-entries API (executions.stepEntries.list) while the execution is ACTIVE. The@google-cloud/workflowsgapic client (v4) has no surface for it yet, so the default reader hits the REST endpoint with ADC viagoogle-auth-library(new direct dependency; already in the transitive graph). Injection seam (stepEntries) mirrors the existingexecutionsseam for tests.overallProgressfollows the same 10% plan + 80% chunks + 10% assemble split as the AWS adapter — measured in chunks instead of frames, since step entries carry no payloads. NewchunksCompleted/totalChunksfields expose the raw counts (framesRenderedstays 0 until success, as before).appendSlotssucceeded-entry count doubles as the planned chunk total — available right afterbuildChunkList, well before any chunk finishes.workflowexecutions.stepEntries.list(part ofroles/workflows.viewer), an older control plane, or a transient error degrades to the previous coarse snapshot instead of failing the poll.midFlightProgress: falseskips the extra API call entirely.hyperframes cloudrun progressandrender --waitprint the chunk counts; docs updated.No workflow.yaml or Terraform changes required.
Testing
getRenderProgress(mid-flight math, plan-only phase, assemble cap at 0.99, permission-failure degradation, opt-out, success-path chunk fields), fullpackages/gcp-cloud-runsuite green (68 tests).packages/gcp-cloud-run+packages/clitypecheck clean on top of current main.🤖 Generated with Claude Code
https://claude.ai/code/session_018TXJXMe4QmSBnmYoR3brtk