ocpipe 0.6.7 → 0.6.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ocpipe",
-  "version": "0.6.7",
+  "version": "0.6.8",
   "description": "SDK for LLM pipelines with OpenCode, Codex, and Zod",
   "type": "module",
   "main": "src/index.ts",

package/src/codex.ts

@@ -7,10 +7,16 @@
 import {
   Codex,
   type CodexOptions as CodexSdkClientOptions,
+  type RunResult,
   type ThreadOptions,
 } from '@openai/codex-sdk'
 import { PROJECT_ROOT } from './paths.js'
-import type { CodexOptions, RunAgentOptions, RunAgentResult } from './types.js'
+import type {
+  CodexOptions,
+  CodexRunSummary,
+  RunAgentOptions,
+  RunAgentResult,
+} from './types.js'
 
 class CodexLogFilter {
   private buf = ''
@@ -121,13 +127,15 @@ export async function runCodexAgent(
 
     const nextSessionId = codex?.ephemeral ? '' : (thread.id ?? '')
     const sessionStr = nextSessionId || 'none'
+    const runSummary = buildCodexRunSummary(result)
     console.error(
-      `<<< Codex SDK done (${response.length} chars) [thread:${sessionStr}]`,
+      `<<< Codex SDK done [thread:${sessionStr}]\n${formatCodexRunSummary(runSummary)}`,
     )
 
     return {
       text: response,
       sessionId: nextSessionId,
+      runSummary,
     }
   } catch (err) {
     if (timedOut) {
@@ -143,6 +151,101 @@ export async function runCodexAgent(
   }
 }
 
+/** buildCodexRunSummary projects a Codex turn into a parent-readable summary. */
+export function buildCodexRunSummary(result: RunResult): CodexRunSummary {
+  const commands: CodexRunSummary['commands'] = []
+  const fileChanges: CodexRunSummary['fileChanges'] = []
+  let errorMessage = ''
+  let finalMessage = result.finalResponse.trim()
+
+  for (const item of result.items) {
+    switch (item.type) {
+      case 'agent_message':
+        if (item.text) finalMessage = item.text
+        break
+      case 'command_execution':
+        commands.push({
+          command: item.command,
+          status: item.status,
+          exitCode: item.exit_code ?? null,
+        })
+        break
+      case 'file_change':
+        for (const change of item.changes) {
+          fileChanges.push({
+            path: change.path,
+            kind: change.kind,
+            status: item.status,
+          })
+        }
+        break
+      case 'error':
+        errorMessage = item.message
+        break
+    }
+  }
+
+  const usage = result.usage
+  return {
+    status: errorMessage ? 'failed' : 'completed',
+    finalMessage: finalMessage.trim(),
+    errorMessage,
+    commands,
+    fileChanges,
+    tokens:
+      usage ?
+        {
+          input: usage.input_tokens,
+          cached: usage.cached_input_tokens,
+          output: usage.output_tokens,
+          reasoning: usage.reasoning_output_tokens,
+        }
+      : null,
+  }
+}
+
+/** formatCodexRunSummary renders a Codex run summary as a clean text block. */
+export function formatCodexRunSummary(summary: CodexRunSummary): string {
+  const lines: string[] = [`status: ${summary.status}`]
+  if (summary.errorMessage) {
+    lines.push(`error: ${summary.errorMessage}`)
+  }
+  if (summary.commands.length > 0) {
+    const failed = summary.commands.filter(isFailedCommand).length
+    lines.push(
+      `commands: ${summary.commands.length} completed, ${failed} failed`,
+    )
+  }
+  if (summary.fileChanges.length > 0) {
+    let add = 0
+    let update = 0
+    let del = 0
+    for (const change of summary.fileChanges) {
+      if (change.kind === 'add') add++
+      else if (change.kind === 'delete') del++
+      else update++
+    }
+    lines.push(`files: add=${add} update=${update} delete=${del}`)
+  }
+  if (summary.tokens) {
+    const t = summary.tokens
+    lines.push(
+      `tokens: input=${t.input} cached=${t.cached} output=${t.output} reasoning=${t.reasoning}`,
+    )
+  }
+  if (summary.finalMessage) {
+    lines.push(`final_message:\n${summary.finalMessage}`)
+  }
+  return lines.join('\n')
+}
+
+function isFailedCommand(command: CodexRunSummary['commands'][number]): boolean {
+  return (
+    command.status === 'failed' ||
+    (command.exitCode !== null && command.exitCode !== 0)
+  )
+}
+
 function buildCodexClientOptions(
   codex: CodexOptions | undefined,
 ): CodexSdkClientOptions {

package/src/index.ts

@@ -50,6 +50,7 @@ export { createSessionId, createBaseState, extendBaseState } from './state.js'
 
 // Agent integration
 export { runAgent, logStep } from './agent.js'
+export { buildCodexRunSummary, formatCodexRunSummary } from './codex.js'
 
 // Response parsing
 export {
@@ -116,6 +117,10 @@ export type {
   // Agent types
   RunAgentOptions,
   RunAgentResult,
+  CodexRunSummary,
+  CodexRunCommand,
+  CodexRunFileChange,
+  CodexRunTokens,
   // Correction types
   CorrectionMethod,
   CorrectionConfig,

package/src/types.ts

@@ -418,4 +418,38 @@ export interface RunAgentResult {
   text: string
   /** Session ID (for continuing the conversation). */
   sessionId: string
+  /** Clean run summary, set for the Codex backend. */
+  runSummary?: CodexRunSummary
+}
+
+/** CodexRunCommand records one command the Codex agent executed. */
+export interface CodexRunCommand {
+  command: string
+  status: string
+  exitCode: number | null
+}
+
+/** CodexRunFileChange records one file the Codex agent changed. */
+export interface CodexRunFileChange {
+  path: string
+  kind: 'add' | 'update' | 'delete'
+  status: string
+}
+
+/** CodexRunTokens records token usage for a Codex turn. */
+export interface CodexRunTokens {
+  input: number
+  cached: number
+  output: number
+  reasoning: number
+}
+
+/** CodexRunSummary is the parent-readable projection of a Codex turn. */
+export interface CodexRunSummary {
+  status: 'completed' | 'failed' | 'unknown'
+  finalMessage: string
+  errorMessage: string
+  commands: CodexRunCommand[]
+  fileChanges: CodexRunFileChange[]
+  tokens: CodexRunTokens | null
 }