@prestyj/ai 4.3.210 → 4.3.238

package/dist/index.d.cts

@@ -1,7 +1,9 @@
 import { z } from 'zod';
+import Anthropic from '@anthropic-ai/sdk';
+import OpenAI from 'openai';
 
 type Provider = "anthropic" | "xiaomi" | "openai" | "gemini" | "glm" | "moonshot" | "minimax" | "deepseek" | "openrouter" | "palsu";
-type ThinkingLevel = "low" | "medium" | "high" | "xhigh";
+type ThinkingLevel = "low" | "medium" | "high" | "xhigh" | "max";
 type CacheRetention = "none" | "short" | "long";
 interface TextContent {
     type: "text";
@@ -335,6 +337,8 @@ interface FormattedError {
     statusCode?: number;
     /** Provider request ID, kept for telemetry / debug — not shown by default. */
     requestId?: string;
+    /** Unix seconds when a usage/rate limit resets, when the provider reports it. */
+    resetsAt?: number;
 }
 declare class EZCoderAIError extends Error {
     readonly source: ErrorSource;
@@ -350,11 +354,14 @@ declare class EZCoderAIError extends Error {
 declare class ProviderError extends EZCoderAIError {
     readonly provider: string;
     readonly statusCode?: number;
+    /** Unix seconds when a usage/rate limit resets, when the provider reports it. */
+    readonly resetsAt?: number;
     constructor(provider: string, message: string, options?: {
         statusCode?: number;
         requestId?: string;
         hint?: string;
         cause?: unknown;
+        resetsAt?: number;
     });
 }
 /**
@@ -362,6 +369,14 @@ declare class ProviderError extends EZCoderAIError {
  * a non-empty `headline` and `guidance` so the UI never has to second-guess
  * what to show the user.
  */
+/**
+ * Is this a subscription/plan usage-window exhaustion error (as opposed to a
+ * transient per-minute throttle)? These don't clear with a quick retry — the
+ * user has to wait for the window to reset — so callers must surface them as a
+ * hard stop, not silently retry for minutes. Detected from the canonical
+ * "usage limit reached" message gg-ai stamps onto the ProviderError.
+ */
+declare function isUsageLimitError(err: unknown): boolean;
 declare function formatError(err: unknown): FormattedError;
 /**
  * Render a FormattedError as a multi-line string for terminal display.
@@ -383,6 +398,19 @@ type ProviderDiagnosticFn = (phase: string, data?: Record<string, unknown>) => v
 /** Register a diagnostic callback for provider-level tracing. */
 declare function setProviderDiagnostic(fn: ProviderDiagnosticFn | null): void;
 
+declare function toAnthropicMessages(messages: Message[], cacheControl?: {
+    type: "ephemeral";
+    ttl?: "1h";
+}): {
+    system: Anthropic.TextBlockParam[] | undefined;
+    messages: Anthropic.MessageParam[];
+};
+declare function toOpenAIMessages(messages: Message[], options?: {
+    provider?: string;
+    thinking?: boolean;
+    supportsImages?: boolean;
+}): OpenAI.ChatCompletionMessageParam[];
+
 interface PalsuProviderState {
     callCount: number;
 }
@@ -452,4 +480,4 @@ interface PalsuProviderConfig {
  */
 declare function registerPalsuProvider(config?: PalsuProviderConfig): PalsuProviderHandle;
 
-export { type AssistantMessage, type CacheRetention, type ContentPart, type DoneEvent, EZCoderAIError, type ErrorEvent, type ErrorSource, EventStream, type FormattedError, type ImageContent, type Message, type PalsuModelConfig, type PalsuModelHandle, type PalsuProviderConfig, type PalsuProviderHandle, type PalsuProviderState, type PalsuResponse, type PalsuResponseFactory, type Provider, type ProviderDiagnosticFn, type ProviderEntry, ProviderError, type ProviderStreamFn, type RawContent, type ServerToolCall, type ServerToolCallEvent, type ServerToolDefinition, type ServerToolResult, type ServerToolResultEvent, type StopReason, type StreamEvent, type StreamOptions, type StreamResponse, StreamResult, type SystemMessage, type TextContent, type TextDeltaEvent, type ThinkingContent, type ThinkingDeltaEvent, type ThinkingLevel, type Tool, type ToolCall, type ToolCallDeltaEvent, type ToolCallDoneEvent, type ToolChoice, type ToolResult, type ToolResultContent, type ToolResultMessage, type Usage, type UserMessage, formatError, formatErrorForDisplay, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, providerRegistry, registerPalsuProvider, setProviderDiagnostic, stream };
+export { type AssistantMessage, type CacheRetention, type ContentPart, type DoneEvent, EZCoderAIError, type ErrorEvent, type ErrorSource, EventStream, type FormattedError, type ImageContent, type Message, type PalsuModelConfig, type PalsuModelHandle, type PalsuProviderConfig, type PalsuProviderHandle, type PalsuProviderState, type PalsuResponse, type PalsuResponseFactory, type Provider, type ProviderDiagnosticFn, type ProviderEntry, ProviderError, type ProviderStreamFn, type RawContent, type ServerToolCall, type ServerToolCallEvent, type ServerToolDefinition, type ServerToolResult, type ServerToolResultEvent, type StopReason, type StreamEvent, type StreamOptions, type StreamResponse, StreamResult, type SystemMessage, type TextContent, type TextDeltaEvent, type ThinkingContent, type ThinkingDeltaEvent, type ThinkingLevel, type Tool, type ToolCall, type ToolCallDeltaEvent, type ToolCallDoneEvent, type ToolChoice, type ToolResult, type ToolResultContent, type ToolResultMessage, type Usage, type UserMessage, formatError, formatErrorForDisplay, isUsageLimitError, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, providerRegistry, registerPalsuProvider, setProviderDiagnostic, stream, toAnthropicMessages, toOpenAIMessages };

package/dist/index.d.ts

@@ -1,7 +1,9 @@
 import { z } from 'zod';
+import Anthropic from '@anthropic-ai/sdk';
+import OpenAI from 'openai';
 
 type Provider = "anthropic" | "xiaomi" | "openai" | "gemini" | "glm" | "moonshot" | "minimax" | "deepseek" | "openrouter" | "palsu";
-type ThinkingLevel = "low" | "medium" | "high" | "xhigh";
+type ThinkingLevel = "low" | "medium" | "high" | "xhigh" | "max";
 type CacheRetention = "none" | "short" | "long";
 interface TextContent {
     type: "text";
@@ -335,6 +337,8 @@ interface FormattedError {
     statusCode?: number;
     /** Provider request ID, kept for telemetry / debug — not shown by default. */
     requestId?: string;
+    /** Unix seconds when a usage/rate limit resets, when the provider reports it. */
+    resetsAt?: number;
 }
 declare class EZCoderAIError extends Error {
     readonly source: ErrorSource;
@@ -350,11 +354,14 @@ declare class EZCoderAIError extends Error {
 declare class ProviderError extends EZCoderAIError {
     readonly provider: string;
     readonly statusCode?: number;
+    /** Unix seconds when a usage/rate limit resets, when the provider reports it. */
+    readonly resetsAt?: number;
     constructor(provider: string, message: string, options?: {
         statusCode?: number;
         requestId?: string;
         hint?: string;
         cause?: unknown;
+        resetsAt?: number;
     });
 }
 /**
@@ -362,6 +369,14 @@ declare class ProviderError extends EZCoderAIError {
  * a non-empty `headline` and `guidance` so the UI never has to second-guess
  * what to show the user.
  */
+/**
+ * Is this a subscription/plan usage-window exhaustion error (as opposed to a
+ * transient per-minute throttle)? These don't clear with a quick retry — the
+ * user has to wait for the window to reset — so callers must surface them as a
+ * hard stop, not silently retry for minutes. Detected from the canonical
+ * "usage limit reached" message gg-ai stamps onto the ProviderError.
+ */
+declare function isUsageLimitError(err: unknown): boolean;
 declare function formatError(err: unknown): FormattedError;
 /**
  * Render a FormattedError as a multi-line string for terminal display.
@@ -383,6 +398,19 @@ type ProviderDiagnosticFn = (phase: string, data?: Record<string, unknown>) => v
 /** Register a diagnostic callback for provider-level tracing. */
 declare function setProviderDiagnostic(fn: ProviderDiagnosticFn | null): void;
 
+declare function toAnthropicMessages(messages: Message[], cacheControl?: {
+    type: "ephemeral";
+    ttl?: "1h";
+}): {
+    system: Anthropic.TextBlockParam[] | undefined;
+    messages: Anthropic.MessageParam[];
+};
+declare function toOpenAIMessages(messages: Message[], options?: {
+    provider?: string;
+    thinking?: boolean;
+    supportsImages?: boolean;
+}): OpenAI.ChatCompletionMessageParam[];
+
 interface PalsuProviderState {
     callCount: number;
 }
@@ -452,4 +480,4 @@ interface PalsuProviderConfig {
  */
 declare function registerPalsuProvider(config?: PalsuProviderConfig): PalsuProviderHandle;
 
-export { type AssistantMessage, type CacheRetention, type ContentPart, type DoneEvent, EZCoderAIError, type ErrorEvent, type ErrorSource, EventStream, type FormattedError, type ImageContent, type Message, type PalsuModelConfig, type PalsuModelHandle, type PalsuProviderConfig, type PalsuProviderHandle, type PalsuProviderState, type PalsuResponse, type PalsuResponseFactory, type Provider, type ProviderDiagnosticFn, type ProviderEntry, ProviderError, type ProviderStreamFn, type RawContent, type ServerToolCall, type ServerToolCallEvent, type ServerToolDefinition, type ServerToolResult, type ServerToolResultEvent, type StopReason, type StreamEvent, type StreamOptions, type StreamResponse, StreamResult, type SystemMessage, type TextContent, type TextDeltaEvent, type ThinkingContent, type ThinkingDeltaEvent, type ThinkingLevel, type Tool, type ToolCall, type ToolCallDeltaEvent, type ToolCallDoneEvent, type ToolChoice, type ToolResult, type ToolResultContent, type ToolResultMessage, type Usage, type UserMessage, formatError, formatErrorForDisplay, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, providerRegistry, registerPalsuProvider, setProviderDiagnostic, stream };
+export { type AssistantMessage, type CacheRetention, type ContentPart, type DoneEvent, EZCoderAIError, type ErrorEvent, type ErrorSource, EventStream, type FormattedError, type ImageContent, type Message, type PalsuModelConfig, type PalsuModelHandle, type PalsuProviderConfig, type PalsuProviderHandle, type PalsuProviderState, type PalsuResponse, type PalsuResponseFactory, type Provider, type ProviderDiagnosticFn, type ProviderEntry, ProviderError, type ProviderStreamFn, type RawContent, type ServerToolCall, type ServerToolCallEvent, type ServerToolDefinition, type ServerToolResult, type ServerToolResultEvent, type StopReason, type StreamEvent, type StreamOptions, type StreamResponse, StreamResult, type SystemMessage, type TextContent, type TextDeltaEvent, type ThinkingContent, type ThinkingDeltaEvent, type ThinkingLevel, type Tool, type ToolCall, type ToolCallDeltaEvent, type ToolCallDoneEvent, type ToolChoice, type ToolResult, type ToolResultContent, type ToolResultMessage, type Usage, type UserMessage, formatError, formatErrorForDisplay, isUsageLimitError, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, providerRegistry, registerPalsuProvider, setProviderDiagnostic, stream, toAnthropicMessages, toOpenAIMessages };