@young1lin/dsh-gpt-sub 0.1.1 → 0.1.2

package/lib/native-bridge.d.ts

@@ -0,0 +1,87 @@
+/** Codex native compaction and checkpoint replay through resolved pi-ai requests. */
+import { Service, type Context } from '@deepseek-ai/cordis';
+import { type Message, type StreamChunk } from '@deepseek-ai/dsh-llm';
+import { normalizeContext } from '@earendil-works/pi-ai/utils/transcript';
+import { convertResponsesMessages } from '@earendil-works/pi-ai/api/openai-responses-shared';
+import type { ModelThinkingLevel } from '@earendil-works/pi-ai';
+/** Native compaction request bounds configured by the plugin. */
+export interface NativeBridgeConfig {
+    nativeCompactionTimeoutMs: number;
+    nativeRetainTokens: number;
+    nativeResponseMaxBytes: number;
+}
+/** Options the pi-ai SDK accepts for one native request stream. */
+export interface PiAiNativeStreamOptions {
+    apiKey?: string;
+    reasoning?: ModelThinkingLevel;
+    maxRetries?: number;
+    signal?: AbortSignal;
+    headers?: Record<string, string | null | undefined>;
+    transport?: string;
+    fetch?: typeof fetch;
+    onPayload?: (payload: unknown, model: unknown) => unknown | Promise<unknown>;
+}
+/**
+ * Native request the llm-pi-ai/stream extension hands to listeners.
+ * Mirrors the extension's own shape; declared locally so this plugin also
+ * typechecks against adapters that do not ship the extension yet.
+ */
+export interface PiAiNativeRequest {
+    options: {
+        provider: string;
+        model: string;
+        purpose?: string;
+        messages: Message[];
+        sessionId?: string | number;
+        reasoningEffort?: string;
+    };
+    model: Parameters<typeof convertResponsesMessages>[0];
+    context: Parameters<typeof normalizeContext>[0];
+    streamOptions: PiAiNativeStreamOptions;
+    stream: (options: PiAiNativeStreamOptions) => AsyncIterable<StreamChunk>;
+}
+/** Whether the host's llm-pi-ai adapter emits native requests through the stream extension. */
+export declare function hasPiAiNativeStream(): boolean;
+/** Listener for one native request; call next() to defer to the SDK dispatch. */
+export type PiAiNativeStreamListener = (request: PiAiNativeRequest, next: () => AsyncIterable<StreamChunk>) => AsyncIterable<StreamChunk>;
+/**
+ * Register a native stream listener. The event key is provided by the
+ * extension's typings when present; typed loosely here so registration also
+ * compiles — and stays dormant — where the extension is absent.
+ */
+export declare function onPiAiNativeStream(ctx: Context, listener: PiAiNativeStreamListener): () => boolean;
+/** Drive one native request through the registered listeners, as the extension does. */
+export declare function waterfallPiAiNativeStream(ctx: Context, request: PiAiNativeRequest, next: () => AsyncIterable<StreamChunk>): AsyncIterable<StreamChunk>;
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        gptSubNative: CodexNativeBridge;
+    }
+}
+/**
+ * Expand persisted checkpoints immediately before the SDK sends its payload.
+ * @param request - prepared pi-ai request.
+ * @param payload - provider-native request body.
+ * @returns body with native checkpoint items restored.
+ */
+export declare function replayPayload(request: PiAiNativeRequest, payload: unknown): unknown;
+/**
+ * Resolve the Responses endpoint from the captured model descriptor.
+ * @param baseUrl - configured native model endpoint.
+ * @returns Codex Responses URL.
+ */
+export declare function codexResponsesUrl(baseUrl: string): string;
+/** Plugin-owned native request execution, cancelled before its proxy is closed. */
+export declare class CodexNativeBridge extends Service {
+    private readonly config;
+    private readonly fetchImpl;
+    private readonly stopping;
+    private readonly active;
+    constructor(ctx: Context, config: NativeBridgeConfig, fetchImpl?: typeof fetch);
+    /**
+     * Abort and await all native compaction requests before transport teardown.
+     * @returns completion of every active request.
+     */
+    stop(): Promise<void>;
+    private compact;
+}
+//# sourceMappingURL=native-bridge.d.ts.map

