farhoodlabs/paperclip-adapter-opencode-k8s

T

Pawla Abdul 241da1d4f9 Use rich TranscriptEntry kinds in UI parser for pretty output

The UI parser was mapping all OpenCode JSONL events to plain stdout/stderr
transcript entries, causing the Paperclip UI to render everything as raw
terminal output. Updated parseStdoutLine to use structured kinds:

- text events → "assistant" (renders as chat bubbles)
- tool_use events → "tool_call" / "tool_result" (shows tool invocations)
- step_finish events → "result" (shows token/cost metrics)
- step_start events → "system" (shows step transitions)
- assistant events → "assistant" (nested content blocks)

Fixes FAR-43.

Co-Authored-By: Paperclip <noreply@paperclip.ing>

2026-04-12 15:15:19 +00:00

.github/workflows

CI: skip publish if version already published

2026-04-12 10:37:28 -04:00

src

Use rich TranscriptEntry kinds in UI parser for pretty output

2026-04-12 15:15:19 +00:00

.gitignore

Add tests, free-text model field, and K8s job improvements

2026-04-12 08:14:57 -04:00

package-lock.json

Upgrade adapter-utils to canary with getConfigSchema type support

2026-04-12 14:58:07 +00:00

package.json

Use rich TranscriptEntry kinds in UI parser for pretty output

2026-04-12 15:15:19 +00:00

README.md

Update package name to @farhoodliquor scope and refresh README

2026-04-11 23:18:12 -04:00

tsconfig.json

Initial commit

2026-04-11 23:08:05 -04:00

vitest.config.ts

Add tests, free-text model field, and K8s job improvements

2026-04-12 08:14:57 -04:00

README.md

@farhoodliquor/paperclip-adapter-opencode-k8s

Paperclip adapter plugin that runs OpenCode agents as isolated Kubernetes Jobs instead of inside the main Paperclip process.

Features

Spawns agent runs as K8s Jobs with full pod isolation
Inherits container image, secrets, DNS, and PVC from the Paperclip Deployment automatically
Real-time log streaming from Job pods back to the Paperclip UI
Session resume via shared RWX PVC
Per-agent concurrency guard
Configurable resources, namespace, kubeconfig
Runtime config injection for permission bypass

Installation

Via Paperclip Adapter Manager

curl -X POST http://localhost:3100/api/adapters \
  -H "Content-Type: application/json" \
  -d '{"packageName": "@farhoodliquor/paperclip-adapter-opencode-k8s"}'

Local Development

curl -X POST http://localhost:3100/api/adapters \
  -H "Content-Type: application/json" \
  -d '{"localPath": "/path/to/paperclip-adapter-opencode-k8s"}'

Configuration

See the agent configuration documentation for all available fields:

model (required) — OpenCode model in provider/model format
variant — reasoning profile variant
namespace — K8s namespace for Jobs
image — Override container image
kubeconfig — Path to kubeconfig file
resources — CPU/memory requests and limits
timeoutSec — Run timeout (0 = no timeout)
retainJobs — Keep completed Jobs for debugging

Requirements

Paperclip must be deployed on a Kubernetes cluster with a shared RWX PVC mounted at /paperclip — this is required for session resume and workspace sharing between the Paperclip pod and agent Job pods
Kubernetes cluster with RBAC permissions to create Jobs, list Pods, and read Pod logs
@paperclipai/adapter-utils >= 0.3.0

License

MIT