@kenkaiiii/gg-ai 4.3.169 → 4.3.171

package/dist/index.d.cts

@@ -189,6 +189,12 @@ interface StreamOptions {
      *  stalls — broken SSE connections (transient CDN / proxy issues) often
      *  recover when the same request is issued over a plain HTTP request/response. */
     streaming?: boolean;
+    /** Override the User-Agent sent with OAuth-authenticated Anthropic requests.
+     *  Anthropic's OAuth edge rejects requests whose claude-cli version lags too
+     *  far behind the real Claude Code release; callers that track the live
+     *  version should pass it here. Ignored for non-Anthropic providers and for
+     *  Anthropic requests using a regular API key. */
+    userAgent?: string;
 }
 
 /**
@@ -365,6 +371,16 @@ declare function formatError(err: unknown): FormattedError;
  */
 declare function formatErrorForDisplay(err: unknown): string;
 
+/**
+ * Provider-level diagnostic hook. Mirrors the pattern used by gg-agent's
+ * setStreamDiagnostic — the host app wires a callback (typically writing to
+ * a debug log) and providers call `providerDiag(...)` to record interesting
+ * lifecycle events (e.g. raw SSE event types and timings).
+ */
+type ProviderDiagnosticFn = (phase: string, data?: Record<string, unknown>) => void;
+/** Register a diagnostic callback for provider-level tracing. */
+declare function setProviderDiagnostic(fn: ProviderDiagnosticFn | null): void;
+
 interface PalsuProviderState {
     callCount: number;
 }
@@ -434,4 +450,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 PalsuModelConfig, type PalsuModelHandle, type PalsuProviderConfig, type PalsuProviderHandle, type PalsuProviderState, type PalsuResponse, type PalsuResponseFactory, type Provider, 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, stream };
+export { type AssistantMessage, type CacheRetention, type ContentPart, type DoneEvent, type ErrorEvent, type ErrorSource, EventStream, type FormattedError, GGAIError, 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 };

package/dist/index.d.ts

@@ -189,6 +189,12 @@ interface StreamOptions {
      *  stalls — broken SSE connections (transient CDN / proxy issues) often
      *  recover when the same request is issued over a plain HTTP request/response. */
     streaming?: boolean;
+    /** Override the User-Agent sent with OAuth-authenticated Anthropic requests.
+     *  Anthropic's OAuth edge rejects requests whose claude-cli version lags too
+     *  far behind the real Claude Code release; callers that track the live
+     *  version should pass it here. Ignored for non-Anthropic providers and for
+     *  Anthropic requests using a regular API key. */
+    userAgent?: string;
 }
 
 /**
@@ -365,6 +371,16 @@ declare function formatError(err: unknown): FormattedError;
  */
 declare function formatErrorForDisplay(err: unknown): string;
 
+/**
+ * Provider-level diagnostic hook. Mirrors the pattern used by gg-agent's
+ * setStreamDiagnostic — the host app wires a callback (typically writing to
+ * a debug log) and providers call `providerDiag(...)` to record interesting
+ * lifecycle events (e.g. raw SSE event types and timings).
+ */
+type ProviderDiagnosticFn = (phase: string, data?: Record<string, unknown>) => void;
+/** Register a diagnostic callback for provider-level tracing. */
+declare function setProviderDiagnostic(fn: ProviderDiagnosticFn | null): void;
+
 interface PalsuProviderState {
     callCount: number;
 }
@@ -434,4 +450,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 PalsuModelConfig, type PalsuModelHandle, type PalsuProviderConfig, type PalsuProviderHandle, type PalsuProviderState, type PalsuResponse, type PalsuResponseFactory, type Provider, 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, stream };
+export { type AssistantMessage, type CacheRetention, type ContentPart, type DoneEvent, type ErrorEvent, type ErrorSource, EventStream, type FormattedError, GGAIError, 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 };

package/dist/index.js