package/lib/native-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-bridge.d.ts","sourceRoot":"","sources":["../src/native-bridge.ts"],"names":[],"mappings":"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"}

package/lib/native-bridge.js

@@ -0,0 +1,251 @@
+/** Codex native compaction and checkpoint replay through resolved pi-ai requests. */
+import { Service } from '@deepseek-ai/cordis';
+import { LlmError } from '@deepseek-ai/dsh-llm';
+import * as PiAi from '@deepseek-ai/dsh-llm-pi-ai';
+import { normalizeContext } from '@earendil-works/pi-ai/utils/transcript';
+import { convertResponsesMessages, convertResponsesTools } from '@earendil-works/pi-ai/api/openai-responses-shared';
+import { createParser } from 'eventsource-parser';
+import { z } from 'zod';
+import { expandCheckpoints, nativeItemsSchema, readCheckpoint, retainUserItems, } from "./native-history.js";
+/**
+ * Event name published by the llm-pi-ai/stream extension. Falls back to the
+ * wire name so the plugin loads — inert — on hosts whose adapter does not
+ * emit it yet; nothing fires and ordinary SDK dispatch is unchanged.
+ */
+const PI_AI_NATIVE_STREAM_EVENT = PiAi.PI_AI_NATIVE_STREAM_EVENT ?? 'llm-pi-ai/stream';
+/** Whether the host's llm-pi-ai adapter emits native requests through the stream extension. */
+export function hasPiAiNativeStream() {
+    return PiAi.PI_AI_NATIVE_STREAM_EVENT !== undefined;
+}
+/**
+ * Register a native stream listener. The event key is provided by the
+ * extension's typings when present; typed loosely here so registration also
+ * compiles — and stays dormant — where the extension is absent.
+ */
+export function onPiAiNativeStream(ctx, listener) {
+    return ctx.on(PI_AI_NATIVE_STREAM_EVENT, listener);
+}
+/** Drive one native request through the registered listeners, as the extension does. */
+export function waterfallPiAiNativeStream(ctx, request, next) {
+    return ctx.waterfall(PI_AI_NATIVE_STREAM_EVENT, request, next);
+}
+const jsonObject = z.record(z.string(), z.unknown());
+const claimsSchema = z.object({
+    'https://api.openai.com/auth': z.object({ chatgpt_account_id: z.string().min(1) }),
+});
+const usageSchema = z.object({
+    input_tokens: z.number().int().nonnegative(),
+    output_tokens: z.number().int().nonnegative(),
+    input_tokens_details: z.object({ cached_tokens: z.number().int().nonnegative().optional() }).optional(),
+});
+/**
+ * Expand persisted checkpoints immediately before the SDK sends its payload.
+ * @param request - prepared pi-ai request.
+ * @param payload - provider-native request body.
+ * @returns body with native checkpoint items restored.
+ */
+export function replayPayload(request, payload) {
+    const body = jsonObject.parse(payload);
+    const input = nativeItemsSchema.parse(body['input']);
+    return { ...body, input: expandCheckpoints(input, request.options.messages, request.options.provider, request.options.model) };
+}
+/**
+ * Resolve the Responses endpoint from the captured model descriptor.
+ * @param baseUrl - configured native model endpoint.
+ * @returns Codex Responses URL.
+ */
+export function codexResponsesUrl(baseUrl) {
+    const base = baseUrl.replace(/\/+$/, '');
+    if (base.endsWith('/codex/responses'))
+        return base;
+    if (base.endsWith('/codex'))
+        return `${base}/responses`;
+    return `${base}/codex/responses`;
+}
+/** Plugin-owned native request execution, cancelled before its proxy is closed. */
+export class CodexNativeBridge extends Service {
+    config;
+    fetchImpl;
+    stopping = new AbortController();
+    active = new Set();
+    constructor(ctx, config, fetchImpl = fetch) {
+        super(ctx, 'gptSubNative');
+        this.config = config;
+        this.fetchImpl = fetchImpl;
+        onPiAiNativeStream(ctx, (request, next) => {
+            if (request.options.provider !== 'openai-codex')
+                return next();
+            if (request.model.api !== 'openai-codex-responses') {
+                throw new LlmError('Codex native compaction requires the openai-codex-responses protocol', 'INVALID_CONFIG');
+            }
+            if (request.options.purpose === 'compaction')
+                return this.compact(request);
+            const checkpoints = request.options.messages.some(message => 'source' in message && readCheckpoint(message.source) !== undefined);
+            if (!checkpoints)
+                return next();
+            return request.stream({
+                ...request.streamOptions,
+                onPayload: payload => replayPayload(request, payload),
+            });
+        });
+        ctx.on('llm/stream', (options, next) => {
+            for (const message of options.messages) {
+                if (!('source' in message))
+                    continue;
+                const checkpoint = readCheckpoint(message.source);
+                if (checkpoint !== undefined && (checkpoint.provider !== options.provider || checkpoint.model !== options.model)) {
+                    throw new LlmError(`This Session contains a Codex checkpoint for ${checkpoint.model}; use the same model or start a new Session`, 'UNSUPPORTED_CONTENT');
+                }
+            }
+            return next();
+        });
+    }
+    /**
+     * Abort and await all native compaction requests before transport teardown.
+     * @returns completion of every active request.
+     */
+    async stop() {
+        this.stopping.abort(new Error('Codex subscription plugin unloaded'));
+        await Promise.all(this.active);
+    }
+    async *compact(request) {
+        let settle = () => undefined;
+        const done = new Promise(resolve => { settle = resolve; });
+        this.active.add(done);
+        const signal = AbortSignal.any([
+            this.stopping.signal,
+            AbortSignal.timeout(this.config.nativeCompactionTimeoutMs),
+            ...request.streamOptions.signal === undefined ? [] : [request.streamOptions.signal],
+        ]);
+        let reader;
+        try {
+            signal.throwIfAborted();
+            const token = request.streamOptions.apiKey;
+            if (token === undefined)
+                throw new LlmError('Codex native compaction requires a resolved subscription token', 'MISSING_CREDENTIAL');
+            const payloadPart = token.split('.')[1];
+            if (payloadPart === undefined)
+                throw new LlmError('Codex subscription token is not a JWT', 'MISSING_CREDENTIAL');
+            const account = claimsSchema.parse(JSON.parse(Buffer.from(payloadPart, 'base64url').toString('utf8')));
+            const serialized = convertResponsesMessages(request.model, normalizeContext(request.context), new Set(['openai', 'openai-codex', 'azure-openai-responses']), {
+                includeSystemPrompt: false,
+            });
+            const input = expandCheckpoints(nativeItemsSchema.parse(JSON.parse(JSON.stringify(serialized))), request.options.messages, request.options.provider, request.options.model);
+            const body = {
+                model: request.model.id,
+                store: false,
+                stream: true,
+                instructions: request.context.systemPrompt ?? '',
+                input: [...input, { type: 'compaction_trigger' }],
+                parallel_tool_calls: true,
+                include: ['reasoning.encrypted_content'],
+                ...request.options.sessionId === undefined ? {} : { prompt_cache_key: String(request.options.sessionId) },
+            };
+            if (request.context.tools !== undefined)
+                body['tools'] = convertResponsesTools(request.context.tools, { strict: null });
+            const reasoning = request.streamOptions.reasoning;
+            if (reasoning !== undefined) {
+                const effort = request.model.thinkingLevelMap?.[reasoning] ?? reasoning;
+                body['reasoning'] = { effort, summary: 'auto' };
+            }
+            const headers = new Headers();
+            for (const [name, value] of Object.entries({ ...request.model.headers, ...request.streamOptions.headers })) {
+                if (value !== null && value !== undefined)
+                    headers.set(name, value);
+            }
+            headers.set('authorization', `Bearer ${token}`);
+            headers.set('chatgpt-account-id', account['https://api.openai.com/auth'].chatgpt_account_id);
+            headers.set('originator', 'codex_cli_rs');
+            headers.set('OpenAI-Beta', 'responses=experimental');
+            headers.set('content-type', 'application/json');
+            headers.set('accept', 'text/event-stream');
+            if (request.options.sessionId !== undefined)
+                headers.set('session-id', String(request.options.sessionId));
+            const response = await this.fetchImpl(codexResponsesUrl(request.model.baseUrl), {
+                method: 'POST', headers, body: JSON.stringify(body), signal,
+            });
+            if (!response.ok)
+                throw new LlmError(`Codex native compaction HTTP ${response.status}: ${await response.text()}`, 'CODEX_COMPACTION_HTTP_ERROR');
+            if (response.body === null)
+                throw new LlmError('Codex native compaction returned no response stream', 'STREAM_CLOSED');
+            reader = response.body.getReader();
+            const events = [];
+            let parseError;
+            const parser = createParser({ onEvent: event => events.push(event.data), onError: error => { parseError = error; } });
+            const decoder = new TextDecoder();
+            let receivedBytes = 0;
+            let compaction;
+            let compactionCount = 0;
+            let completed;
+            while (completed === undefined) {
+                const chunk = await reader.read();
+                if (chunk.done) {
+                    parser.feed(decoder.decode());
+                    if (events.length === 0)
+                        throw new LlmError('Codex compaction stream closed before response.completed', 'STREAM_CLOSED');
+                }
+                else {
+                    receivedBytes += chunk.value.byteLength;
+                    if (receivedBytes > this.config.nativeResponseMaxBytes)
+                        throw new LlmError('Codex compaction response exceeded nativeResponseMaxBytes', 'CODEX_COMPACTION_RESPONSE_LIMIT');
+                    parser.feed(decoder.decode(chunk.value, { stream: true }));
+                }
+                if (parseError !== undefined)
+                    throw parseError;
+                for (const data of events.splice(0)) {
+                    if (data === '[DONE]')
+                        continue;
+                    const event = jsonObject.parse(JSON.parse(data));
+                    if (event['type'] === 'response.output_item.done') {
+                        const item = nativeItemsSchema.element.parse(event['item']);
+                        if (item['type'] === 'compaction') {
+                            compaction = item;
+                            compactionCount += 1;
+                        }
+                    }
+                    else if (event['type'] === 'response.completed')
+                        completed = jsonObject.parse(event['response']);
+                    else if (event['type'] === 'error' || event['type'] === 'response.failed' || event['type'] === 'response.incomplete') {
+                        throw new LlmError(`Codex native compaction failed: ${data}`, 'CODEX_COMPACTION_ERROR');
+                    }
+                }
+                signal.throwIfAborted();
+                if (chunk.done && completed === undefined)
+                    throw new LlmError('Codex compaction stream closed before response.completed', 'STREAM_CLOSED');
+            }
+            if (compactionCount !== 1 || compaction === undefined || typeof compaction['encrypted_content'] !== 'string' || compaction['encrypted_content'].length === 0) {
+                throw new LlmError(`Codex native compaction expected one encrypted compaction item, received ${compactionCount}`, 'INVALID_REPLAY_STATE');
+            }
+            const responseId = z.string().min(1).parse(completed['id']);
+            const usage = usageSchema.parse(completed['usage']);
+            const cached = usage.input_tokens_details?.cached_tokens ?? 0;
+            const tokenUsage = {
+                inputTokens: Math.max(0, usage.input_tokens - cached),
+                outputTokens: usage.output_tokens,
+                cacheReadTokens: cached,
+                totalTokens: usage.input_tokens + usage.output_tokens,
+            };
+            yield {
+                type: 'block-end', index: 0,
+                block: {
+                    type: 'codex-compaction-result', item: compaction, responseId,
+                    summaryTokens: usage.output_tokens,
+                    retained: retainUserItems(input, this.config.nativeRetainTokens),
+                },
+            };
+            yield { type: 'usage', usage: tokenUsage };
+            yield { type: 'finish', reason: { kind: 'stop' } };
+        }
+        finally {
+            try {
+                await reader?.cancel();
+            }
+            finally {
+                reader?.releaseLock();
+                this.active.delete(done);
+                settle();
+            }
+        }
+    }
+}
+//# sourceMappingURL=native-bridge.js.map

