@meistrari/agent-core 0.0.0 → 0.1.1

package/src/agents/codex/codex.errors.ts

@@ -0,0 +1,68 @@
+import type { ClientRequestMethod } from './codex-protocol'
+import { AgentProviderProtocolError, AgentProviderRuntimeError } from '../agent-runtime-error'
+
+interface CodexJsonRpcResponseErrorInput {
+    method: ClientRequestMethod
+    responseError: unknown
+}
+
+export class CodexJsonRpcResponseError extends AgentProviderProtocolError {
+    readonly method: ClientRequestMethod
+    readonly responseError: unknown
+    // JSON-RPC error `code` extracted structurally so consumers never parse message text.
+    readonly responseErrorCode: number | undefined
+
+    constructor({ method, responseError }: CodexJsonRpcResponseErrorInput) {
+        super({
+            message: 'Codex app-server returned JSON-RPC error.',
+            details: { method, error: stringifyJsonRpcError(responseError) },
+        })
+        this.method = method
+        this.responseError = responseError
+        this.responseErrorCode = jsonRpcErrorCode(responseError)
+    }
+}
+
+// Whether the request could have reached the Codex process: `before_write` is proven non-delivery
+// (safe to retry); `possible_write` means the input may already be in the provider.
+type CodexJsonRpcWriteState = 'before_write' | 'possible_write'
+
+export class CodexJsonRpcTransportClosedError extends AgentProviderRuntimeError {
+    readonly method: ClientRequestMethod
+    readonly writeState: CodexJsonRpcWriteState
+
+    constructor({ method, writeState, message, cause }: {
+        method: ClientRequestMethod
+        writeState: CodexJsonRpcWriteState
+        message: string
+        cause?: unknown
+    }) {
+        super({
+            code: 'agents.codex-transport-closed',
+            publicMessage: 'Codex app-server connection closed during a request.',
+            message,
+            details: { method, writeState },
+            ...(cause === undefined ? {} : { cause }),
+        })
+        this.method = method
+        this.writeState = writeState
+    }
+}
+
+function jsonRpcErrorCode(responseError: unknown): number | undefined {
+    if (typeof responseError !== 'object' || responseError === null || !('code' in responseError))
+        return undefined
+    const code = (responseError).code
+    return typeof code === 'number' ? code : undefined
+}
+
+function stringifyJsonRpcError(responseError: unknown): string {
+    if (typeof responseError === 'string')
+        return responseError
+    try {
+        return JSON.stringify(responseError)
+    }
+    catch {
+        return String(responseError)
+    }
+}