ocpipe 0.6.10 → 0.6.12

package/src/claude-code.ts

@@ -11,7 +11,7 @@
  */
 
 import { execSync } from 'child_process'
-import { existsSync, readFileSync } from 'fs'
+import { existsSync } from 'fs'
 import { join } from 'path'
 import { homedir } from 'os'
 import {
@@ -66,9 +66,14 @@ function resolveClaudeCodePath(explicit?: string): string | undefined {
   if (explicit) return explicit
 
   try {
-    const found = execSync('which claude', { encoding: 'utf8', timeout: 3000 }).trim()
+    const found = execSync('which claude', {
+      encoding: 'utf8',
+      timeout: 3000,
+    }).trim()
     if (found) return found
-  } catch { /* which not found or timed out — fall through to defaults */ }
+  } catch {
+    /* which not found or timed out — fall through to defaults */
+  }
 
   const defaults = [
     join(homedir(), '.local', 'bin', 'claude'),
@@ -90,21 +95,6 @@ function normalizeModelId(modelId: string): string {
   return modelId
 }
 
-/** loadAgentDefinition loads an OpenCode agent definition file and extracts the
- * markdown body (stripping the YAML frontmatter) for use as a system prompt. */
-function loadAgentDefinition(agent: string, workdir?: string): string | undefined {
-  if (!agent || !workdir) return undefined
-
-  const agentPath = join(workdir, '.opencode', 'agents', `${agent}.md`)
-  if (!existsSync(agentPath)) return undefined
-
-  const content = readFileSync(agentPath, 'utf8')
-
-  // Strip YAML frontmatter (--- delimited block at the start).
-  const stripped = content.replace(/^---\n[\s\S]*?\n---\n*/, '')
-  return stripped.trim() || undefined
-}
-
 /** Extract text from assistant messages. */
 function getAssistantText(msg: SDKMessage): string | null {
   if (msg.type !== 'assistant') return null
@@ -147,7 +137,6 @@ export async function runClaudeCodeAgent(
 ): Promise<RunAgentResult> {
   const {
     prompt,
-    agent,
     model,
     sessionId,
     timeoutSec = 3600,
@@ -169,8 +158,8 @@ export async function runClaudeCodeAgent(
   // Build query options with configurable permission mode (default: acceptEdits)
   const permissionMode = claudeCode?.permissionMode ?? 'acceptEdits'
 
-  // Resolve system prompt: explicit option > agent definition file > none
-  const systemPrompt = claudeCode?.systemPrompt ?? loadAgentDefinition(agent, workdir)
+  // Resolve system prompt from explicit configuration only.
+  const systemPrompt = claudeCode?.systemPrompt
 
   // Bridge external abort signal to an AbortController for the SDK
   const abortController = new AbortController()
@@ -217,16 +206,22 @@ export async function runClaudeCodeAgent(
       }),
     // Resolve executable path: explicit option > PATH lookup > default locations
     ...(() => {
-      const resolved = resolveClaudeCodePath(claudeCode?.pathToClaudeCodeExecutable)
+      const resolved = resolveClaudeCodePath(
+        claudeCode?.pathToClaudeCodeExecutable,
+      )
       return resolved ? { pathToClaudeCodeExecutable: resolved } : {}
     })(),
   }
 
   if (claudeCode?.agents) {
-    console.error(`[ocpipe] Subagents defined: ${Object.keys(claudeCode.agents).join(', ')}`)
+    console.error(
+      `[ocpipe] Subagents defined: ${Object.keys(claudeCode.agents).join(', ')}`,
+    )
   }
   if (claudeCode?.allowedTools) {
-    console.error(`[ocpipe] Allowed tools: ${claudeCode.allowedTools.join(', ')}`)
+    console.error(
+      `[ocpipe] Allowed tools: ${claudeCode.allowedTools.join(', ')}`,
+    )
   }
   console.error(
     `\n>>> Claude Code [${modelStr}] [${permissionMode}] ${sessionInfo}: ${promptPreview}...`,

package/src/codex.ts

@@ -10,6 +10,7 @@ import {
   type RunResult,
   type ThreadOptions,
 } from '@openai/codex-sdk'
+import { OutputLimitError } from './errors.js'
 import { PROJECT_ROOT } from './paths.js'
 import type {
   CodexOptions,
@@ -18,22 +19,29 @@ import type {
   RunAgentResult,
 } from './types.js'
 
+const MAX_CODEX_LOG_LINE_BYTES = 1024 * 1024
+
 class CodexLogFilter {
   private buf = ''
   private suppressHtml = false
 
   write(text: string): string {
-    this.buf += text
     let out = ''
-    for (;;) {
-      const idx = this.buf.indexOf('\n')
+    let cursor = 0
+    while (cursor < text.length) {
+      const idx = text.indexOf('\n', cursor)
       if (idx < 0) {
-        return out
+        this.append(text.slice(cursor))
+        break
       }
-      const line = this.buf.slice(0, idx + 1)
-      this.buf = this.buf.slice(idx + 1)
-      out += this.filterLine(line)
+
+      const line = text.slice(cursor, idx + 1)
+      cursor = idx + 1
+      this.append(line)
+      out += this.filterLine(this.buf)
+      this.buf = ''
     }
+    return out
   }
 
   flush(): string {
@@ -42,6 +50,16 @@ class CodexLogFilter {
     return this.filterLine(line)
   }
 
+  private append(text: string): void {
+    if (
+      Buffer.byteLength(this.buf, 'utf8') + Buffer.byteLength(text, 'utf8') >
+      MAX_CODEX_LOG_LINE_BYTES
+    ) {
+      throw new OutputLimitError('Codex log line', MAX_CODEX_LOG_LINE_BYTES)
+    }
+    this.buf += text
+  }
+
   private filterLine(line: string): string {
     if (this.suppressHtml) {
       if (line.includes('</html>')) {
@@ -239,7 +257,9 @@ export function formatCodexRunSummary(summary: CodexRunSummary): string {
   return lines.join('\n')
 }
 
-function isFailedCommand(command: CodexRunSummary['commands'][number]): boolean {
+function isFailedCommand(
+  command: CodexRunSummary['commands'][number],
+): boolean {
   return (
     command.status === 'failed' ||
     (command.exitCode !== null && command.exitCode !== 0)

package/src/errors.ts

@@ -0,0 +1,19 @@
+/** ocpipe typed runtime errors. */
+
+function formatBytes(bytes: number): string {
+  if (bytes >= 1024 * 1024 * 1024) return `${bytes / (1024 * 1024 * 1024)} GiB`
+  if (bytes >= 1024 * 1024) return `${bytes / (1024 * 1024)} MiB`
+  if (bytes >= 1024) return `${bytes / 1024} KiB`
+  return `${bytes} bytes`
+}
+
+/** OutputLimitError reports a bounded output buffer or file limit breach. */
+export class OutputLimitError extends Error {
+  constructor(
+    public readonly source: string,
+    public readonly limitBytes: number,
+  ) {
+    super(`${source} exceeded ${formatBytes(limitBytes)} limit`)
+    this.name = 'OutputLimitError'
+  }
+}

package/src/index.ts

@@ -1,5 +1,5 @@
 /**
- * ocpipe: LLM pipelines with OpenCode and Zod.
+ * ocpipe: LLM pipelines with coding-agent backends and Zod.
  *
  * Inspired by DSPy.
  *
@@ -22,8 +22,7 @@
  * // Run in a pipeline
  * const pipeline = new Pipeline({
  *   name: 'my-workflow',
- *   defaultModel: { providerID: 'opencode', modelID: 'minimax-m2.1-free' },
- *   defaultAgent: 'general',
+ *   defaultModel: { backend: 'omp', modelID: 'gpt-5.5' },
  *   checkpointDir: './ckpt',
  *   logDir: './logs',
  * }, createBaseState)
@@ -51,6 +50,7 @@ export { createSessionId, createBaseState, extendBaseState } from './state.js'
 // Agent integration
 export { runAgent, logStep } from './agent.js'
 export { buildCodexRunSummary, formatCodexRunSummary } from './codex.js'
+export { OutputLimitError } from './errors.js'
 
 // Response parsing
 export {

package/src/pipeline.ts

@@ -30,9 +30,9 @@ export class Pipeline<S extends BaseState> {
     this.ctx = {
       sessionId: undefined,
       defaultModel: config.defaultModel,
-      defaultAgent: config.defaultAgent,
       timeoutSec: config.timeoutSec ?? 3600,
       workdir: config.workdir,
+      opencode: config.opencode,
       claudeCode: config.claudeCode,
       codex: config.codex,
       pi: config.pi,
@@ -89,8 +89,8 @@ export class Pipeline<S extends BaseState> {
           result: result as StepResult<unknown>,
         })
 
-        // Update opencode session in state
-        this.state.opencodeSessionId = this.ctx.sessionId
+        // Update backend session in state.
+        this.state.agentSessionId = this.ctx.sessionId
 
         await this.saveCheckpoint()
         return result
@@ -159,7 +159,7 @@ export class Pipeline<S extends BaseState> {
     }
   }
 
-  /** getSessionId returns the current OpenCode session ID. */
+  /** getSessionId returns the current backend session ID. */
   getSessionId(): string | undefined {
     return this.ctx.sessionId
   }
@@ -189,9 +189,9 @@ export class Pipeline<S extends BaseState> {
       const pipeline = new Pipeline<S>(config, () => state)
       pipeline.state = state
 
-      // Restore context from state
-      if (state.opencodeSessionId) {
-        pipeline.ctx.sessionId = state.opencodeSessionId
+      // Restore context from state.
+      if (state.agentSessionId) {
+        pipeline.ctx.sessionId = state.agentSessionId
       }
 
       // Restore step number

package/src/predict.ts

@@ -1,7 +1,8 @@
 /**
  * ocpipe Predict class.
  *
- * Executes a signature by generating a prompt, calling OpenCode, and parsing the response.
+ * Executes a signature by generating a prompt, calling a backend, and parsing
+ * the response.
  */
 
 import { z } from 'zod/v4'
@@ -37,8 +38,6 @@ import {
 
 /** Configuration for a Predict instance. */
 export interface PredictConfig {
-  /** Override the pipeline's default agent. */
-  agent?: string
   /** Override the pipeline's default model. */
   model?: ModelConfig
   /** Start a fresh session (default: false, reuses context). */
@@ -71,12 +70,12 @@ export class Predict<S extends AnySignature> {
 
     const agentResult = await runAgent({
       prompt,
-      agent: this.config.agent ?? ctx.defaultAgent,
       model: this.config.model ?? ctx.defaultModel,
       sessionId: this.config.newSession ? undefined : ctx.sessionId,
       timeoutSec: ctx.timeoutSec,
       workdir: ctx.workdir,
       claudeCode: ctx.claudeCode,
+      opencode: ctx.opencode,
       codex: ctx.codex,
       pi: ctx.pi,
       omp: ctx.omp,
@@ -206,10 +205,10 @@ export class Predict<S extends AnySignature> {
         prompt: repairPrompt,
         model: correctionModel ?? ctx.defaultModel,
         sessionId: correctionModel ? undefined : sessionId,
-        agent: ctx.defaultAgent,
         timeoutSec: ctx.timeoutSec,
         workdir: ctx.workdir,
         claudeCode: ctx.claudeCode,
+        opencode: ctx.opencode,
         codex: ctx.codex,
         pi: ctx.pi,
         omp: ctx.omp,
@@ -286,10 +285,10 @@ export class Predict<S extends AnySignature> {
         prompt: patchPrompt,
         model: correctionModel ?? ctx.defaultModel,
         sessionId: correctionModel ? undefined : sessionId,
-        agent: ctx.defaultAgent,
         timeoutSec: ctx.timeoutSec,
         workdir: ctx.workdir,
         claudeCode: ctx.claudeCode,
+        opencode: ctx.opencode,
         codex: ctx.codex,
         pi: ctx.pi,
         omp: ctx.omp,
@@ -399,8 +398,7 @@ export class Predict<S extends AnySignature> {
     // Add field descriptions from our config (toJSONSchema uses .describe() metadata)
     // Since our FieldConfig has a separate desc field, merge it in
     const props = jsonSchema.properties as
-      | Record<string, Record<string, unknown>>
-      | undefined
+      Record<string, Record<string, unknown>> | undefined
     if (props) {
       for (const [name, config] of Object.entries(this.sig.outputs) as [
         string,

package/src/testing.ts

@@ -134,18 +134,20 @@ export class MockAgentBackend {
 export function createMockContext(
   overrides?: Partial<{
     sessionId: string
-    defaultModel: { providerID: string; modelID: string }
-    defaultAgent: string
+    defaultModel: {
+      backend?: 'claude-code' | 'codex' | 'pi' | 'omp'
+      providerID?: string
+      modelID: string
+    }
     timeoutSec: number
   }>,
 ) {
   return {
     sessionId: overrides?.sessionId,
     defaultModel: overrides?.defaultModel ?? {
-      providerID: 'github-copilot',
-      modelID: 'grok-code-fast-1',
+      backend: 'omp',
+      modelID: 'gpt-5.5',
     },
-    defaultAgent: overrides?.defaultAgent ?? 'general',
     timeoutSec: overrides?.timeoutSec ?? 60,
   }
 }

package/src/types.ts

@@ -8,29 +8,20 @@ import type { z } from 'zod/v4'
 // Model Configuration
 // ============================================================================
 
-/** Backend type for running agents. */
+/** Backend type for running prompts. */
 export type BackendType = 'opencode' | 'claude-code' | 'codex' | 'pi' | 'omp'
 
 /** Reasoning effort for Codex SDK threads. */
 export type CodexReasoningEffort =
-  | 'minimal'
-  | 'low'
-  | 'medium'
-  | 'high'
-  | 'xhigh'
+  'minimal' | 'low' | 'medium' | 'high' | 'xhigh'
 
 /** Codex sandbox mode. */
 export type CodexSandboxMode =
-  | 'read-only'
-  | 'workspace-write'
-  | 'danger-full-access'
+  'read-only' | 'workspace-write' | 'danger-full-access'
 
 /** Codex approval policy. */
 export type CodexApprovalPolicy =
-  | 'never'
-  | 'on-request'
-  | 'on-failure'
-  | 'untrusted'
+  'never' | 'on-request' | 'on-failure' | 'untrusted'
 
 /** Codex web search mode. */
 export type CodexWebSearchMode = 'disabled' | 'cached' | 'live'
@@ -45,10 +36,7 @@ export type CodexConfigValue =
 
 /** Permission mode for Claude Code sessions. */
 export type PermissionMode =
-  | 'default'
-  | 'acceptEdits'
-  | 'bypassPermissions'
-  | 'plan'
+  'default' | 'acceptEdits' | 'bypassPermissions' | 'plan'
 
 /** Subagent definition for Claude Code's Task tool dispatch. */
 export interface AgentDefinition {
@@ -75,8 +63,7 @@ export interface ClaudeCodeOptions {
    * Can be a full string or use the preset format with append.
    */
   systemPrompt?:
-    | string
-    | { type: 'preset'; preset: 'claude_code'; append: string }
+    string | { type: 'preset'; preset: 'claude_code'; append: string }
   /**
    * Subagent definitions for parallel task dispatch via the Task tool.
    * Keys are agent names, values are agent definitions.
@@ -133,6 +120,16 @@ export interface PiOptions {
   env?: Record<string, string>
 }
 
+/** OpenCode CLI specific session options. */
+export interface OpenCodeOptions {
+  /** Path to the OpenCode executable (default: `opencode` from PATH). */
+  command?: string
+  /** Prompt-file directory; defaults to ocpipe's temporary directory, not `.opencode`. */
+  promptDir?: string
+  /** Extra environment variables passed to the OpenCode subprocess. */
+  env?: Record<string, string>
+}
+
 /** Oh My Pi CLI specific session options. */
 export interface OmpOptions {
   /** Path to the Oh My Pi executable (default: `omp` from PATH). */
@@ -167,9 +164,9 @@ export interface OmpOptions {
 
 /** Model configuration for LLM backends. */
 export interface ModelConfig {
-  /** Backend to use (default: 'opencode'). */
+  /** Backend to use (default: 'omp'). */
   backend?: BackendType
-  /** Provider ID (required for OpenCode, ignored for Claude Code). */
+  /** Provider ID for provider-qualified backends such as OpenCode. */
   providerID?: string
   modelID: string
   /** Model variant for reasoning effort (e.g. 'low', 'medium', 'high', 'max'). */
@@ -184,16 +181,16 @@ export interface ModelConfig {
 
 /** Execution context passed through pipeline execution. */
 export interface ExecutionContext {
-  /** Current OpenCode session ID (for continuity). */
+  /** Current backend session ID for continuity. */
   sessionId?: string
   /** Default model for predictions. */
   defaultModel: ModelConfig
-  /** Default agent for predictions. */
-  defaultAgent: string
   /** Timeout in seconds for agent calls. */
   timeoutSec: number
-  /** Working directory for opencode (where .opencode/agents/ lives). */
+  /** Target working directory for backend tools. */
   workdir?: string
+  /** OpenCode CLI specific options. */
+  opencode?: OpenCodeOptions
   /** Claude Code specific options. */
   claudeCode?: ClaudeCodeOptions
   /** Codex SDK specific options. */
@@ -218,7 +215,7 @@ export interface StepResult<T> {
   stepName: string
   /** Execution duration in milliseconds. */
   duration: number
-  /** OpenCode session ID used. */
+  /** Backend session ID used. */
   sessionId: string
   /** Model used for this step. */
   model: ModelConfig
@@ -251,8 +248,8 @@ export interface BaseState {
   sessionId: string
   /** ISO timestamp when pipeline started. */
   startedAt: string
-  /** Current OpenCode session ID (for continuity). */
-  opencodeSessionId?: string
+  /** Current backend session ID for continuity. */
+  agentSessionId?: string
   /** Current phase name (for resume). */
   phase: string
   /** All completed steps. */
@@ -271,7 +268,7 @@ export interface PredictResult<T> {
   data: T
   /** Raw response text from the LLM. */
   raw: string
-  /** OpenCode session ID. */
+  /** Backend session ID. */
   sessionId: string
   /** Execution duration in milliseconds. */
   duration: number
@@ -364,9 +361,7 @@ export interface CorrectionConfig {
 
 /** Error codes for field errors, enabling robust error type detection. */
 export type FieldErrorCode =
-  | 'json_parse_failed'
-  | 'no_json_found'
-  | 'schema_validation_failed'
+  'json_parse_failed' | 'no_json_found' | 'schema_validation_failed'
 
 /** A field-level error from schema validation. */
 export interface FieldError {
@@ -406,8 +401,6 @@ export interface PipelineConfig {
   name: string
   /** Default model for predictions. */
   defaultModel: ModelConfig
-  /** Default agent for predictions. */
-  defaultAgent: string
   /** Directory for checkpoint files. */
   checkpointDir: string
   /** Directory for log files. */
@@ -416,8 +409,10 @@ export interface PipelineConfig {
   retry?: RetryConfig
   /** Default timeout in seconds. */
   timeoutSec?: number
-  /** Working directory for opencode (where .opencode/agents/ lives). */
+  /** Target working directory for backend tools. */
   workdir?: string
+  /** OpenCode CLI specific options. */
+  opencode?: OpenCodeOptions
   /** Claude Code specific options. */
   claudeCode?: ClaudeCodeOptions
   /** Codex SDK specific options. */
@@ -444,20 +439,20 @@ export interface RunOptions {
 // Agent Types
 // ============================================================================
 
-/** Options for running an OpenCode agent. */
+/** Options for running a prompt through a backend. */
 export interface RunAgentOptions {
-  /** The prompt to send to the agent. */
+  /** The prompt to send to the backend. */
   prompt: string
-  /** Agent type (e.g., "journey-creator", "explore", "general"). */
-  agent: string
   /** Model to use. */
   model: ModelConfig
   /** Existing session ID to continue. */
   sessionId?: string
   /** Timeout in seconds. */
   timeoutSec?: number
-  /** Working directory for opencode (where .opencode/agents/ lives). */
+  /** Target working directory for backend tools. */
   workdir?: string
+  /** OpenCode CLI specific options. */
+  opencode?: OpenCodeOptions
   /** Claude Code specific options. */
   claudeCode?: ClaudeCodeOptions
   /** Codex SDK specific options. */
@@ -470,7 +465,7 @@ export interface RunAgentOptions {
   signal?: AbortSignal
 }
 
-/** Result from running an OpenCode agent. */
+/** Result from running a prompt through a backend. */
 export interface RunAgentResult {
   /** The text response from the agent. */
   text: string