@qduc/term2 0.11.1 → 0.13.0

package/dist/providers/openai-request-prefix-binding.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Request preparation sees canonical application input, while the private
+ * Responses builder records the provider-shaped request input. For the one
+ * representation change this scope can establish without guessing, normalize
+ * an input message wrapper to its equivalent Responses message. Everything
+ * else is left exact.
+ */
+/**
+ * Provider-private, observational handoff between application input
+ * preparation and the inherited transport's final request builder. Nothing
+ * here is sent on the wire.
+ */
+export type OpenAIRequestPrefixBinding = Readonly<{
+    snapshotIdentity: string;
+    snapshotRevision: number;
+    /** Captured while planning the request; never read from live session state. */
+    lineage: number;
+}>;
+export type OpenAIRequestPrefixBindingOutcome = 'not_prepared' | 'already_consumed' | 'input_mismatch';
+export type OpenAIRequestPrefixBindingConsumption = Readonly<{
+    binding?: OpenAIRequestPrefixBinding;
+    outcome?: OpenAIRequestPrefixBindingOutcome;
+}>;
+export declare const runWithOpenAIRequestPrefixBindingScope: <T>(run: () => Promise<T>) => Promise<T>;
+export declare const prepareOpenAIRequestPrefixBinding: (binding: OpenAIRequestPrefixBinding, expectedInput: unknown) => void;
+export declare const consumeOpenAIRequestPrefixBinding: (input: unknown) => OpenAIRequestPrefixBinding | undefined;
+export declare const consumeOpenAIRequestPrefixBindingWithOutcome: (input: unknown) => OpenAIRequestPrefixBindingConsumption;
+//# sourceMappingURL=openai-request-prefix-binding.d.ts.map

package/dist/providers/openai-request-prefix-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-request-prefix-binding.d.ts","sourceRoot":"","sources":["../../source/providers/openai-request-prefix-binding.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEH,MAAM,MAAM,iCAAiC,GAAG,cAAc,GAAG,kBAAkB,GAAG,gBAAgB,CAAC;AAEvG,MAAM,MAAM,qCAAqC,GAAG,QAAQ,CAAC;IAC3D,OAAO,CAAC,EAAE,0BAA0B,CAAC;IACrC,OAAO,CAAC,EAAE,iCAAiC,CAAC;CAC7C,CAAC,CAAC;AAwDH,eAAO,MAAM,sCAAsC,GAAI,CAAC,OAAO,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAC7B,CAAC;AAE/D,eAAO,MAAM,iCAAiC,YACnC,0BAA0B,iBACpB,OAAO,KACrB,IAMF,CAAC;AAEF,eAAO,MAAM,iCAAiC,UAAW,OAAO,KAAG,0BAA0B,GAAG,SAE/F,CAAC;AAEF,eAAO,MAAM,4CAA4C,UAAW,OAAO,KAAG,qCAQ7E,CAAC"}

package/dist/providers/openai-request-prefix-binding.js

@@ -0,0 +1,78 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { isDeepStrictEqual } from 'node:util';
+class OpenAIRequestPrefixBindingScope {
+    #prepared;
+    #ambiguous = false;
+    #consumed = false;
+    prepare(binding, expectedInput) {
+        if (this.#ambiguous)
+            return;
+        if (this.#prepared) {
+            // A scope does not have an invocation identity. Once two preparations
+            // overlap, input contents cannot establish which builder caused either.
+            this.#prepared = undefined;
+            this.#ambiguous = true;
+            return;
+        }
+        try {
+            this.#prepared = {
+                binding: Object.freeze({ ...binding }),
+                // Input equality can reject a mismatched builder, but cannot establish
+                // causality between two independently prepared invocations.
+                expectedInput: structuredClone(expectedInput),
+            };
+        }
+        catch {
+            // Instrumentation is fail-closed and must never alter a model call.
+            this.#prepared = undefined;
+        }
+    }
+    consume(input) {
+        try {
+            if (this.#ambiguous) {
+                // One consume retires the ambiguous overlap, leaving both invocations
+                // unbound rather than allowing stale evidence to bind a later build.
+                this.#ambiguous = false;
+                this.#consumed = true;
+                return { outcome: 'already_consumed' };
+            }
+            const prepared = this.#prepared;
+            this.#prepared = undefined;
+            const wasConsumed = this.#consumed;
+            this.#consumed = true;
+            if (!prepared)
+                return { outcome: wasConsumed ? 'already_consumed' : 'not_prepared' };
+            return isDeepStrictEqual(prepared.expectedInput, input)
+                ? { binding: prepared.binding }
+                : { outcome: 'input_mismatch' };
+        }
+        catch {
+            return { outcome: 'input_mismatch' };
+        }
+    }
+}
+const scopeStorage = new AsyncLocalStorage();
+export const runWithOpenAIRequestPrefixBindingScope = (run) => scopeStorage.run(new OpenAIRequestPrefixBindingScope(), run);
+export const prepareOpenAIRequestPrefixBinding = (binding, expectedInput) => {
+    try {
+        scopeStorage.getStore()?.prepare(binding, expectedInput);
+    }
+    catch {
+        // AsyncLocalStorage/instrumentation failure is observational only.
+    }
+};
+export const consumeOpenAIRequestPrefixBinding = (input) => {
+    return consumeOpenAIRequestPrefixBindingWithOutcome(input).binding;
+};
+export const consumeOpenAIRequestPrefixBindingWithOutcome = (input) => {
+    try {
+        const scope = scopeStorage.getStore();
+        if (!scope)
+            return { outcome: 'not_prepared' };
+        return scope.consume(input);
+    }
+    catch {
+        return { outcome: 'input_mismatch' };
+    }
+};
+//# sourceMappingURL=openai-request-prefix-binding.js.map

