@kenkaiiii/gg-ai 5.44.2 → 5.45.0

package/dist/index.d.cts

@@ -530,6 +530,47 @@ type ProviderDiagnosticFn = (phase: string, data?: Record<string, unknown>) => v
 /** Register a diagnostic callback for provider-level tracing. */
 declare function setProviderDiagnostic(fn: ProviderDiagnosticFn | null): void;
 
+/**
+ * Converts a Zod schema to a JSON Schema object suitable for provider tool
+ * parameter definitions.
+ *
+ * Anthropic's `input_schema` validator is strict in two ways:
+ *
+ *   1. The root must be `type: "object"`. Returns 400 with
+ *      `tools.N.custom.input_schema.type: Field required` otherwise.
+ *
+ *   2. The root must NOT contain `oneOf`, `anyOf`, or `allOf`. Returns 400 with
+ *      `input_schema does not support oneOf, allOf, or anyOf at the top level`.
+ *
+ * Both rules trip whenever a tool's parameters are defined via
+ * `z.discriminatedUnion(...)` or `z.union(...)` — Zod 4's
+ * `z.toJSONSchema` emits `{oneOf: [...]}` at the root with no `type`.
+ *
+ * The fix is to collapse the union into a single flat object schema:
+ *
+ *   - properties = union of all branch properties (later branches win on
+ *     conflict; that's fine because the model only uses these for hints —
+ *     Zod's actual `tool.parameters.parse(args)` is the real validator)
+ *   - required = intersection of branch `required` arrays (a field is only
+ *     required if EVERY branch requires it)
+ *   - if the union has a discriminator field (every branch has the same
+ *     property as a `const`), we replace the discriminator's per-branch
+ *     `const` with an `enum` listing every literal — the model gets a clear
+ *     hint of the valid action values without needing oneOf
+ *
+ * The flattening is lossy for *schema-level* constraints (e.g. "if action=X,
+ * then field Y is required") — Zod still enforces those at parse time. For
+ * the model's purposes this is identical to a single object with optional
+ * fields and a discriminator enum, which is exactly how Anthropic-supported
+ * tools are typically authored anyway.
+ */
+type JsonSchema = Record<string, unknown>;
+/**
+ * Resolve a tool's JSON Schema for provider tool definitions: prefer the
+ * tool's pre-built `rawInputSchema`, otherwise convert its Zod `parameters`.
+ */
+declare function resolveToolSchema(tool: Tool): JsonSchema;
+
 /**
  * Cap historical images before provider dispatch, removing the oldest first.
  * The persisted/live conversation is never mutated; only modified messages and
@@ -642,4 +683,4 @@ interface PalsuProviderConfig {
  */
 declare function registerPalsuProvider(config?: PalsuProviderConfig): PalsuProviderHandle;
 
-export { type AssistantMessage, type CacheRetention, type ContentPart, type DoneEvent, type ErrorEvent, type ErrorSource, EventStream, type FormattedError, GGAIError, type ImageContent, type Message, type MessageProvenance, type MessageProvenanceKind, type MessageProvenanceSource, type MessageProvenanceVisibility, type PalsuModelConfig, type PalsuModelHandle, type PalsuProviderConfig, type PalsuProviderHandle, type PalsuProviderState, type PalsuResponse, type PalsuResponseFactory, type Provider, type ProviderDiagnosticFn, type ProviderEntry, ProviderError, type ProviderStreamFn, REDACTED as REDACTION_MARKER, type RawContent, type RedactionOptions, 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, clampProviderContextImages, classifyProviderError, environmentSecrets, formatError, formatErrorForDisplay, hasLoneSurrogate, isHardBillingMessage, isUsageLimitError, localWireModelId, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, prewarmAnthropicCache, providerRegistry, redactText, redactValue, registerPalsuProvider, sanitizeMessagesForWire, setProviderDiagnostic, sliceHead, sliceTail, stream, toAnthropicMessages, toOpenAIMessages, toWellFormedText };
+export { type AssistantMessage, type CacheRetention, type ContentPart, type DoneEvent, type ErrorEvent, type ErrorSource, EventStream, type FormattedError, GGAIError, type ImageContent, type Message, type MessageProvenance, type MessageProvenanceKind, type MessageProvenanceSource, type MessageProvenanceVisibility, type PalsuModelConfig, type PalsuModelHandle, type PalsuProviderConfig, type PalsuProviderHandle, type PalsuProviderState, type PalsuResponse, type PalsuResponseFactory, type Provider, type ProviderDiagnosticFn, type ProviderEntry, ProviderError, type ProviderStreamFn, REDACTED as REDACTION_MARKER, type RawContent, type RedactionOptions, 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, clampProviderContextImages, classifyProviderError, environmentSecrets, formatError, formatErrorForDisplay, hasLoneSurrogate, isHardBillingMessage, isUsageLimitError, localWireModelId, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, prewarmAnthropicCache, providerRegistry, redactText, redactValue, registerPalsuProvider, resolveToolSchema, sanitizeMessagesForWire, setProviderDiagnostic, sliceHead, sliceTail, stream, toAnthropicMessages, toOpenAIMessages, toWellFormedText };

package/dist/index.d.ts

@@ -530,6 +530,47 @@ type ProviderDiagnosticFn = (phase: string, data?: Record<string, unknown>) => v
 /** Register a diagnostic callback for provider-level tracing. */
 declare function setProviderDiagnostic(fn: ProviderDiagnosticFn | null): void;
 