package/lib/native-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-bridge.js","sourceRoot":"","sources":["../src/native-bridge.ts"],"names":[],"mappings":"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"}

package/lib/native-history.d.ts

@@ -0,0 +1,70 @@
+/** Persisted Codex compaction windows and their Responses input projection. */
+import type { ContentBlock, MessageSource, RequestMessage } from '@deepseek-ai/dsh-llm';
+import type { CompactionCheckpointSource } from '@deepseek-ai/dsh-compaction/checkpoint';
+import { z } from 'zod';
+/** Lossless JSON validation for provider-native Responses items. */
+export declare const nativeItemsSchema: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+/** One lossless provider-native Responses input item. */
+export type NativeItem = z.infer<typeof nativeItemsSchema>[number];
+declare const checkpointSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    provider: z.ZodLiteral<"openai-codex">;
+    model: z.ZodString;
+    items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    contextTokens: z.ZodNumber;
+}, z.core.$strip>;
+/** Native window carried by a persisted replacement message. */
+export type CodexCheckpoint = z.infer<typeof checkpointSchema>;
+/** Backend-independent checkpoint identity with plugin-owned native state. */
+export type CodexCheckpointSource = CompactionCheckpointSource & {
+    readonly nativeCodex: CodexCheckpoint;
+};
+/** Completed native compaction output and the retained user messages. */
+export interface NativeCompactionResultBlock {
+    type: 'codex-compaction-result';
+    item: NativeItem;
+    retained: NativeItem[];
+    responseId: string;
+    summaryTokens: number;
+}
+declare module '@deepseek-ai/dsh-llm' {
+    interface ContentBlockMap {
+        'codex-compaction-result': NativeCompactionResultBlock;
+    }
+}
+/**
+ * Validate plugin state restored with one checkpoint source.
+ * @param source - source of the durable message.
+ * @returns native state, or undefined for other producers.
+ */
+export declare function readCheckpoint(source: MessageSource): CodexCheckpoint | undefined;
+/**
+ * Replace logged checkpoint markers with their exact native items.
+ * @param input - serialized Responses input.
+ * @param messages - durable history that produced the input.
+ * @param provider - captured provider route.
+ * @param model - captured model id.
+ * @returns input with each checkpoint expanded once, preserving order.
+ */
+export declare function expandCheckpoints(input: readonly NativeItem[], messages: readonly RequestMessage[], provider: string, model: string): NativeItem[];
+/**
+ * Retain recent user items within a structural token budget.
+ * @param input - expanded native history sent for compaction.
+ * @param budget - maximum estimated tokens retained verbatim.
+ * @returns recent user items in conversation order.
+ */
+export declare function retainUserItems(input: readonly NativeItem[], budget: number): NativeItem[];
+/**
+ * Estimate a plaintext native item's serialized token cost.
+ * @param item - retained user item, excluding encrypted compaction state.
+ * @returns conservative structural token estimate.
+ */
+export declare function nativeItemTokens(item: NativeItem): number;
+/**
+ * Read the completed compaction block assembled from the auxiliary stream.
+ * @param blocks - complete auxiliary output.
+ * @returns the unique native compaction result.
+ */
+export declare function nativeResult(blocks: readonly ContentBlock[]): NativeCompactionResultBlock;
+export {};
+//# sourceMappingURL=native-history.d.ts.map

