codex-claude-relay 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,87 @@
+export type AgentName = 'codex' | 'claude';
+export interface GitContext {
+    /** Absolute path to git root, or to cwd if not in a git repo. */
+    root: string;
+    /** True if `root` is actually a git repository top-level. */
+    inRepo: boolean;
+    /** Last path segment of `root`, used as a name signal during ranking. */
+    repoName: string;
+    /** Best-effort current branch name, or null if unavailable. */
+    branch: string | null;
+    /** Truncated `git status --short` output, or null if not in a repo / git missing. */
+    statusShort: string | null;
+}
+export interface SessionCandidate {
+    /** Absolute path to the JSONL transcript file. */
+    path: string;
+    /** mtime of the file in epoch ms. */
+    mtimeMs: number;
+    /** Working directory recorded inside the transcript (if any). */
+    recordedCwd: string | null;
+    /** Higher = better match. Producers should set this on a 0..100-ish scale. */
+    score: number;
+    /** Human-readable reason for the score (debugging / inspect). */
+    reasons: string[];
+}
+/** A normalized event extracted from either Codex or Claude transcripts. */
+export interface TranscriptEvent {
+    /** Source line index in the JSONL file (for debugging). */
+    lineNo: number;
+    /** Original epoch ms timestamp if any. Falls back to file mtime ordering. */
+    timestampMs: number | null;
+    kind: 'user_message' | 'assistant_message' | 'thinking' | 'tool_call' | 'tool_result' | 'system' | 'unknown';
+    /** Brief text payload. For tool calls this is a compact summary. */
+    text: string;
+    /** Tool name if kind === 'tool_call' or 'tool_result'. */
+    toolName?: string;
+    /** Shell command, if extractable from the tool call. */
+    command?: string;
+    /** Files that this event touched (read, edited, created). */
+    files?: string[];
+    /** If the tool result represents an error. */
+    isError?: boolean;
+}
+export interface ParsedSession {
+    /** The source JSONL file. */
+    path: string;
+    /** Working directory recorded in metadata, if any. */
+    recordedCwd: string | null;
+    /** Recorded git branch, if any. */
+    recordedBranch: string | null;
+    /** Session id, if any. */
+    sessionId: string | null;
+    /** Earliest and latest timestamps observed. */
+    startedAtMs: number | null;
+    endedAtMs: number | null;
+    /** Number of lines we successfully parsed. */
+    parsedLines: number;
+    /** Number of malformed JSONL lines we skipped. */
+    skippedLines: number;
+    /** All events in original order. */
+    events: TranscriptEvent[];
+}
+export interface HandoffContent {
+    /** The fully-rendered prompt string. */
+    text: string;
+    /** Whether the source session may be stale (older than ~24h). */
+    stale: boolean;
+    /** Human-readable provenance line, e.g. file path + timestamp. */
+    source: string;
+    /** Source agent name. */
+    sourceAgent: AgentName;
+}
+export interface RelayOptions {
+    /** Force using the latest session regardless of repo match. */
+    last: boolean;
+    /** Include current git diff in the handoff. */
+    withDiff: boolean;
+    /** Cap on the rendered handoff prompt length (in characters). */
+    maxChars: number;
+    /** Print the handoff but do not launch anything. */
+    dryRun: boolean;
+    /** Disable secret redaction in the handoff (default: redaction ON). */
+    noRedact: boolean;
+    /** Print verbose info about discovery & parsing. */
+    debug: boolean;
+}
+export declare const DEFAULT_OPTIONS: RelayOptions;

package/dist/types.js

@@ -0,0 +1,9 @@
+// Core shared types used by parsers, providers, summarizer and launcher.
+export const DEFAULT_OPTIONS = {
+    last: false,
+    withDiff: false,
+    maxChars: 12000,
+    dryRun: false,
+    noRedact: false,
+    debug: false,
+};

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "codex-claude-relay",
+  "version": "0.1.0",
+  "description": "Stateless context handoff between OpenAI Codex CLI and Anthropic Claude Code. Reads native session transcripts, condenses them, and launches the other agent with the handoff as its initial prompt.",
+  "type": "module",
+  "bin": {
+    "relay": "./dist/cli.js",
+    "codex-claude-relay": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README.zh.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test --import tsx test/*.test.ts",
+    "prepublishOnly": "npm run build",
+    "relay": "node dist/cli.js"
+  },
+  "keywords": [
+    "codex",
+    "claude",
+    "claude-code",
+    "cli",
+    "handoff",
+    "ai-agents",
+    "context",
+    "relay"
+  ],
+  "author": "Jayden Lee <lij850601@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Picrew/codex-claude-relay.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Picrew/codex-claude-relay/issues"
+  },
+  "homepage": "https://github.com/Picrew/codex-claude-relay#readme",
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.4.0"
+  }
+}