@@ -734,7 +734,10 @@ function createClient(options) {
     maxRetries: 2,
     ...isOAuth ? {
       defaultHeaders: {
-        "user-agent": "claude-cli/2.1.75",
+        // Anthropic's OAuth edge validates the claude-cli version. Callers
+        // (ggcoder) resolve the live version at runtime; the literal here
+        // is the offline fallback for direct gg-ai consumers.
+        "user-agent": options.userAgent ?? "claude-cli/2.1.75 (external, cli)",
         "x-app": "cli"
       }
     } : {}
@@ -779,16 +782,28 @@ async function* runStream(options) {
     ...options.temperature != null && !thinking ? { temperature: options.temperature } : {},
     ...options.topP != null ? { top_p: options.topP } : {},
     ...options.stop ? { stop_sequences: options.stop } : {},
-    ...options.tools?.length || options.serverTools?.length || options.webSearch ? {
-      tools: [
-        ...options.tools?.length ? toAnthropicTools(options.tools, {
+    ...options.tools?.length || options.serverTools?.length || options.webSearch ? (() => {
+      const reservedServerNames = /* @__PURE__ */ new Set();
+      if (options.webSearch) reservedServerNames.add("web_search");
+      for (const t of options.serverTools ?? []) {
+        const name = t.name;
+        if (name) reservedServerNames.add(name);
+      }
+      const clientTools = options.tools?.length ? toAnthropicTools(
+        options.tools.filter((t) => !reservedServerNames.has(t.name)),
+        {
           ...supportsFirstPartyToolExtras && cacheControl ? { cacheControl } : {},
           ...supportsFirstPartyToolExtras ? { enableFineGrainedToolStreaming: true } : {}
-        }) : [],
-        ...options.serverTools ?? [],
-        ...options.webSearch ? [{ type: "web_search_20250305", name: "web_search" }] : []
-      ]
-    } : {},
+        }
+      ) : [];
+      return {
+        tools: [
+          ...clientTools,
+          ...options.serverTools ?? [],
+          ...options.webSearch ? [{ type: "web_search_20250305", name: "web_search" }] : []
+        ]
+      };
+    })() : {},
     ...options.toolChoice && options.tools?.length ? { tool_choice: toAnthropicToolChoice(options.toolChoice) } : {},
     ...(() => {
       const contextEdits = [
@@ -873,7 +888,11 @@ async function* runStream(options) {
             accum.raw = block;
           }
           blocks.set(idx, accum);
-          yield keepalive;
+          if (block.type === "thinking") {
+            yield { type: "thinking_delta", text: "" };
+          } else {
+            yield keepalive;
+          }
           break;
         }
         case "content_block_delta": {
@@ -1439,6 +1458,17 @@ function toError2(err, provider = "openai") {
 
 // src/providers/openai-codex.ts
 import os from "os";
+
+// src/utils/diag.ts
+var _diagFn = null;
+function setProviderDiagnostic(fn) {
+  _diagFn = fn;
+}
+function providerDiag(phase, data) {
+  _diagFn?.(phase, data);
+}
+
+// src/providers/openai-codex.ts
 var DEFAULT_BASE_URL = "https://chatgpt.com/backend-api";
 function streamOpenAICodex(options) {
   return new StreamResult(runStream3(options));
@@ -1516,9 +1546,15 @@ async function* runStream3(options) {
   let inputTokens = 0;
   let outputTokens = 0;
   let cacheRead = 0;
+  const diagStart = Date.now();
+  const diagSeen = /* @__PURE__ */ new Set();
   for await (const event of parseSSE(response.body)) {
     const type = event.type;
     if (!type) continue;
+    if (!diagSeen.has(type)) {
+      diagSeen.add(type);
+      providerDiag("codex_event_first", { type, sinceStartMs: Date.now() - diagStart });
+    }
     if (type === "error") {
       const nested = event.error ?? void 0;
       const message = nested?.message ?? event.message ?? "Codex stream emitted an error chunk without a message.";
@@ -1546,6 +1582,12 @@ async function* runStream3(options) {
       const delta = event.delta;
       yield { type: "thinking_delta", text: delta };
     }
+    if (type === "response.output_item.added") {
+      const item = event.item;
+      if (item?.type === "reasoning") {
+        yield { type: "thinking_delta", text: "" };
+      }
+    }
     if (type === "response.output_item.added") {
       const item = event.item;
       if (item?.type === "function_call") {
@@ -2065,6 +2107,7 @@ export {
   palsuToolCall,
   providerRegistry,
   registerPalsuProvider,
+  setProviderDiagnostic,
   stream
 };
 //# sourceMappingURL=index.js.map