package/lib/native-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-history.d.ts","sourceRoot":"","sources":["../src/native-history.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACvF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAA;AACxF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,uDAA0C,CAAA;AACxE,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAClE,QAAA,MAAM,gBAAgB;;;;;;iBAMpB,CAAA;AAEF,gEAAgE;AAChE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE9D,8EAA8E;AAC9E,MAAM,MAAM,qBAAqB,GAAG,0BAA0B,GAAG;IAAE,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAA;CAAE,CAAA;AAE1G,yEAAyE;AACzE,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,yBAAyB,CAAA;IAC/B,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,UAAU,EAAE,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,eAAe;QACvB,yBAAyB,EAAE,2BAA2B,CAAA;KACvD;CACF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,eAAe,GAAG,SAAS,CAYjF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,QAAQ,EAAE,SAAS,cAAc,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GACjG,UAAU,EAAE,CA+Bd;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,CAW1F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,2BAA2B,CAMzF"}

package/lib/native-history.js

@@ -0,0 +1,120 @@
+import { z } from 'zod';
+/** Lossless JSON validation for provider-native Responses items. */
+export const nativeItemsSchema = z.array(z.record(z.string(), z.json()));
+const checkpointSchema = z.object({
+    version: z.literal(1),
+    provider: z.literal('openai-codex'),
+    model: z.string().min(1),
+    items: nativeItemsSchema.min(1),
+    contextTokens: z.number().int().nonnegative(),
+});
+/**
+ * Validate plugin state restored with one checkpoint source.
+ * @param source - source of the durable message.
+ * @returns native state, or undefined for other producers.
+ */
+export function readCheckpoint(source) {
+    if (!('nativeCodex' in source))
+        return undefined;
+    if (source.kind !== 'compact-checkpoint')
+        throw new Error('Codex native state requires a compaction checkpoint');
+    const state = checkpointSchema.parse(source.nativeCodex);
+    if (state.items.filter(item => item['type'] === 'compaction').length !== 1) {
+        throw new Error('Codex checkpoint must contain exactly one compaction item');
+    }
+    const item = state.items.find(value => value['type'] === 'compaction');
+    if (typeof item?.['encrypted_content'] !== 'string' || item['encrypted_content'].length === 0) {
+        throw new Error('Codex checkpoint is missing encrypted_content');
+    }
+    return state;
+}
+/**
+ * Replace logged checkpoint markers with their exact native items.
+ * @param input - serialized Responses input.
+ * @param messages - durable history that produced the input.
+ * @param provider - captured provider route.
+ * @param model - captured model id.
+ * @returns input with each checkpoint expanded once, preserving order.
+ */
+export function expandCheckpoints(input, messages, provider, model) {
+    const checkpoints = new Map();
+    for (const message of messages) {
+        if (!('source' in message))
+            continue;
+        const state = readCheckpoint(message.source);
+        if (state === undefined)
+            continue;
+        if (state.provider !== provider || state.model !== model) {
+            throw new Error(`Codex checkpoint belongs to ${state.provider}/${state.model}; start a new Session to use ${provider}/${model}`);
+        }
+        const marker = message.content.filter(block => block.type === 'text').map(block => block.text).join('');
+        if (marker.length === 0 || checkpoints.has(marker))
+            throw new Error('invalid Codex checkpoint marker');
+        checkpoints.set(marker, state);
+    }
+    if (checkpoints.size === 0)
+        return [...input];
+    const remaining = new Set(checkpoints.keys());
+    const output = [];
+    for (const item of input) {
+        const content = item['content'];
+        const text = item['role'] === 'user' && Array.isArray(content)
+            ? content.map(value => typeof value === 'object' && value !== null && !Array.isArray(value)
+                && value['type'] === 'input_text' && typeof value['text'] === 'string' ? value['text'] : '').join('')
+            : '';
+        const checkpoint = checkpoints.get(text);
+        if (checkpoint === undefined)
+            output.push(item);
+        else {
+            if (!remaining.delete(text))
+                throw new Error('Codex checkpoint marker was serialized more than once');
+            output.push(...checkpoint.items);
+        }
+    }
+    if (remaining.size > 0)
+        throw new Error('Codex checkpoint marker was lost during request conversion');
+    return output;
+}
+/**
+ * Retain recent user items within a structural token budget.
+ * @param input - expanded native history sent for compaction.
+ * @param budget - maximum estimated tokens retained verbatim.
+ * @returns recent user items in conversation order.
+ */
+export function retainUserItems(input, budget) {
+    const retained = [];
+    let remaining = budget;
+    for (const item of [...input].reverse()) {
+        if (item['role'] !== 'user' || (item['type'] !== undefined && item['type'] !== 'message'))
+            continue;
+        const price = nativeItemTokens(item);
+        if (price > remaining)
+            break;
+        retained.push(item);
+        remaining -= price;
+    }
+    return retained.reverse();
+}
+/**
+ * Estimate a plaintext native item's serialized token cost.
+ * @param item - retained user item, excluding encrypted compaction state.
+ * @returns conservative structural token estimate.
+ */
+export function nativeItemTokens(item) {
+    return Math.ceil(JSON.stringify(item).length / 4) + 4;
+}
+/**
+ * Read the completed compaction block assembled from the auxiliary stream.
+ * @param blocks - complete auxiliary output.
+ * @returns the unique native compaction result.
+ */
+export function nativeResult(blocks) {
+    const results = blocks.filter(block => block.type === 'codex-compaction-result');
+    if (results.length !== 1)
+        throw new Error('native Codex compaction did not return exactly one result');
+    const result = results[0];
+    if (result === undefined)
+        throw new Error('native Codex compaction result is missing');
+    return result;
+}
+//# sourceMappingURL=native-history.js.map