package/dist/providers/openai-request-prefix-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-request-prefix-binding.js","sourceRoot":"","sources":["../../source/providers/openai-request-prefix-binding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AA4B9C,MAAM,+BAA+B;IACnC,SAAS,CAA8E;IACvF,UAAU,GAAG,KAAK,CAAC;IACnB,SAAS,GAAG,KAAK,CAAC;IAElB,OAAO,CAAC,OAAmC,EAAE,aAAsB;QACjE,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO;QAC5B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,sEAAsE;YACtE,wEAAwE;YACxE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;YAC3B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,SAAS,GAAG;gBACf,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;gBACtC,uEAAuE;gBACvE,4DAA4D;gBAC5D,aAAa,EAAE,eAAe,CAAC,aAAa,CAAC;aAC9C,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;YACpE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,CAAC,KAAc;QACpB,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,sEAAsE;gBACtE,qEAAqE;gBACrE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;gBACxB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;gBACtB,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;YACzC,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;YAChC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;YAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC;YACnC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,IAAI,CAAC,QAAQ;gBAAE,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC;YACrF,OAAO,iBAAiB,CAAC,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC;gBACrD,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE;gBAC/B,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;CACF;AAED,MAAM,YAAY,GAAG,IAAI,iBAAiB,EAAmC,CAAC;AAE9E,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAI,GAAqB,EAAc,EAAE,CAC7F,YAAY,CAAC,GAAG,CAAC,IAAI,+BAA+B,EAAE,EAAE,GAAG,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAC/C,OAAmC,EACnC,aAAsB,EAChB,EAAE;IACR,IAAI,CAAC;QACH,YAAY,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,KAAc,EAA0C,EAAE;IAC1G,OAAO,4CAA4C,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AACrE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,4CAA4C,GAAG,CAAC,KAAc,EAAyC,EAAE;IACpH,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;QAC/C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC;IACvC,CAAC;AACH,CAAC,CAAC"}

package/dist/providers/openai-responses-model.d.ts

