fix(cache): display server-provided skipped message

workflow-steps/cache/README.md

@@ -76,3 +76,12 @@ base-branch: 'main' # or another branch
 This will ensure that when you first open a PR, if a cached entry isn't found for the current branch, it will try to
 look at entries
 on your default protected branch (usually `main`).
+
+## Cache writes and access token permissions
+
+The cache step requires a **read-write** access token to write cache entries. If your CI access token only has **read**
+permissions, cache restores will work normally but cache uploads will be skipped with a message indicating the
+permissions issue.
+
+This is expected in setups where PR workflows use read-only tokens for security — cache entries are written by
+your main branch workflow (which uses a read-write token), and PR workflows only restore from that cache.

workflow-steps/cache/generated_protos/cache_pb.ts

@@ -210,6 +210,11 @@ export class StoreResponse extends Message<StoreResponse> {
    */
   skipped = false;
 
+  /**
+   * @generated from field: string skipped_message = 3;
+   */
+  skippedMessage = '';
+
   constructor(data?: PartialMessage<StoreResponse>) {
     super();
     proto3.util.initPartial(data, this);
@@ -220,6 +225,12 @@ export class StoreResponse extends Message<StoreResponse> {
   static readonly fields: FieldList = proto3.util.newFieldList(() => [
     { no: 1, name: 'success', kind: 'scalar', T: 8 /* ScalarType.BOOL */ },
     { no: 2, name: 'skipped', kind: 'scalar', T: 8 /* ScalarType.BOOL */ },
+    {
+      no: 3,
+      name: 'skipped_message',
+      kind: 'scalar',
+      T: 9 /* ScalarType.STRING */,
+    },
   ]);
 
   static fromBinary(

workflow-steps/cache/output/main.js

@@ -3510,6 +3510,10 @@ var StoreResponse = class _StoreResponse extends Message {
    * @generated from field: bool skipped = 2;
    */
   skipped = false;
+  /**
+   * @generated from field: string skipped_message = 3;
+   */
+  skippedMessage = "";
   constructor(data) {
     super();
     proto3.util.initPartial(data, this);
@@ -3530,6 +3534,12 @@ var StoreResponse = class _StoreResponse extends Message {
       kind: "scalar",
       T: 8
       /* ScalarType.BOOL */
+    },
+    {
+      no: 3,
+      name: "skipped_message",
+      kind: "scalar",
+      T: 9
     }
   ]);
   static fromBinary(bytes, options) {

workflow-steps/cache/output/post.js

@@ -3498,6 +3498,10 @@ var StoreResponse = class _StoreResponse extends Message {
    * @generated from field: bool skipped = 2;
    */
   skipped = false;
+  /**
+   * @generated from field: string skipped_message = 3;
+   */
+  skippedMessage = "";
   constructor(data) {
     super();
     proto3.util.initPartial(data, this);
@@ -3518,6 +3522,12 @@ var StoreResponse = class _StoreResponse extends Message {
       kind: "scalar",
       T: 8
       /* ScalarType.BOOL */
+    },
+    {
+      no: 3,
+      name: "skipped_message",
+      kind: "scalar",
+      T: 9
     }
   ]);
   static fromBinary(bytes, options) {
@@ -10289,7 +10299,8 @@ if (!!cacheWasHit) {
 Successfully uploaded marked directories.`);
     if (r.skipped)
       console.log(
-        "\nSkipped storing to cache, another instance has already started the upload."
+        `
+${r.skippedMessage || "Skipped storing to cache, another instance has already started the upload."}`
       );
     process.exit(0);
   }).catch((err) => {

workflow-steps/cache/post.ts

@@ -46,7 +46,7 @@ if (!!cacheWasHit) {
       if (r.success) console.log(`\nSuccessfully uploaded marked directories.`);
       if (r.skipped)
         console.log(
-          '\nSkipped storing to cache, another instance has already started the upload.',
+          `\n${r.skippedMessage || 'Skipped storing to cache, another instance has already started the upload.'}`,
         );
       process.exit(0);
     })