Skip to content

Use Claude Code with your ChatGPT, Kimi, Cursor or Grok subscription via a local Anthropic-compatible proxy

Rust

preserve traffic event order

Raine Virta74895a7a0620
diff --git a/README.md b/README.md
index eb83297..c434f0f 100644
--- a/README.md
+++ b/README.md
@@ -520,7 +520,9 @@ affecting other keys.
- `traffic/` — per-request captures written when `CCP_TRAFFIC_LOG=1` is set.
Captures live under the state directory, grouped by Claude Code session and
request sequence. They include inbound Anthropic requests, translated upstream
- requests, upstream headers, upstream events, and downstream events. Token and
+ requests, upstream headers, upstream events, and downstream events. Stream
+ events are written under each request's `events/` directory with monotonic
+ sequence numbers so sorted filenames preserve emission order. Token and
account headers are redacted, but prompt and tool content are intentionally
preserved for debugging.
- `config.json` — optional configuration file (see table above). It lives at
diff --git a/src/providers/codex/translate/reducer.ts b/src/providers/codex/translate/reducer.ts
index 5c69553..416ff68 100644
--- a/src/providers/codex/translate/reducer.ts
+++ b/src/providers/codex/translate/reducer.ts
@@ -234,7 +234,7 @@ export async function* reduceUpstream(
}
const t: string = p.type || evt.event || "";
diagnostics.lastEventType = t;
- diagnostics.traffic?.writeJson("040-upstream-event", p);
+ diagnostics.traffic?.writeJsonEvent("040-upstream-event", p);
if (logVerbose())
log.debug("upstream event", { type: t, output_index: p.output_index, item_id: p.item_id });
diff --git a/src/providers/codex/translate/stream.ts b/src/providers/codex/translate/stream.ts
index 568613c..612a277 100644
--- a/src/providers/codex/translate/stream.ts
+++ b/src/providers/codex/translate/stream.ts
@@ -64,7 +64,7 @@ export function translateStream(
const emit = (event: string, data: unknown) => {
if (closed || opts.signal?.aborted || controller.desiredSize === null) return false;
try {
- opts.traffic?.writeJson("050-downstream-event", { event, data });
+ opts.traffic?.writeJsonEvent("050-downstream-event", { event, data });
controller.enqueue(encoder.encode(encodeSseEvent(event, data)));
lastEmitAt = Date.now();
lastEmitEvent = event;
diff --git a/src/providers/kimi/translate/reducer.ts b/src/providers/kimi/translate/reducer.ts
index 83efe89..dadfeef 100644
--- a/src/providers/kimi/translate/reducer.ts
+++ b/src/providers/kimi/translate/reducer.ts
@@ -121,7 +121,7 @@ export async function* reduceUpstream(
if (stats) {
stats.chunkCount++;
- stats.traffic?.writeJson("040-upstream-event", chunk);
+ stats.traffic?.writeJsonEvent("040-upstream-event", chunk);
}
if (chunk.error) {
diff --git a/src/providers/kimi/translate/stream.ts b/src/providers/kimi/translate/stream.ts
index bd037c7..7594780 100644
--- a/src/providers/kimi/translate/stream.ts
+++ b/src/providers/kimi/translate/stream.ts
@@ -37,7 +37,7 @@ export function translateStream(
return new ReadableStream<Uint8Array>({
async start(controller) {
const emit = (event: string, data: unknown) => {
- opts.traffic?.writeJson("050-downstream-event", { event, data });
+ opts.traffic?.writeJsonEvent("050-downstream-event", { event, data });
controller.enqueue(encoder.encode(encodeSseEvent(event, data)));
};
const activeTools = new Map<number, { id: string; name: string }>();
diff --git a/src/providers/types.ts b/src/providers/types.ts
index bafec63..479a7c8 100644
--- a/src/providers/types.ts
+++ b/src/providers/types.ts
@@ -6,6 +6,7 @@ export interface TrafficCapture {
writeJson(name: string, value: unknown): void;
writeText(name: string, value: string): void;
writeBytes(name: string, value: Uint8Array): void;
+ writeJsonEvent(name: string, value: unknown): void;
}
export interface RequestContext {
diff --git a/src/traffic.ts b/src/traffic.ts
index 0e07d71..979c652 100644
--- a/src/traffic.ts
+++ b/src/traffic.ts
@@ -23,26 +23,39 @@ export function createTrafficCapture(opts: {
const providerPart = sanitizePathPart(opts.provider || "unknown-provider");
const reqPart = sanitizePathPart(opts.reqId);
const dir = join(stateDir(), "traffic", sessionPart, `${seqPart}-${providerPart}-${reqPart}`);
- let counter = 0;
+ let artifactCounter = 0;
+ let eventCounter = 0;
- const filePath = (name: string) => {
- counter += 1;
- return join(dir, `${String(counter).padStart(3, "0")}-${sanitizePathPart(name)}`);
+ const artifactPath = (name: string) => {
+ artifactCounter += 1;
+ return join(dir, `${String(artifactCounter).padStart(3, "0")}-${sanitizePathPart(name)}`);
+ };
+ const eventPath = (name: string) => {
+ eventCounter += 1;
+ return join(
+ dir,
+ "events",
+ `${String(eventCounter).padStart(6, "0")}-${sanitizePathPart(name)}`,
+ );
};
return {
writeJson(name, value) {
- const path = filePath(ensureExtension(name, ".json"));
+ const path = artifactPath(ensureExtension(name, ".json"));
void writeCaptureFile(path, JSON.stringify(redactTraffic(value), null, 2));
},
writeText(name, value) {
- const path = filePath(ensureExtension(name, ".txt"));
+ const path = artifactPath(ensureExtension(name, ".txt"));
void writeCaptureFile(path, value);
},
writeBytes(name, value) {
- const path = filePath(name);
+ const path = artifactPath(name);
void writeCaptureFile(path, value);
},
+ writeJsonEvent(name, value) {
+ const path = eventPath(ensureExtension(name, ".json"));
+ void writeCaptureFile(path, JSON.stringify(redactTraffic(value), null, 2));
+ },
};
}