@amalgm/chat 0.1.0

package/dist/normalizers/codex.d.ts

@@ -0,0 +1,352 @@
+/**
+ * Codex (app-server JSON-RPC) normalizer — engine
+ * `chat-core/normalizers/codex.js` (415 lines) ported byte-exact.
+ *
+ * The engine module calls the event constructors from `../events` directly;
+ * here the host builds an {@link EventConstructors} instance (axiom 7) and
+ * `createCodexNormalizer(events)` closes `normalizeCodexNotification` over
+ * it. The item helpers (`codexTool*`, `isCodexToolItem`, `codexErrorMessage`)
+ * construct no events, so they are also exported at module level.
+ *
+ * CRITICAL usage shape: `thread/tokenUsage/updated` carries CUMULATIVE
+ * totals; this normalizer derives `cumulativeTokenList` +
+ * `previousCumulativeTokenList` (via per-session state) so the usage
+ * module's delta math (`finalizeTurnUsage` codex branch) can subtract
+ * consecutive snapshots. `last.inputTokens` is a TOTAL-input figure —
+ * passed as `totalInputTokens` so `normalizeUsage` decomposes it into
+ * non-cached input by subtracting the cache buckets.
+ */
+import type { EventConstructors } from '../events/index.js';
+import { type NormalizedError } from '../transcript/index.js';
+import { type TokenList } from '../usage/index.js';
+type AnyRecord = Record<string, any>;
+/**
+ * The mutable per-session state threaded through
+ * `normalizeCodexNotification`. All fields are engine-lazy; the object may
+ * start empty (or be omitted entirely).
+ */
+export interface CodexNormalizerState {
+    codexCompactionActive?: boolean;
+    codexCompactionUsageEmitted?: boolean;
+    codexCompactionItemId?: string | null;
+    codexCumulativeTokenList?: TokenList | null;
+    lastCodexCompactionSnapshotTotal?: number;
+    [key: string]: any;
+}
+/** Engine codex.js:10-12. Id aliases across app-server protocol revisions. */
+export declare function codexToolCallId(item?: AnyRecord): any;
+/** Engine codex.js:14-16. A tool item = has a call id and a non-text/compaction type. */
+export declare function isCodexToolItem(item?: AnyRecord): boolean;
+/** Engine codex.js:18-25. Semantic item types map onto the Claude tool taxonomy. */
+export declare function codexToolName(item?: AnyRecord): any;
+/** Engine codex.js:27-56. Merge order: known keys < item.input < arguments < rawInput < action.* . */
+export declare function codexToolInput(item?: AnyRecord): AnyRecord;
+/** Engine codex.js:74-79. Failed-with-error yields '' (the error rides `codexToolError`). */
+export declare function codexToolOutput(item?: AnyRecord): any;
+/** Engine codex.js:81-84. */
+export declare function codexToolError(item?: AnyRecord): NormalizedError | undefined;
+/** Engine codex.js:108-117. Input summary first; output summary as fallback. */
+export declare function codexToolDetail(item?: AnyRecord): string;
+/** Engine codex.js:119-130. */
+export declare function codexToolTitle(item?: AnyRecord): string;
+/** Engine codex.js:185-198. Error-message extraction fallback chain. */
+export declare function codexErrorMessage(error: unknown, fallback?: string): string;
+/**
+ * Build the engine's Codex normalizer export set over an injected
+ * {@link EventConstructors} instance. Function-for-function parity with
+ * engine `chat-core/normalizers/codex.js` `module.exports`.
+ */
+export declare function createCodexNormalizer(events: EventConstructors): {
+    codexErrorMessage: typeof codexErrorMessage;
+    codexToolInput: typeof codexToolInput;
+    codexToolDetail: typeof codexToolDetail;
+    codexToolError: typeof codexToolError;
+    codexToolCallId: typeof codexToolCallId;
+    codexToolName: typeof codexToolName;
+    codexToolOutput: typeof codexToolOutput;
+    codexToolTitle: typeof codexToolTitle;
+    isCodexToolItem: typeof isCodexToolItem;
+    normalizeCodexNotification: (msg: AnyRecord, providerSessionId?: unknown, state?: CodexNormalizerState | null) => ({
+        ts: number;
+        type: "text.delta";
+        text: string;
+        providerSessionId?: string | null | undefined;
+        raw?: {
+            source: string;
+            method?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+        streamKind?: "text" | undefined;
+    } | {
+        ts: number;
+        type: "text.boundary";
+        providerSessionId?: string | null | undefined;
+        raw?: {
+            source: string;
+            method?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+        streamKind?: "text" | undefined;
+        itemId?: string | undefined;
+        reason?: string | undefined;
+    } | {
+        ts: number;
+        type: "reasoning.delta";
+        text: string;
+        providerSessionId?: string | null | undefined;
+        raw?: {
+            source: string;
+            method?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+        streamKind?: "reasoning" | "plan" | undefined;
+    } | {
+        ts: number;
+        type: "tool.started";
+        toolCallId: string;
+        toolName: string;
+        input: Record<string, unknown>;
+        providerSessionId?: string | null | undefined;
+        raw?: {
+            source: string;
+            method?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+        name?: string | undefined;
+        kind?: "unknown" | "web_search" | "browser" | "file_read" | "file_write" | "file_edit" | "bash" | "subagent" | "mcp" | "question" | "todo" | "read" | "edit" | "delete" | "move" | "search" | "execute" | "think" | "fetch" | "switch_mode" | "other" | undefined;
+        title?: string | undefined;
+        detail?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        timing?: {
+            [x: string]: unknown;
+            startedAt?: string | number | undefined;
+            completedAt?: string | number | undefined;
+            elapsedMs?: number | undefined;
+        } | undefined;
+        data?: unknown;
+        itemType?: "tool" | undefined;
+    } | {
+        ts: number;
+        type: "tool.updated";
+        toolCallId: string;
+        providerSessionId?: string | null | undefined;
+        raw?: {
+            source: string;
+            method?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+        toolName?: string | undefined;
+        name?: string | undefined;
+        kind?: "unknown" | "web_search" | "browser" | "file_read" | "file_write" | "file_edit" | "bash" | "subagent" | "mcp" | "question" | "todo" | "read" | "edit" | "delete" | "move" | "search" | "execute" | "think" | "fetch" | "switch_mode" | "other" | undefined;
+        title?: string | undefined;
+        detail?: string | undefined;
+        inputDelta?: Record<string, unknown> | undefined;
+        outputDelta?: unknown;
+        output?: unknown;
+        error?: {
+            [x: string]: unknown;
+            message: string;
+            code?: string | undefined;
+            details?: unknown;
+        } | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        timing?: {
+            [x: string]: unknown;
+            startedAt?: string | number | undefined;
+            completedAt?: string | number | undefined;
+            elapsedMs?: number | undefined;
+        } | undefined;
+        data?: unknown;
+        status?: "error" | "in_progress" | "completed" | "failed" | undefined;
+        itemType?: "tool" | undefined;
+    } | {
+        ts: number;
+        type: "tool.completed";
+        toolCallId: string;
+        isError: boolean;
+        providerSessionId?: string | null | undefined;
+        raw?: {
+            source: string;
+            method?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+        toolName?: string | undefined;
+        name?: string | undefined;
+        kind?: "unknown" | "web_search" | "browser" | "file_read" | "file_write" | "file_edit" | "bash" | "subagent" | "mcp" | "question" | "todo" | "read" | "edit" | "delete" | "move" | "search" | "execute" | "think" | "fetch" | "switch_mode" | "other" | undefined;
+        title?: string | undefined;
+        detail?: string | undefined;
+        input?: Record<string, unknown> | undefined;
+        output?: unknown;
+        result?: unknown;
+        error?: {
+            [x: string]: unknown;
+            message: string;
+            code?: string | undefined;
+            details?: unknown;
+        } | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        timing?: {
+            [x: string]: unknown;
+            startedAt?: string | number | undefined;
+            completedAt?: string | number | undefined;
+            elapsedMs?: number | undefined;
+        } | undefined;
+        data?: unknown;
+        itemType?: "tool" | undefined;
+    } | {
+        ts: number;
+        type: "usage.final";
+        usage: {
+            tokenList: {
+                input: number;
+                output: number;
+                cacheRead: number;
+                cacheWrite: number;
+                thought: number;
+                total: number;
+            };
+            cumulativeTokenList: {
+                input: number;
+                output: number;
+                cacheRead: number;
+                cacheWrite: number;
+                thought: number;
+                total: number;
+            } | null;
+            previousCumulativeTokenList: {
+                input: number;
+                output: number;
+                cacheRead: number;
+                cacheWrite: number;
+                thought: number;
+                total: number;
+            } | null;
+            inputTokens: number;
+            outputTokens: number;
+            cacheReadTokens: number;
+            cacheWriteTokens: number;
+            thoughtTokens: number;
+            inputContextSize: number;
+            contextUsedTokens: number | null;
+            contextLimit: number | null;
+            usedTokens: number | null;
+            lastUsedTokens: number | null;
+            maxTokens: number | null;
+            totalProcessedTokens: number | null;
+            costUsd: number | null;
+            marketCostUsd: number | null;
+            operation: string;
+            billable: boolean;
+            source: string;
+            exact: boolean;
+        };
+        providerSessionId?: string | null | undefined;
+        raw?: {
+            source: string;
+            method?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+    } | {
+        ts: number;
+        type: "compaction.started";
+        trigger: "auto" | "manual" | "model_triggered";
+        providerSessionId?: string | null | undefined;
+        raw?: {
+            source: string;
+            method?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+    } | {
+        ts: number;
+        type: "compaction.finished";
+        trigger: "auto" | "manual" | "model_triggered";
+        providerSessionId?: string | null | undefined;
+        raw?: {
+            source: string;
+            method?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+        preTokens?: number | null | undefined;
+        postTokens?: number | null | undefined;
+        durationMs?: number | null | undefined;
+    } | {
+        ts: number;
+        type: "warning";
+        message: string;
+        providerSessionId?: string | null | undefined;
+        raw?: {
+            source: string;
+            method?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+        requestedModel?: string | undefined;
+    } | {
+        ts: number;
+        type: "error";
+        message: string;
+        providerSessionId?: string | null | undefined;
+        raw?: {
+            source: string;
+            method?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+    } | {
+        ts: number;
+        type: "done";
+        stopReason: string;
+        providerSessionId?: string | null | undefined;
+        raw?: {
+            source: string;
+            method?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+        usage?: {
+            tokenList: {
+                input: number;
+                output: number;
+                cacheRead: number;
+                cacheWrite: number;
+                thought: number;
+                total: number;
+            };
+            cumulativeTokenList: {
+                input: number;
+                output: number;
+                cacheRead: number;
+                cacheWrite: number;
+                thought: number;
+                total: number;
+            } | null;
+            previousCumulativeTokenList: {
+                input: number;
+                output: number;
+                cacheRead: number;
+                cacheWrite: number;
+                thought: number;
+                total: number;
+            } | null;
+            inputTokens: number;
+            outputTokens: number;
+            cacheReadTokens: number;
+            cacheWriteTokens: number;
+            thoughtTokens: number;
+            inputContextSize: number;
+            contextUsedTokens: number | null;
+            contextLimit: number | null;
+            usedTokens: number | null;
+            lastUsedTokens: number | null;
+            maxTokens: number | null;
+            totalProcessedTokens: number | null;
+            costUsd: number | null;
+            marketCostUsd: number | null;
+            operation: string;
+            billable: boolean;
+            source: string;
+            exact: boolean;
+        } | undefined;
+    })[];
+};
+/** The engine `chat-core/normalizers/codex.js` export set, closed over injected constructors. */
+export type CodexNormalizer = ReturnType<typeof createCodexNormalizer>;
+export {};
+//# sourceMappingURL=codex.d.ts.map

package/dist/normalizers/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/normalizers/codex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAA0C,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACtG,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnE,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAErC;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,wBAAwB,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5C,gCAAgC,CAAC,EAAE,MAAM,CAAC;IAC1C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAID,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,IAAI,GAAE,SAAc,GAAG,GAAG,CAEzD;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,IAAI,GAAE,SAAc,GAAG,OAAO,CAE7D;AAED,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,IAAI,GAAE,SAAc,GAAG,GAAG,CAOvD;AAED,sGAAsG;AACtG,wBAAgB,cAAc,CAAC,IAAI,GAAE,SAAc,GAAG,SAAS,CA6B9D;AAoBD,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,IAAI,GAAE,SAAc,GAAG,GAAG,CAKzD;AAED,6BAA6B;AAC7B,wBAAgB,cAAc,CAAC,IAAI,GAAE,SAAc,GAAG,eAAe,GAAG,SAAS,CAGhF;AAyBD,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,IAAI,GAAE,SAAc,GAAG,MAAM,CAS5D;AAED,+BAA+B;AAC/B,wBAAgB,cAAc,CAAC,IAAI,GAAE,SAAc,GAAG,MAAM,CAW3D;AAsED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAsB,GAAG,MAAM,CAcxF;AAiBD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB;;;;;;;;;;sCAIpB,SAAS,sBAAsB,OAAO,UAAU,oBAAoB,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4MrH;AAED,iGAAiG;AACjG,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC"}