Chris Farhood
b60765785b
All output sent to Paperclip via onLog now passes through formatClaudeStreamLine, converting raw stream-json blobs into human-readable text consistent with how the CLI and claude_local adapter format events. Changes: - format-event.ts: add formatClaudeStreamLine(raw) -> string | null Plain-text equivalent of printClaudeStreamEvent — no ANSI colours, returns null for lines to suppress (assistant with no content, unknown events). Handles: system/init, assistant (text/thinking/tool_use), user (tool_result), result (summary + tokens), rate_limit_event. Non-JSON lines pass through. - execute.ts: wire formatClaudeStreamLine into streamPodLogsOnce write handler. raw chunks still stored in 'chunks[]' for parseClaudeStreamJson; only the onLog path receives formatted text. - 12 new tests for formatClaudeStreamLine covering all event types. - 352/352 tests pass. Co-Authored-By: Paperclip <noreply@paperclip.ing>
56 lines
3.0 KiB
TypeScript
56 lines
3.0 KiB
TypeScript
export const type = "claude_k8s";
|
|
export const label = "Claude (Kubernetes)";
|
|
|
|
export const models: undefined = undefined;
|
|
|
|
export const agentConfigurationDoc = `# claude_k8s agent configuration
|
|
|
|
Adapter: claude_k8s
|
|
|
|
Runs Claude Code inside an isolated Kubernetes Job pod instead of the main
|
|
Paperclip process. The Job inherits the container image, imagePullSecrets,
|
|
DNS config, and PVC from the running Paperclip Deployment automatically.
|
|
|
|
Core fields:
|
|
- model (string, optional): Claude model id
|
|
- effort (string, optional): reasoning effort passed via --effort (low|medium|high)
|
|
- maxTurnsPerRun (number, optional): max turns for one run
|
|
- instructionsFilePath (string, optional): absolute path to a markdown instructions file injected at runtime via --append-system-prompt-file
|
|
- extraArgs (string[], optional): additional CLI args appended to the claude command
|
|
- env (object, optional): KEY=VALUE environment variables; overrides inherited vars from the Deployment
|
|
|
|
Kubernetes fields:
|
|
- namespace (string, optional): namespace for Jobs; defaults to the Deployment namespace
|
|
- image (string, optional): override container image; defaults to the running Deployment image
|
|
- imagePullPolicy (string, optional): image pull policy; default "IfNotPresent"
|
|
- kubeconfig (string, optional): absolute path to a kubeconfig file on disk; defaults to in-cluster service account auth
|
|
- resources (object, optional): { requests: { cpu, memory }, limits: { cpu, memory } }
|
|
- nodeSelector (object, optional): node selector for Job pods
|
|
- tolerations (array, optional): tolerations for Job pods
|
|
- labels (object, optional): extra labels added to Job metadata
|
|
- ttlSecondsAfterFinished (number, optional): auto-cleanup delay; default 300
|
|
- retainJobs (boolean, optional): skip cleanup on completion for debugging
|
|
- reattachOrphanedJobs (boolean, optional): when true (default), attach to a running orphaned Job that matches the current agent/task/session instead of blocking; when false, any non-terminal orphan blocks the new run
|
|
|
|
Output filtering fields:
|
|
- enableRtk (boolean, optional): truncate oversized tool outputs before they reach the model via a PostToolUse hook; default false
|
|
- rtkMaxOutputBytes (number, optional): byte threshold for tool output truncation when enableRtk is true; default 50000
|
|
|
|
Operational fields:
|
|
- timeoutSec (number, optional): run timeout in seconds; 0 means no timeout
|
|
- graceSec (number, optional): additional grace before adapter gives up after Job deadline
|
|
|
|
Inherited from Deployment (no config needed):
|
|
- ANTHROPIC_API_KEY, OPENAI_API_KEY, and other provider API keys
|
|
- PAPERCLIP_API_URL
|
|
- Container image, imagePullSecrets, DNS config, PVC mount, security context
|
|
|
|
Notes:
|
|
- Session resume works via the shared /paperclip PVC (HOME=/paperclip)
|
|
- Skills are bundled in the container image
|
|
- Prompts are delivered via a busybox init container writing to an emptyDir volume
|
|
`;
|
|
|
|
export { createServerAdapter } from "./server/index.js";
|
|
export { printClaudeStreamEvent, formatClaudeStreamLine } from "./cli/index.js";
|