@linxiraos/pi-ai 1.0.0 → 1.0.2

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

@@ -1,131 +0,0 @@
-import type { Context, Model, OpenAICompat, ProviderSessionState, ServiceTier, StreamFunction, StreamOptions, Tool, ToolChoice } from "../types.js";
-import { type OpenAIResponsesToolChoice } from "../utils/tool-choice.js";
-import { type OpenAIReasoningEffortFallbackState } from "./openai-reasoning-fallback.js";
-import type { Tool as OpenAITool, ResponseCreateParamsStreaming, ResponseInput } from "./openai-responses-wire.js";
-import { type OpenAIPromptCacheOptions, type OpenAIStrictToolsScope, type OpenAIStrictToolsState } from "./openai-shared.js";
-export interface OpenAIResponsesOptions extends StreamOptions {
-    reasoning?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
-    reasoningSummary?: "auto" | "detailed" | "concise" | null;
-    serviceTier?: ServiceTier;
-    textVerbosity?: "low" | "medium" | "high";
-    toolChoice?: ToolChoice;
-    openrouterVariant?: string;
-    maxTokensExplicit?: boolean;
-    disableReasoning?: boolean;
-    /**
-     * Stateful turns: chain via `previous_response_id` + delta input instead of
-     * replaying the full transcript. Forces `store: true` (the platform only
-     * resolves stored responses). Defaults ON against the official OpenAI API
-     * and OFF for other Responses endpoints; `PI_OPENAI_STATEFUL` overrides the
-     * default, and `false` here vetoes everything. Requires `sessionId` +
-     * `providerSessionState`. Falls back to a full replay whenever history
-     * mutates or the server reports a stale id.
-     */
-    statefulResponses?: boolean;
-    /**
-     * Override catalog compat for strict tool call/result pairing when building
-     * Responses API inputs. Default behavior is catalog compat; this is only for
-     * debugging/adapter wrappers.
-     */
-    strictResponsesPairing?: boolean;
-    /**
-     * Override catalog compat for `include: ["reasoning.encrypted_content"]`.
-     * Default behavior is catalog compat; this is only for debugging/adapter wrappers.
-     */
-    includeEncryptedReasoning?: boolean;
-    /**
-     * Override catalog compat for stripping `type: "reasoning"` items from
-     * replayed conversation history before request encoding. Default behavior is
-     * catalog compat; this is only for debugging/adapter wrappers.
-     */
-    filterReasoningHistory?: boolean;
-    /**
-     * Override catalog compat for suppressing the `reasoning.effort` wire param.
-     * Default behavior is catalog compat; this is only for debugging/adapter wrappers.
-     */
-    omitReasoningEffort?: boolean;
-    /**
-     * Extra request headers merged onto the model/copilot defaults. Used by
-     * adapter wrappers to inject provider-specific
-     * routing or cache hints.
-     */
-    headers?: Record<string, string>;
-    /**
-     * Extra body fields merged into the Responses request payload. Used by
-     * adapter wrappers to inject provider-specific body keys (e.g.,
-     * prompt_cache_key for prompt-cache routing).
-     */
-    extraBody?: Record<string, unknown>;
-    /** Opt-in GPT-5.6+ prompt-cache policy. Unsupported explicit mode fails locally. */
-    promptCache?: OpenAIPromptCacheOptions;
-}
-interface OpenAIResponsesProviderSessionState extends ProviderSessionState, OpenAIStrictToolsState, OpenAIReasoningEffortFallbackState {
-    nativeHistoryReplayWarmed: boolean;
-    /** Stateful `previous_response_id` chain baselines, keyed by baseUrl/model/session. */
-    chains: Map<string, OpenAIResponsesChainState>;
-}
-interface OpenAIResponsesChainState {
-    /**
-     * Wire params of the last successful turn; never carries
-     * `previous_response_id`.
-     */
-    lastParams?: OpenAIResponsesSamplingParams;
-    lastPromptCacheBreakpointPolicy?: "latest-stable-message" | "none";
-    lastResponseId?: string;
-    /** Output items of the last response, in replay-sanitized form (matches next-turn input). */
-    lastResponseItems?: ResponseInput;
-    canAppend: boolean;
-    /** Consecutive stale-previous-response failures; reset on a successful chained completion. */
-    staleFailures: number;
-    /** Set once chaining is judged unsupported for this session (circuit breaker). */
-    disabled: boolean;
-}
-type OpenRouterAnthropicCacheControl = {
-    type: "ephemeral";
-    ttl?: "1h";
-};
-type OpenAIResponsesSamplingParams = ResponseCreateParamsStreaming & {
-    top_p?: number;
-    top_k?: number;
-    min_p?: number;
-    presence_penalty?: number;
-    repetition_penalty?: number;
-    session_id?: string;
-    stream_options?: {
-        include_obfuscation?: boolean;
-    };
-    provider?: OpenAICompat["openRouterRouting"];
-    reasoning?: {
-        effort?: string;
-    } | {
-        enabled: false;
-    };
-    cache_control?: OpenRouterAnthropicCacheControl;
-    caching?: "auto";
-    cache_anchor_items?: number;
-    cache_ttl?: "5m" | "1h";
-};
-/**
- * Public entry: wrap the single-attempt Responses streamer with bounded
- * empty-completion retries — a `response.completed` carrying no content/usage
- * would otherwise stall the agent loop. Shared with the OpenAI-completions and
- * Anthropic providers via `withEmptyCompletionRetry`.
- */
-export declare const streamOpenAIResponses: StreamFunction<"openai-responses">;
-export declare function buildParams(model: Model<"openai-responses">, context: Context, options: OpenAIResponsesOptions | undefined, providerSessionState: OpenAIResponsesProviderSessionState | undefined, strictToolsScope?: OpenAIStrictToolsScope, disableStrictToolsOverride?: boolean, statefulCacheBaseline?: ResponseInput): {
-    params: OpenAIResponsesSamplingParams;
-    strictToolsApplied: boolean;
-};
-/**
- * Whether this model should get the OpenAI custom-tool grammar variant
- * for `apply_patch`. The generated model catalog sets
- * `model.applyPatchToolType` for first-party GPT-5 Responses models; this
- * runtime path only consumes that metadata.
- * @internal Exported for tests.
- */
-export declare function supportsFreeformApplyPatch(model: Model<"openai-responses" | "azure-openai-responses" | "openai-codex-responses">): boolean;
-/** @internal Exported for tests. */
-export declare function mapOpenAIResponsesToolChoiceForTools(choice: ToolChoice | undefined, tools: Tool[], model: Model<"openai-responses">): OpenAIResponsesToolChoice;
-/** @internal Exported for tests. */
-export declare function convertTools(tools: Tool[], strictMode: boolean, model: Model<"openai-responses" | "azure-openai-responses" | "openai-codex-responses">, onQuarantine?: (toolName: string, schemaPath: string) => void): OpenAITool[];
-export {};