feat(plugin): add kubernetes fast upload interceptor

2026-05-13 12:01:34 -05:00
parent a6c2e0392b
commit fcbbd50b60
8 changed files with 400 additions and 24 deletions
@@ -104,6 +104,12 @@ Pod                pc-{ulid}-{podSuffix}           (managed by Sandbox controlle
 Secret             pc-{ulid}-env                   (owned by Sandbox CR; cascade-deleted)
 ```

+## Fast workspace uploads
+
+The `sandbox-cr` backend recognizes the chunked base64 upload protocol emitted by `@paperclipai/adapter-utils` for workspace, skill, and config-seed file transfers. Instead of running one Kubernetes exec per base64 chunk, the plugin buffers the upload in worker memory and flushes the final payload through a single `head -c <bytes> | base64 -d` exec with stdin.
+
+The interceptor is intentionally narrow: only the exact `mkdir`/`printf`/`base64 -d` command shape generated by adapter-utils is optimized. Unknown commands, missing init state, or uploads over the 100 MB buffer cap fall back to normal exec behavior.
+
 For each agent run (job backend):

 ```