@prestyj/ai 4.3.238 → 4.4.0

package/dist/index.d.cts

@@ -19,13 +19,23 @@ interface ImageContent {
     mediaType: string;
     data: string;
 }
+interface VideoContent {
+    type: "video";
+    mediaType: string;
+    data: string;
+    /** Moonshot/Kimi file id (e.g. "d4f0…") after uploading via the files API.
+     *  Moonshot rejects inline base64 video; the provider uploads the clip once
+     *  and caches the id here so later turns reference `ms://<fileId>` instead of
+     *  re-sending the bytes. */
+    fileId?: string;
+}
 interface ToolCall {
     type: "tool_call";
     id: string;
     name: string;
     args: Record<string, unknown>;
 }
-type ToolResultContent = string | (TextContent | ImageContent)[];
+type ToolResultContent = string | (TextContent | ImageContent | VideoContent)[];
 interface ToolResult {
     type: "tool_result";
     toolCallId: string;
@@ -49,14 +59,14 @@ interface RawContent {
     type: "raw";
     data: Record<string, unknown>;
 }
-type ContentPart = TextContent | ThinkingContent | ImageContent | ToolCall | ServerToolCall | ServerToolResult | RawContent;
+type ContentPart = TextContent | ThinkingContent | ImageContent | VideoContent | ToolCall | ServerToolCall | ServerToolResult | RawContent;
 interface SystemMessage {
     role: "system";
     content: string;
 }
 interface UserMessage {
     role: "user";
-    content: string | (TextContent | ImageContent)[];
+    content: string | (TextContent | ImageContent | VideoContent)[];
 }
 interface AssistantMessage {
     role: "assistant";
@@ -187,6 +197,10 @@ interface StreamOptions {
      *  in user messages and tool_result messages is downgraded to a text placeholder
      *  before being sent to the provider. Default: true. */
     supportsImages?: boolean;
+    /** Whether the target model supports video input. When false, video content
+     *  in user messages is downgraded to a text placeholder before being sent to
+     *  the provider. Default: false. */
+    supportsVideo?: boolean;
     /** Use streaming transport (default: true). When false, providers issue a
      *  single non-streaming request and synthesize events from the full response.
      *  The agent loop flips this to `false` as a fallback after repeated stream
@@ -199,6 +213,11 @@ interface StreamOptions {
      *  version should pass it here. Ignored for non-Anthropic providers and for
      *  Anthropic requests using a regular API key. */
     userAgent?: string;
+    /** Extra HTTP headers attached to every model request. Used by providers
+     *  whose endpoint gates on client identity (e.g. Kimi For Coding requires a
+     *  `User-Agent: kimi-code-cli/...` and `X-Msh-*` device headers). Merged
+     *  into the underlying SDK's default headers. */
+    defaultHeaders?: Record<string, string>;
 }
 
 /**
@@ -321,7 +340,7 @@ declare const providerRegistry: ProviderRegistryImpl;
  *     Cannot read property 'foo' of undefined
  *     → This is a ezcoder bug — please report it.
  */
-type ErrorSource = "provider" | "ezcoder" | "network" | "auth";
+type ErrorSource = "provider" | "ezcoder" | "network" | "auth" | "capability";
 interface FormattedError {
     /** Plain-English headline, e.g. "OpenAI returned an error." */
     headline: string;
@@ -377,6 +396,13 @@ declare class ProviderError extends EZCoderAIError {
  * "usage limit reached" message gg-ai stamps onto the ProviderError.
  */
 declare function isUsageLimitError(err: unknown): boolean;
+/**
+ * Substrings that mark a hard, non-retriable billing/quota stop on ANY provider
+ * (credit exhaustion, balance too low, plan quota spent). Single source of truth
+ * shared across the OpenAI-compatible and Anthropic provider boundaries and the
+ * agent-loop retry classifier, so the lists can't drift. Matched case-insensitively.
+ */
+declare function isHardBillingMessage(message: string): boolean;
 declare function formatError(err: unknown): FormattedError;
 /**
  * Render a FormattedError as a multi-line string for terminal display.
@@ -480,4 +506,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, isUsageLimitError, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, providerRegistry, registerPalsuProvider, setProviderDiagnostic, stream, toAnthropicMessages, toOpenAIMessages };
+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, type VideoContent, formatError, formatErrorForDisplay, isHardBillingMessage, isUsageLimitError, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, providerRegistry, registerPalsuProvider, setProviderDiagnostic, stream, toAnthropicMessages, toOpenAIMessages };

package/dist/index.d.ts

@@ -19,13 +19,23 @@ interface ImageContent {
     mediaType: string;
     data: string;
 }
+interface VideoContent {
+    type: "video";
+    mediaType: string;
+    data: string;
+    /** Moonshot/Kimi file id (e.g. "d4f0…") after uploading via the files API.
+     *  Moonshot rejects inline base64 video; the provider uploads the clip once
+     *  and caches the id here so later turns reference `ms://<fileId>` instead of
+     *  re-sending the bytes. */
+    fileId?: string;
+}
 interface ToolCall {
     type: "tool_call";
     id: string;
     name: string;
     args: Record<string, unknown>;
 }
-type ToolResultContent = string | (TextContent | ImageContent)[];
+type ToolResultContent = string | (TextContent | ImageContent | VideoContent)[];
 interface ToolResult {
     type: "tool_result";
     toolCallId: string;
@@ -49,14 +59,14 @@ interface RawContent {
     type: "raw";
     data: Record<string, unknown>;
 }
-type ContentPart = TextContent | ThinkingContent | ImageContent | ToolCall | ServerToolCall | ServerToolResult | RawContent;
+type ContentPart = TextContent | ThinkingContent | ImageContent | VideoContent | ToolCall | ServerToolCall | ServerToolResult | RawContent;
 interface SystemMessage {
     role: "system";
     content: string;
 }
 interface UserMessage {
     role: "user";
-    content: string | (TextContent | ImageContent)[];
+    content: string | (TextContent | ImageContent | VideoContent)[];
 }
 interface AssistantMessage {
     role: "assistant";
@@ -187,6 +197,10 @@ interface StreamOptions {
      *  in user messages and tool_result messages is downgraded to a text placeholder
      *  before being sent to the provider. Default: true. */
     supportsImages?: boolean;
+    /** Whether the target model supports video input. When false, video content
+     *  in user messages is downgraded to a text placeholder before being sent to
+     *  the provider. Default: false. */
+    supportsVideo?: boolean;
     /** Use streaming transport (default: true). When false, providers issue a
      *  single non-streaming request and synthesize events from the full response.
      *  The agent loop flips this to `false` as a fallback after repeated stream
@@ -199,6 +213,11 @@ interface StreamOptions {
      *  version should pass it here. Ignored for non-Anthropic providers and for
      *  Anthropic requests using a regular API key. */
     userAgent?: string;
+    /** Extra HTTP headers attached to every model request. Used by providers
+     *  whose endpoint gates on client identity (e.g. Kimi For Coding requires a
+     *  `User-Agent: kimi-code-cli/...` and `X-Msh-*` device headers). Merged
+     *  into the underlying SDK's default headers. */
+    defaultHeaders?: Record<string, string>;
 }
 
 /**
@@ -321,7 +340,7 @@ declare const providerRegistry: ProviderRegistryImpl;
  *     Cannot read property 'foo' of undefined
  *     → This is a ezcoder bug — please report it.
  */
-type ErrorSource = "provider" | "ezcoder" | "network" | "auth";
+type ErrorSource = "provider" | "ezcoder" | "network" | "auth" | "capability";
 interface FormattedError {
     /** Plain-English headline, e.g. "OpenAI returned an error." */
     headline: string;
@@ -377,6 +396,13 @@ declare class ProviderError extends EZCoderAIError {
  * "usage limit reached" message gg-ai stamps onto the ProviderError.
  */
 declare function isUsageLimitError(err: unknown): boolean;
+/**
+ * Substrings that mark a hard, non-retriable billing/quota stop on ANY provider
+ * (credit exhaustion, balance too low, plan quota spent). Single source of truth
+ * shared across the OpenAI-compatible and Anthropic provider boundaries and the
+ * agent-loop retry classifier, so the lists can't drift. Matched case-insensitively.
+ */
+declare function isHardBillingMessage(message: string): boolean;
 declare function formatError(err: unknown): FormattedError;
 /**
  * Render a FormattedError as a multi-line string for terminal display.
@@ -480,4 +506,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, isUsageLimitError, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, providerRegistry, registerPalsuProvider, setProviderDiagnostic, stream, toAnthropicMessages, toOpenAIMessages };
+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, type VideoContent, formatError, formatErrorForDisplay, isHardBillingMessage, isUsageLimitError, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, providerRegistry, registerPalsuProvider, setProviderDiagnostic, stream, toAnthropicMessages, toOpenAIMessages };