@@ -0,0 +1,43 @@
+import type { StreamedModelTurn, StreamedModelTurnEvent, StreamedModelTurnRequest, ContextCompactionSessionState } from '../contracts/streamed-model-turn.js';
+import type { ProviderRequestCapture } from './provider-request-capture.js';
+declare class Lifecycle {
+    #private;
+    begin(request: StreamedModelTurnRequest, transport: 'http' | 'websocket', model: string, client: any): void;
+    bind(request: StreamedModelTurnRequest, capture?: ProviderRequestCapture): void;
+    finish(request: StreamedModelTurnRequest, phase: 'terminal' | 'failed' | 'abandoned', capture?: ProviderRequestCapture, responseId?: string): void;
+}
+export type ContextCompactionFailureCategory = 'request' | 'validation';
+export declare function contextCompactionFailureCategory(error: unknown): ContextCompactionFailureCategory | undefined;
+/** State needed to turn provider tool-argument fragments into UI progress events. */
+export interface ResponseEventNormalizationState {
+    toolNamesByIndex: Map<number | string, string>;
+    toolArgumentLengthsByIndex: Map<number | string, number>;
+    /** Reasoning items already surfaced so a full-text summary part is not re-emitted. */
+    reasoningEmittedItemIds: Set<string>;
+    /**
+     * Wall-clock start of each in-flight compaction item, keyed by output index.
+     * The elapsed time between the provider's `added` and `done` frames is the only
+     * real measurement of how long compaction took; nothing downstream can recover it.
+     */
+    compactionStartedAtByIndex: Map<number | string, number>;
+}
+export declare function createResponseEventNormalizationState(): ResponseEventNormalizationState;
+/** Convert one native OpenAI Responses event to the application turn protocol. */
+export declare function normalizeResponseEvent(event: any, state?: ResponseEventNormalizationState): StreamedModelTurnEvent | null;
+export declare class OpenAIResponsesModelWithPromptCacheKey implements StreamedModelTurn {
+    #private;
+    protected readonly lifecycle: Lifecycle;
+    protected readonly _client: any;
+    protected readonly _model: string;
+    protected readonly capture?: ProviderRequestCapture;
+    protected readonly supportsContextCompaction: boolean;
+    protected readonly contextCompactionSessionState?: ContextCompactionSessionState;
+    constructor(_client: any, _model: string, capture?: ProviderRequestCapture, supportsContextCompaction?: boolean, contextCompactionSessionState?: ContextCompactionSessionState);
+    getResponse(request: StreamedModelTurnRequest): Promise<any>;
+    stream(request: StreamedModelTurnRequest): AsyncIterable<StreamedModelTurnEvent>;
+}
+export declare class OpenAIResponsesWSModelWithPromptCacheKey extends OpenAIResponsesModelWithPromptCacheKey {
+    stream(request: StreamedModelTurnRequest): AsyncIterable<StreamedModelTurnEvent>;
+}
+export {};
+//# sourceMappingURL=openai-responses-model.d.ts.map

package/dist/providers/openai-responses-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-responses-model.d.ts","sourceRoot":"","sources":["../../source/providers/openai-responses-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EAGtB,wBAAwB,EAGxB,6BAA6B,EAC9B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAc5E,cAAM,SAAS;;IAGb,KAAK,CAAC,OAAO,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI,CAS1G;IAED,IAAI,CAAC,OAAO,EAAE,wBAAwB,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAY9E;IAED,MAAM,CACJ,OAAO,EAAE,wBAAwB,EACjC,KAAK,EAAE,UAAU,GAAG,QAAQ,GAAG,WAAW,EAC1C,OAAO,CAAC,EAAE,sBAAsB,EAChC,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAKN;CACF;AAoOD,MAAM,MAAM,gCAAgC,GAAG,SAAS,GAAG,YAAY,CAAC;AAExE,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,gCAAgC,GAAG,SAAS,CAS7G;AA0CD,qFAAqF;AACrF,MAAM,WAAW,+BAA+B;IAC9C,gBAAgB,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,0BAA0B,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC;IACzD,sFAAsF;IACtF,uBAAuB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC;;;;OAIG;IACH,0BAA0B,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1D;AAED,wBAAgB,qCAAqC,IAAI,+BAA+B,CAOvF;AAYD,kFAAkF;AAClF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,GAAG,EACV,KAAK,GAAE,+BAAyE,GAC/E,sBAAsB,GAAG,IAAI,CAkI/B;AAED,qBAAa,sCAAuC,YAAW,iBAAiB;;IAC9E,SAAS,CAAC,QAAQ,CAAC,SAAS,YAAmB;IAC/C,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC;IAChC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACpD,SAAS,CAAC,QAAQ,CAAC,yBAAyB,EAAE,OAAO,CAAC;IACtD,SAAS,CAAC,QAAQ,CAAC,6BAA6B,CAAC,EAAE,6BAA6B,CAAC;IAEjF,YACE,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,sBAAsB,EAChC,yBAAyB,UAAQ,EACjC,6BAA6B,CAAC,EAAE,6BAA6B,EAO9D;IAEK,WAAW,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,GAAG,CAAC,CAsBjE;IAEM,MAAM,CAAC,OAAO,EAAE,wBAAwB,GAAG,aAAa,CAAC,sBAAsB,CAAC,CAEtF;CAkCF;AAED,qBAAa,wCAAyC,SAAQ,sCAAsC;IAC3F,MAAM,CAAC,OAAO,EAAE,wBAAwB,GAAG,aAAa,CAAC,sBAAsB,CAAC,CAqCtF;CACF"}