+/**
+ * Converts a Zod schema to a JSON Schema object suitable for provider tool
+ * parameter definitions.
+ *
+ * Anthropic's `input_schema` validator is strict in two ways:
+ *
+ *   1. The root must be `type: "object"`. Returns 400 with
+ *      `tools.N.custom.input_schema.type: Field required` otherwise.
+ *
+ *   2. The root must NOT contain `oneOf`, `anyOf`, or `allOf`. Returns 400 with
+ *      `input_schema does not support oneOf, allOf, or anyOf at the top level`.
+ *
+ * Both rules trip whenever a tool's parameters are defined via
+ * `z.discriminatedUnion(...)` or `z.union(...)` — Zod 4's
+ * `z.toJSONSchema` emits `{oneOf: [...]}` at the root with no `type`.
+ *
+ * The fix is to collapse the union into a single flat object schema:
+ *
+ *   - properties = union of all branch properties (later branches win on
+ *     conflict; that's fine because the model only uses these for hints —
+ *     Zod's actual `tool.parameters.parse(args)` is the real validator)
+ *   - required = intersection of branch `required` arrays (a field is only
+ *     required if EVERY branch requires it)
+ *   - if the union has a discriminator field (every branch has the same
+ *     property as a `const`), we replace the discriminator's per-branch
+ *     `const` with an `enum` listing every literal — the model gets a clear
+ *     hint of the valid action values without needing oneOf
+ *
+ * The flattening is lossy for *schema-level* constraints (e.g. "if action=X,
+ * then field Y is required") — Zod still enforces those at parse time. For
+ * the model's purposes this is identical to a single object with optional
+ * fields and a discriminator enum, which is exactly how Anthropic-supported
+ * tools are typically authored anyway.
+ */
+type JsonSchema = Record<string, unknown>;
+/**
+ * Resolve a tool's JSON Schema for provider tool definitions: prefer the
+ * tool's pre-built `rawInputSchema`, otherwise convert its Zod `parameters`.
+ */
+declare function resolveToolSchema(tool: Tool): JsonSchema;
+
 /**
  * Cap historical images before provider dispatch, removing the oldest first.
  * The persisted/live conversation is never mutated; only modified messages and
@@ -642,4 +683,4 @@ interface PalsuProviderConfig {
  */
 declare function registerPalsuProvider(config?: PalsuProviderConfig): PalsuProviderHandle;
 
-export { type AssistantMessage, type CacheRetention, type ContentPart, type DoneEvent, type ErrorEvent, type ErrorSource, EventStream, type FormattedError, GGAIError, type ImageContent, type Message, type MessageProvenance, type MessageProvenanceKind, type MessageProvenanceSource, type MessageProvenanceVisibility, type PalsuModelConfig, type PalsuModelHandle, type PalsuProviderConfig, type PalsuProviderHandle, type PalsuProviderState, type PalsuResponse, type PalsuResponseFactory, type Provider, type ProviderDiagnosticFn, type ProviderEntry, ProviderError, type ProviderStreamFn, REDACTED as REDACTION_MARKER, type RawContent, type RedactionOptions, 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, clampProviderContextImages, classifyProviderError, environmentSecrets, formatError, formatErrorForDisplay, hasLoneSurrogate, isHardBillingMessage, isUsageLimitError, localWireModelId, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, prewarmAnthropicCache, providerRegistry, redactText, redactValue, registerPalsuProvider, sanitizeMessagesForWire, setProviderDiagnostic, sliceHead, sliceTail, stream, toAnthropicMessages, toOpenAIMessages, toWellFormedText };
+export { type AssistantMessage, type CacheRetention, type ContentPart, type DoneEvent, type ErrorEvent, type ErrorSource, EventStream, type FormattedError, GGAIError, type ImageContent, type Message, type MessageProvenance, type MessageProvenanceKind, type MessageProvenanceSource, type MessageProvenanceVisibility, type PalsuModelConfig, type PalsuModelHandle, type PalsuProviderConfig, type PalsuProviderHandle, type PalsuProviderState, type PalsuResponse, type PalsuResponseFactory, type Provider, type ProviderDiagnosticFn, type ProviderEntry, ProviderError, type ProviderStreamFn, REDACTED as REDACTION_MARKER, type RawContent, type RedactionOptions, 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, clampProviderContextImages, classifyProviderError, environmentSecrets, formatError, formatErrorForDisplay, hasLoneSurrogate, isHardBillingMessage, isUsageLimitError, localWireModelId, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, prewarmAnthropicCache, providerRegistry, redactText, redactValue, registerPalsuProvider, resolveToolSchema, sanitizeMessagesForWire, setProviderDiagnostic, sliceHead, sliceTail, stream, toAnthropicMessages, toOpenAIMessages, toWellFormedText };

package/dist/index.js

@@ -4160,6 +4160,7 @@ export {
   redactText,
   redactValue,
   registerPalsuProvider,
+  resolveToolSchema,
   sanitizeMessagesForWire,
   setProviderDiagnostic,
   sliceHead,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kenkaiiii/gg-ai",
-  "version": "5.44.2",
+  "version": "5.45.0",
   "type": "module",
   "description": "Unified LLM streaming API for Anthropic, OpenAI, and Gemini",
   "license": "MIT",