package/lib/native-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-history.js","sourceRoot":"","sources":["../src/native-history.ts"],"names":[],"mappings":"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"}

package/lib/types.d.ts

@@ -14,5 +14,11 @@ export interface Config {
     bootstrapRetries: number;
     /** Where the panel's runtime overrides (proxy, credential file) are persisted. */
     stateFile: string;
+    /** Total timeout for a native Codex compaction request. */
+    nativeCompactionTimeoutMs: number;
+    /** Recent user-message budget retained alongside the encrypted summary. */
+    nativeRetainTokens: number;
+    /** Maximum streamed bytes accepted from one native compaction response. */
+    nativeResponseMaxBytes: number;
 }
 //# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,WAAW,MAAM;IACrB,iGAAiG;IACjG,QAAQ,EAAE,MAAM,CAAA;IAChB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAA;IAChB,wEAAwE;IACxE,oBAAoB,EAAE,MAAM,CAAA;IAC5B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAA;IAChB,wEAAwE;IACxE,mBAAmB,EAAE,MAAM,CAAA;IAC3B,+EAA+E;IAC/E,gBAAgB,EAAE,MAAM,CAAA;IACxB,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAA;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,WAAW,MAAM;IACrB,iGAAiG;IACjG,QAAQ,EAAE,MAAM,CAAA;IAChB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAA;IAChB,wEAAwE;IACxE,oBAAoB,EAAE,MAAM,CAAA;IAC5B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAA;IAChB,wEAAwE;IACxE,mBAAmB,EAAE,MAAM,CAAA;IAC3B,+EAA+E;IAC/E,gBAAgB,EAAE,MAAM,CAAA;IACxB,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAA;IACjB,2DAA2D;IAC3D,yBAAyB,EAAE,MAAM,CAAA;IACjC,2EAA2E;IAC3E,kBAAkB,EAAE,MAAM,CAAA;IAC1B,2EAA2E;IAC3E,sBAAsB,EAAE,MAAM,CAAA;CAC/B"}