@opencow-ai/opencow-agent-sdk 0.4.11 → 0.4.13

package/dist/client.js

@@ -31267,6 +31267,27 @@ var init_types3 = __esm(() => {
   CanonicalUserAbortError = APIUserAbortError;
 });
 
+// src/session/canonical/imageSource.ts
+function normalizeCanonicalImageSource(source) {
+  if (!source || typeof source !== "object")
+    return null;
+  const s = source;
+  if (s.type === "base64" && typeof s.data === "string") {
+    return {
+      kind: "base64",
+      mediaType: typeof s.media_type === "string" ? s.media_type : "image/png",
+      data: s.data
+    };
+  }
+  if (s.type === "url" && typeof s.url === "string") {
+    return { kind: "url", url: s.url };
+  }
+  return null;
+}
+function imageSourceToDataUri(img) {
+  return img.kind === "base64" ? `data:${img.mediaType};base64,${img.data}` : img.url;
+}
+
 // src/session/canonical/index.ts
 var init_canonical = __esm(() => {
   init_types3();
@@ -34930,7 +34951,7 @@ function parseReasoningEffort(value) {
   if (!value)
     return;
   const normalized = value.trim().toLowerCase();
-  if (normalized === "low" || normalized === "medium" || normalized === "high" || normalized === "xhigh") {
+  if (normalized === "none" || normalized === "minimal" || normalized === "low" || normalized === "medium" || normalized === "high" || normalized === "xhigh") {
     return normalized;
   }
   return;
@@ -35051,7 +35072,10 @@ function resolveProviderRequest(options) {
     transportOverride: options?.transportOverride
   });
   const resolvedModel = transport === "chat_completions" && isEnvTruthy(getQueryEnvVar("CLAUDE_CODE_USE_GITHUB")) ? normalizeGithubModelsApiModel(requestedModel) : descriptor.baseModel;
-  const reasoning = options?.reasoningEffortOverride ? { effort: options.reasoningEffortOverride } : descriptor.reasoning;
+  const hasReasoningEffortOverride = !!options && Object.prototype.hasOwnProperty.call(options, "reasoningEffortOverride");
+  const rawEnvReasoningEffortOverride = getQueryEnvVar(QUERY_ENV_KEY_REASONING_EFFORT_OVERRIDE);
+  const envReasoningEffortOverride = parseReasoningEffort(rawEnvReasoningEffortOverride);
+  const reasoning = hasReasoningEffortOverride ? options?.reasoningEffortOverride ? { effort: options.reasoningEffortOverride } : undefined : rawEnvReasoningEffortOverride === QUERY_ENV_VALUE_REASONING_EFFORT_CLEAR ? undefined : envReasoningEffortOverride ? { effort: envReasoningEffortOverride } : descriptor.reasoning;
   return {
     transport,
     requestedModel,
@@ -35155,7 +35179,7 @@ function resolveCodexApiCredentials(env2 = process.env) {
     originator: "opencow"
   };
 }
-var DEFAULT_OPENAI_BASE_URL = "https://api.openai.com/v1", DEFAULT_CODEX_BASE_URL = "https://chatgpt.com/backend-api/codex", DEFAULT_GITHUB_MODELS_API_MODEL = "openai/gpt-4.1", CODEX_ALIAS_MODELS, QUERY_ENV_KEY_TRANSPORT_OVERRIDE = "__OPENCOW_TRANSPORT_OVERRIDE", QUERY_ENV_KEY_PROVIDER_SPECIFIC_OPENAI_RESPONSES = "__OPENCOW_PROVIDER_SPECIFIC_OPENAI_RESPONSES", LOCALHOST_HOSTNAMES, warnedCodexAliasOnce = false, MissingProviderModelError;
+var DEFAULT_OPENAI_BASE_URL = "https://api.openai.com/v1", DEFAULT_CODEX_BASE_URL = "https://chatgpt.com/backend-api/codex", DEFAULT_GITHUB_MODELS_API_MODEL = "openai/gpt-4.1", CODEX_ALIAS_MODELS, QUERY_ENV_KEY_TRANSPORT_OVERRIDE = "__OPENCOW_TRANSPORT_OVERRIDE", QUERY_ENV_KEY_REASONING_EFFORT_OVERRIDE = "__OPENCOW_REASONING_EFFORT_OVERRIDE", QUERY_ENV_VALUE_REASONING_EFFORT_CLEAR = "__OPENCOW_CLEAR_REASONING_EFFORT__", QUERY_ENV_KEY_PROVIDER_SPECIFIC_OPENAI_RESPONSES = "__OPENCOW_PROVIDER_SPECIFIC_OPENAI_RESPONSES", LOCALHOST_HOSTNAMES, warnedCodexAliasOnce = false, MissingProviderModelError;
 var init_config2 = __esm(() => {
   init_envUtils();
   init_state2();
@@ -95407,19 +95431,9 @@ function splitToolResultMedia(content) {
       continue;
     }
     if (block?.type === "image") {
-      const src = block.source;
-      if (src?.type === "base64" && typeof src.data === "string") {
-        images.push({
-          kind: "base64",
-          mediaType: src.media_type ?? "image/png",
-          data: src.data
-        });
-        continue;
-      }
-      if (src?.type === "url" && typeof src.url === "string") {
-        images.push({ kind: "url", url: src.url });
-        continue;
-      }
+      const img = normalizeCanonicalImageSource(block.source);
+      if (img)
+        images.push(img);
       continue;
     }
     if (typeof block?.text === "string") {
@@ -95430,8 +95444,7 @@ function splitToolResultMedia(content) {
 `), images };
 }
 function toResponsesInputImagePart(img) {
-  const url3 = img.kind === "base64" ? `data:${img.mediaType};base64,${img.data}` : img.url;
-  return { type: "input_image", image_url: url3 };
+  return { type: "input_image", image_url: imageSourceToDataUri(img) };
 }
 function convertContentBlocksToResponsesParts(content, role) {
   const textType = role === "assistant" ? "output_text" : "input_text";
@@ -95450,18 +95463,9 @@ function convertContentBlocksToResponsesParts(content, role) {
       case "image": {
         if (role === "assistant")
           break;
-        const source = block.source;
-        if (source?.type === "base64") {
-          parts.push({
-            type: "input_image",
-            image_url: `data:${source.media_type};base64,${source.data}`
-          });
-        } else if (source?.type === "url" && source.url) {
-          parts.push({
-            type: "input_image",
-            image_url: source.url
-          });
-        }
+        const img = normalizeCanonicalImageSource(block.source);
+        if (img)
+          parts.push(toResponsesInputImagePart(img));
         break;
       }
       case "thinking":
@@ -96049,6 +96053,7 @@ var init_shim = __esm(() => {
   init_sdk();
   init_schema();
   init_capabilities2();
+  init_canonical();
 });
 
 // src/providers/shared/providerRecommendation.ts
@@ -96191,19 +96196,9 @@ function splitToolResultMedia2(content) {
       continue;
     }
     if (block?.type === "image") {
-      const source = block.source;
-      if (source?.type === "base64" && typeof source.data === "string") {
-        images.push({
-          kind: "base64",
-          mediaType: source.media_type ?? "image/png",
-          data: source.data
-        });
-        continue;
-      }
-      if (source?.type === "url" && typeof source.url === "string") {
-        images.push({ kind: "url", url: source.url });
-        continue;
-      }
+      const img = normalizeCanonicalImageSource(block.source);
+      if (img)
+        images.push(img);
       continue;
     }
     if (block?.type === "tool_reference" && typeof block.tool_name === "string") {
@@ -96218,8 +96213,7 @@ function splitToolResultMedia2(content) {
 `), images };
 }
 function toOpenAIImageUrl(img) {
-  const url3 = img.kind === "base64" ? `data:${img.mediaType};base64,${img.data}` : img.url;
-  return { type: "image_url", image_url: { url: url3 } };
+  return { type: "image_url", image_url: { url: imageSourceToDataUri(img) } };
 }
 function convertContentBlocks(content) {
   if (typeof content === "string")
@@ -96233,17 +96227,9 @@ function convertContentBlocks(content) {
         parts.push({ type: "text", text: block.text ?? "" });
         break;
       case "image": {
-        const src = block.source;
-        if (src?.type === "base64") {
-          parts.push({
-            type: "image_url",
-            image_url: {
-              url: `data:${src.media_type};base64,${src.data}`
-            }
-          });
-        } else if (src?.type === "url") {
-          parts.push({ type: "image_url", image_url: { url: src.url } });
-        }
+        const img = normalizeCanonicalImageSource(block.source);
+        if (img)
+          parts.push(toOpenAIImageUrl(img));
         break;
       }
       case "tool_use":
@@ -96402,7 +96388,7 @@ function convertChunkUsage(usage) {
   return openaiUsageToAnthropicUsage(usage);
 }
 function toOpenAIChatReasoningEffort(effort) {
-  return effort === "xhigh" ? "high" : effort;
+  return effort;
 }
 function getOpenAIChatProviderCapabilities(model) {
   return {
@@ -96847,7 +96833,14 @@ class OpenAIShimMessages {
     let httpResponse;
     const promise3 = (async () => {
       const overrideTransport = self2.providerOverride?.transport === "anthropic" ? undefined : self2.providerOverride?.transport;
-      const request = resolveProviderRequest({ model: self2.providerOverride?.model ?? params.model, baseUrl: self2.providerOverride?.baseURL, reasoningEffortOverride: self2.reasoningEffort, transportOverride: overrideTransport });
+      const hasProviderReasoningEffortOverride = !!self2.providerOverride && Object.prototype.hasOwnProperty.call(self2.providerOverride, "reasoningEffort");
+      const reasoningEffortOverride = hasProviderReasoningEffortOverride ? self2.providerOverride?.reasoningEffort ?? null : self2.reasoningEffort;
+      const request = resolveProviderRequest({
+        model: self2.providerOverride?.model ?? params.model,
+        baseUrl: self2.providerOverride?.baseURL,
+        ...reasoningEffortOverride !== undefined ? { reasoningEffortOverride } : {},
+        transportOverride: overrideTransport
+      });
       const response = await self2._doRequest(request, params, options);
       httpResponse = response;
       if (params.stream) {
@@ -97120,6 +97113,7 @@ var init_shim2 = __esm(() => {
   init_schemaSanitizer();
   init_providerProfile();
   init_capabilities2();
+  init_canonical();
   OpenAIShimStream = class OpenAIShimStream {
     generator;
     controller = new AbortController;
@@ -130236,15 +130230,16 @@ function isMaxTokensCapEnabled() {
 }
 function getMaxOutputTokensForModel(model, opts) {
   const maxOutputTokens = getModelMaxOutputTokens(model);
-  const defaultTokens = isMaxTokensCapEnabled() ? Math.min(maxOutputTokens.default, CAPPED_DEFAULT_MAX_TOKENS) : maxOutputTokens.default;
+  const upperLimit = opts?.upperLimitOverride !== undefined && Number.isFinite(opts.upperLimitOverride) && opts.upperLimitOverride >= 1 ? Math.floor(opts.upperLimitOverride) : maxOutputTokens.upperLimit;
+  const defaultTokens = isMaxTokensCapEnabled() ? Math.min(maxOutputTokens.default, CAPPED_DEFAULT_MAX_TOKENS, upperLimit) : Math.min(maxOutputTokens.default, upperLimit);
   if (opts?.override !== undefined) {
-    if (!Number.isFinite(opts.override) || opts.override < 1 || opts.override > maxOutputTokens.upperLimit) {
-      console.warn(`[opencow] Options.maxOutputTokens=${opts.override} out of range ` + `[1, ${maxOutputTokens.upperLimit}] for model ${model}; clamping.`);
+    if (!Number.isFinite(opts.override) || opts.override < 1 || opts.override > upperLimit) {
+      console.warn(`[opencow] Options.maxOutputTokens=${opts.override} out of range ` + `[1, ${upperLimit}] for model ${model}; clamping.`);
     }
-    const clamped = Math.min(Math.max(1, Math.floor(opts.override)), maxOutputTokens.upperLimit);
+    const clamped = Math.min(Math.max(1, Math.floor(opts.override)), upperLimit);
     return clamped;
   }
-  const result = validateBoundedIntEnvVar("CLAUDE_CODE_MAX_OUTPUT_TOKENS", resolveEnvVar("MAX_OUTPUT_TOKENS"), defaultTokens, maxOutputTokens.upperLimit);
+  const result = validateBoundedIntEnvVar("CLAUDE_CODE_MAX_OUTPUT_TOKENS", resolveEnvVar("MAX_OUTPUT_TOKENS"), defaultTokens, upperLimit);
   return result.effective;
 }
 var init_maxTokens = __esm(() => {
@@ -255986,6 +255981,13 @@ function getDisableExtglobCommand(shellPath) {
   }
   return null;
 }
+function getHostProvidedPathCommand() {
+  const path11 = getHostProvidedEnvVar("PATH");
+  if (!path11) {
+    return null;
+  }
+  return `export PATH=${quote([path11])}`;
+}
 async function createBashShellProvider(shellPath, options2) {
   let currentSandboxTmpDir;
   const snapshotPromise = options2?.skipSnapshot ? Promise.resolve(undefined) : createAndSaveSnapshot(shellPath).catch((error41) => {
@@ -256026,6 +256028,10 @@ async function createBashShellProvider(shellPath, options2) {
         const finalPath = getPlatform() === "windows" ? windowsPathToPosixPath(snapshotFilePath) : snapshotFilePath;
         commandParts.push(`source ${quote([finalPath])} 2>/dev/null || true`);
       }
+      const hostPathCommand = getHostProvidedPathCommand();
+      if (hostPathCommand) {
+        commandParts.push(hostPathCommand);
+      }
       const sessionEnvScript2 = await getSessionEnvironmentScript();
       if (sessionEnvScript2) {
         commandParts.push(sessionEnvScript2);
@@ -273622,9 +273628,21 @@ var init_mcpWebSocketTransport = __esm(() => {
 });
 
 // src/capabilities/adapters/callToolResultAdapter.ts
+async function buildImageBlock(bytes, mediaType, uploadMedia) {
+  let url3 = null;
+  if (uploadMedia) {
+    try {
+      url3 = await uploadMedia({ bytes, mediaType });
+    } catch (e) {
+      logError(e);
+    }
+  }
+  const source = url3 ? { type: "url", url: url3 } : { type: "base64", media_type: mediaType, data: bytes.toString("base64") };
+  return { type: "image", source };
+}
 async function translateMcpContentItem(input) {
   const { item, options: options2 } = input;
-  const { sourceName } = options2;
+  const { sourceName, uploadMedia } = options2;
   switch (item.type) {
     case "text":
       return [{ type: "text", text: item.text }];
@@ -273642,14 +273660,7 @@ async function translateMcpContentItem(input) {
       const ext = item.mimeType?.split("/")[1] || "png";
       const resized = await maybeResizeAndDownsampleImageBuffer(imageBuffer, imageBuffer.length, ext);
       return [
-        {
-          type: "image",
-          source: {
-            data: resized.buffer.toString("base64"),
-            media_type: `image/${resized.mediaType}`,
-            type: "base64"
-          }
-        }
+        await buildImageBlock(resized.buffer, `image/${resized.mediaType}`, uploadMedia)
       ];
     }
     case "resource": {
@@ -273666,14 +273677,7 @@ async function translateMcpContentItem(input) {
           const resized = await maybeResizeAndDownsampleImageBuffer(imageBuffer, imageBuffer.length, ext);
           return [
             { type: "text", text: prefix },
-            {
-              type: "image",
-              source: {
-                data: resized.buffer.toString("base64"),
-                media_type: `image/${resized.mediaType}`,
-                type: "base64"
-              }
-            }
+            await buildImageBlock(resized.buffer, `image/${resized.mediaType}`, uploadMedia)
           ];
         }
         return await persistBlobToTextBlock({
@@ -273727,6 +273731,7 @@ var IMAGE_MIME_TYPES;
 var init_callToolResultAdapter = __esm(() => {
   init_imageResizer();
   init_mcpOutputStorage();
+  init_log2();
   IMAGE_MIME_TYPES = new Set([
     "image/jpeg",
     "image/png",
@@ -281974,7 +281979,11 @@ async function* queryLoop(params, consumedCommandUuids) {
       if (false) {}
       const mediaRecoveryEnabled = reactiveCompact?.isReactiveCompactEnabled() ?? false;
       if (!compactionResult && querySource !== "compact" && querySource !== "session_memory" && !(reactiveCompact?.isReactiveCompactEnabled() && isAutoCompactEnabled()) && !collapseOwnsIt) {
-        const { isAtBlockingLimit } = calculateTokenWarningState(tokenCountWithEstimation(messagesForQuery) - snipTokensFreed, toolUseContext.options.mainLoopModel);
+        const { isAtBlockingLimit } = calculateTokenWarningState(tokenCountWithEstimation(messagesForQuery) - snipTokensFreed, toolUseContext.options.mainLoopModel, {
+          contextWindow: toolUseContext.options.contextWindow,
+          maxOutputTokens: toolUseContext.options.maxOutputTokens,
+          maxOutputTokensLimit: toolUseContext.options.maxOutputTokensLimit
+        });
         if (isAtBlockingLimit) {
           yield createAssistantAPIErrorMessage({
             content: PROMPT_TOO_LONG_ERROR_MESSAGE,
@@ -282017,6 +282026,7 @@ async function* queryLoop(params, consumedCommandUuids) {
                 allowedAgentTypes: toolUseContext.options.agentDefinitions.allowedAgentTypes,
                 hasAppendSystemPrompt: !!toolUseContext.options.appendSystemPrompt,
                 maxOutputTokensOverride,
+                maxOutputTokensLimitOverride: params.maxOutputTokensLimitOverride,
                 fetchOverride: dumpPromptsFetch,
                 mcpTools: appState.mcp.tools,
                 hasPendingMcpServers: appState.mcp.clients.some((c6) => c6.type === "pending"),
@@ -282692,7 +282702,7 @@ function getAnthropicEnvMetadata() {
 function getBuildAgeMinutes() {
   if (false)
     ;
-  const buildTime = new Date("2026-06-24T03:20:56.844Z").getTime();
+  const buildTime = new Date("2026-06-25T12:29:02.938Z").getTime();
   if (isNaN(buildTime))
     return;
   return Math.floor((Date.now() - buildTime) / 60000);
@@ -283274,6 +283284,7 @@ async function runForkedAgent({
       toolUseContext: isolatedToolUseContext,
       querySource,
       maxOutputTokensOverride: maxOutputTokens,
+      maxOutputTokensLimitOverride: isolatedToolUseContext.options.maxOutputTokensLimit,
       maxTurns,
       skipCacheWrite
     })) {
@@ -283512,7 +283523,17 @@ ${formattedSummary}`;
   if (transcriptPath) {
     baseSummary += `
 
-If you need specific details from before compaction (like exact code snippets, error messages, or content you generated), read the full transcript at: ${transcriptPath}`;
+IMPORTANT — Transcript recovery protocol:
+The full pre-compaction conversation is preserved at: ${transcriptPath}
+When you encounter ANY of these situations, you MUST use the Read tool to search the transcript for the missing context BEFORE responding:
+- You are unsure about a specific detail (file path, function name, error message, code snippet, user preference)
+- The user references something you cannot find in the summary above
+- You need exact code that was previously read or written
+- You are about to make a decision but feel uncertain whether the user already gave guidance on it
+- A tool name, skill name, or configuration was discussed but is not in the summary
+
+The transcript is a JSONL file. Read its tail (last 500–2000 lines) first for the most recent context; if that doesn't resolve the gap, read earlier sections.
+Do NOT guess or hallucinate details that might have been discussed — read the transcript instead.`;
   }
   if (recentMessagesPreserved) {
     baseSummary += `
@@ -283579,6 +283600,7 @@ Your summary should include the following sections:
 8. Current Work: Describe in detail precisely what was being worked on immediately before this summary request, paying special attention to the most recent messages from both user and assistant. Include file names and code snippets where applicable.
 9. Optional Next Step: List the next step that you will take that is related to the most recent work you were doing. IMPORTANT: ensure that this step is DIRECTLY in line with the user's most recent explicit requests, and the task you were working on immediately before this summary request. If your last task was concluded, then only list next steps if they are explicitly in line with the users request. Do not start on tangential requests or really old requests that were already completed without confirming with the user first.
                        If there is a next step, include direct quotes from the most recent conversation showing exactly what task you were working on and where you left off. This should be verbatim to ensure there's no drift in task interpretation.
+10. Uncertain or Incomplete Context: List any items where you are not fully confident in the details — e.g., a tool/skill name you vaguely recall but cannot confirm, a user preference you think was stated but cannot pinpoint, or a decision whose rationale is unclear. Mark each with [NEEDS_TRANSCRIPT_LOOKUP] so the post-compaction assistant knows to read the transcript file for these specific items before acting on them.
 
 Here's an example of how your output should be structured:
 
@@ -283629,10 +283651,14 @@ Here's an example of how your output should be structured:
 9. Optional Next Step:
    [Optional Next step to take]
 
+10. Uncertain or Incomplete Context:
+   - [Item with unclear details] [NEEDS_TRANSCRIPT_LOOKUP]
+   - [...]
+
 </summary>
 </example>
 
-Please provide your summary based on the conversation so far, following this structure and ensuring precision and thoroughness in your response. 
+Please provide your summary based on the conversation so far, following this structure and ensuring precision and thoroughness in your response.
 
 There may be additional summarization instructions provided in the included context. If so, remember to follow these instructions when creating the above summary. Examples of instructions include:
 <example>
@@ -283660,6 +283686,7 @@ Your summary should include the following sections:
 7. Pending Tasks: Outline any pending tasks from the recent messages.
 8. Current Work: Describe precisely what was being worked on immediately before this summary request.
 9. Optional Next Step: List the next step related to the most recent work. Include direct quotes from the most recent conversation.
+10. Uncertain or Incomplete Context: List any items where details are unclear or potentially missing from the recent messages. Mark each with [NEEDS_TRANSCRIPT_LOOKUP].
 
 Here's an example of how your output should be structured:
 
@@ -283700,6 +283727,9 @@ Here's an example of how your output should be structured:
 9. Optional Next Step:
    [Optional Next step to take]
 
+10. Uncertain or Incomplete Context:
+   - [Item with unclear details] [NEEDS_TRANSCRIPT_LOOKUP]
+
 </summary>
 </example>
 
@@ -283720,6 +283750,7 @@ Your summary should include the following sections:
 7. Pending Tasks: Outline any pending tasks.
 8. Work Completed: Describe what was accomplished by the end of this portion.
 9. Context for Continuing Work: Summarize any context, decisions, or state that would be needed to understand and continue the work in subsequent messages.
+10. Uncertain or Incomplete Context: List any items where details are unclear or potentially incomplete. Mark each with [NEEDS_TRANSCRIPT_LOOKUP] so the continuing session knows to look them up in the transcript before acting.
 
 Here's an example of how your output should be structured:
 
@@ -283760,6 +283791,9 @@ Here's an example of how your output should be structured:
 9. Context for Continuing Work:
    [Key context, decisions, or state needed to continue the work]
 
+10. Uncertain or Incomplete Context:
+   - [Item with unclear details] [NEEDS_TRANSCRIPT_LOOKUP]
+
 </summary>
 </example>
 
@@ -284211,7 +284245,10 @@ async function streamCompactSummary({
           toolChoice: undefined,
           isNonInteractiveSession: context4.options.isNonInteractiveSession,
           hasAppendSystemPrompt: !!context4.options.appendSystemPrompt,
-          maxOutputTokensOverride: Math.min(COMPACT_MAX_OUTPUT_TOKENS, getMaxOutputTokensForModel(context4.options.mainLoopModel)),
+          maxOutputTokensOverride: Math.min(COMPACT_MAX_OUTPUT_TOKENS, getMaxOutputTokensForModel(context4.options.mainLoopModel, {
+            upperLimitOverride: context4.options.maxOutputTokensLimit
+          })),
+          maxOutputTokensLimitOverride: context4.options.maxOutputTokensLimit,
           querySource: "compact",
           agents: context4.options.agentDefinitions.activeAgents,
           mcpTools: [],
@@ -284945,7 +284982,10 @@ var init_sessionMemoryCompact = __esm(() => {
 
 // src/controller/compact/autoCompact.ts
 function getEffectiveContextWindowSize(model, opts) {
-  const reservedTokensForSummary = Math.min(getMaxOutputTokensForModel(model, { override: opts?.maxOutputTokens }), MAX_OUTPUT_TOKENS_FOR_SUMMARY);
+  const reservedTokensForSummary = Math.min(getMaxOutputTokensForModel(model, {
+    override: opts?.maxOutputTokens,
+    upperLimitOverride: opts?.maxOutputTokensLimit
+  }), MAX_OUTPUT_TOKENS_FOR_SUMMARY);
   let contextWindow = getContextWindowForModel(model, getSdkBetas(), {
     override: opts?.contextWindow
   });
@@ -285031,7 +285071,8 @@ async function autoCompactIfNeeded(messages, toolUseContext, cacheSafeParams, qu
   const model = toolUseContext.options.mainLoopModel;
   const opts = {
     contextWindow: toolUseContext.options.contextWindow,
-    maxOutputTokens: toolUseContext.options.maxOutputTokens
+    maxOutputTokens: toolUseContext.options.maxOutputTokens,
+    maxOutputTokensLimit: toolUseContext.options.maxOutputTokensLimit
   };
   const shouldCompact = await shouldAutoCompact(messages, model, querySource, snipTokensFreed, opts);
   if (!shouldCompact) {
@@ -286016,6 +286057,16 @@ async function validateContentTokens(content, ext, maxTokens) {
     throw new MaxFileReadTokenExceededError(effectiveCount, effectiveMaxTokens);
   }
 }
+async function maybeUploadBytes(uploadMedia, bytes, mediaType) {
+  if (!uploadMedia)
+    return null;
+  try {
+    return await uploadMedia({ bytes, mediaType });
+  } catch (e) {
+    logError(e);
+    return null;
+  }
+}
 function createImageResponse(buffer, mediaType, originalSize, dimensions) {
   return {
     type: "image",
@@ -286063,6 +286114,10 @@ async function callInner(file_path, fullFilePath, resolvedFilePath, ext, offset,
   if (IMAGE_EXTENSIONS.has(ext)) {
     const data2 = await readImageWithTokenBudget(resolvedFilePath, maxTokens);
     context4.nestedMemoryAttachmentTriggers?.add(fullFilePath);
+    const uploadedUrl = await maybeUploadBytes(context4.uploadMedia, Buffer.from(data2.file.base64, "base64"), data2.file.type);
+    if (uploadedUrl) {
+      data2.file.url = uploadedUrl;
+    }
     logFileOperation({
       operation: "read",
       tool: "FileReadTool",
@@ -286104,14 +286159,14 @@ async function callInner(file_path, fullFilePath, resolvedFilePath, ext, offset,
         const imgPath = path11.join(extractResult.data.file.outputDir, f);
         const imgBuffer = await getFsImplementation().readFile(imgPath);
         const resized = await maybeResizeAndDownsampleImageBuffer(imgBuffer, imgBuffer.length, "jpeg");
-        return {
-          type: "image",
-          source: {
-            type: "base64",
-            media_type: `image/${resized.mediaType}`,
-            data: resized.buffer.toString("base64")
-          }
+        const mediaType = `image/${resized.mediaType}`;
+        const uploadedUrl2 = await maybeUploadBytes(context4.uploadMedia, resized.buffer, mediaType);
+        const source = uploadedUrl2 ? { type: "url", url: uploadedUrl2 } : {
+          type: "base64",
+          media_type: mediaType,
+          data: resized.buffer.toString("base64")
         };
+        return { type: "image", source };
       }));
       return {
         data: extractResult.data,
@@ -286159,20 +286214,17 @@ async function callInner(file_path, fullFilePath, resolvedFilePath, ext, offset,
       filePath: fullFilePath,
       content: pdfData.file.base64
     });
+    const uploadedUrl = await maybeUploadBytes(context4.uploadMedia, Buffer.from(pdfData.file.base64, "base64"), "application/pdf");
+    const documentSource = uploadedUrl ? { type: "url", url: uploadedUrl } : {
+      type: "base64",
+      media_type: "application/pdf",
+      data: pdfData.file.base64
+    };
     return {
       data: pdfData,
       newMessages: [
         createUserMessage({
-          content: [
-            {
-              type: "document",
-              source: {
-                type: "base64",
-                media_type: "application/pdf",
-                data: pdfData.file.base64
-              }
-            }
-          ],
+          content: [{ type: "document", source: documentSource }],
           isMeta: true
         })
       ]
@@ -286379,6 +286431,7 @@ var init_FileReadTool = __esm(() => {
           base64: exports_external2.string().describe("Base64-encoded image data"),
           type: imageMediaTypes.describe("The MIME type of the image"),
           originalSize: exports_external2.number().describe("Original file size in bytes"),
+          url: exports_external2.string().optional().describe("Fetchable URL for the (compressed) image when a host uploader is configured; takes precedence over base64 for rendering"),
           dimensions: exports_external2.object({
             originalWidth: exports_external2.number().optional().describe("Original image width in pixels"),
             originalHeight: exports_external2.number().optional().describe("Original image height in pixels"),
@@ -286607,17 +286660,18 @@ var init_FileReadTool = __esm(() => {
     mapToolResultToToolResultBlockParam(data, toolUseID) {
       switch (data.type) {
         case "image": {
+          const source = data.file.url ? { type: "url", url: data.file.url } : {
+            type: "base64",
+            data: data.file.base64,
+            media_type: data.file.type
+          };
           return {
             tool_use_id: toolUseID,
             type: "tool_result",
             content: [
               {
                 type: "image",
-                source: {
-                  type: "base64",
-                  data: data.file.base64,
-                  media_type: data.file.type
-                }
+                source
               }
             ]
           };
@@ -293772,7 +293826,10 @@ ${deferredToolList}
         betasParams.push(STRUCTURED_OUTPUTS_BETA_HEADER);
       }
     }
-    const maxOutputTokens2 = retryContext?.maxTokensOverride || options2.maxOutputTokensOverride || getMaxOutputTokensForModel(options2.model);
+    const maxOutputTokens2 = retryContext?.maxTokensOverride || getMaxOutputTokensForModel(options2.model, {
+      override: options2.maxOutputTokensOverride,
+      upperLimitOverride: options2.maxOutputTokensLimitOverride
+    });
     const hasThinking = thinkingConfig.type !== "disabled" && !isEnvTruthy(resolveEnvVar("DISABLE_THINKING"));
     let thinking = undefined;
     if (hasThinking && modelSupportsThinking(options2.model)) {
@@ -299734,8 +299791,10 @@ async function processUserInputBase(input, mode, setToolJSX, context4, pastedCon
       }
     }
   }
+  const processSlashCommand = getProcessSlashCommand();
   if (false) {}
-  const shouldExtractAttachments = !skipAttachments && inputString !== null && (mode !== "prompt" || effectiveSkipSlash || !inputString.startsWith("/"));
+  const shouldFallbackSlashToPrompt = inputString !== null && mode === "prompt" && !effectiveSkipSlash && inputString.startsWith("/") && !processSlashCommand;
+  const shouldExtractAttachments = !skipAttachments && inputString !== null && (mode !== "prompt" || effectiveSkipSlash || !inputString.startsWith("/") || shouldFallbackSlashToPrompt);
   queryCheckpoint("query_attachment_loading_start");
   const attachmentMessages = shouldExtractAttachments ? await toArray2(getAttachmentMessages(inputString, context4, ideSelection ?? null, [], messages, querySource)) : [];
   queryCheckpoint("query_attachment_loading_end");
@@ -299746,11 +299805,10 @@ async function processUserInputBase(input, mode, setToolJSX, context4, pastedCon
     return addImageMetadataMessage(await processBashCommand(inputString, precedingInputBlocks, attachmentMessages, context4, setToolJSX), imageMetadataTexts);
   }
   if (inputString !== null && !effectiveSkipSlash && inputString.startsWith("/")) {
-    const processSlashCommand = getProcessSlashCommand();
-    if (!processSlashCommand)
-      throw new SlashCommandHandlerNotRegisteredError("slash");
-    const slashResult = await processSlashCommand(inputString, precedingInputBlocks, imageContentBlocks, attachmentMessages, context4, setToolJSX, uuid3, isAlreadyProcessing, canUseTool);
-    return addImageMetadataMessage(slashResult, imageMetadataTexts);
+    if (processSlashCommand) {
+      const slashResult = await processSlashCommand(inputString, precedingInputBlocks, imageContentBlocks, attachmentMessages, context4, setToolJSX, uuid3, isAlreadyProcessing, canUseTool);
+      return addImageMetadataMessage(slashResult, imageMetadataTexts);
+    }
   }
   if (inputString !== null && mode === "prompt") {
     const trimmedInput = inputString.trim();
@@ -299997,6 +300055,7 @@ class QueryEngine {
       maxTurns,
       maxBudgetUsd,
       maxOutputTokens,
+      maxOutputTokensLimit,
       contextWindow,
       compact,
       taskBudget,
@@ -300013,6 +300072,7 @@ class QueryEngine {
       agents = [],
       setSDKStatus,
       onToolInvoke,
+      uploadMedia,
       orphanedPermission
     } = this.config;
     this.discoveredSkillNames.clear();
@@ -300085,6 +300145,7 @@ class QueryEngine {
         theme: resolveThemeSetting(getGlobalConfig().theme),
         maxBudgetUsd,
         maxOutputTokens,
+        maxOutputTokensLimit,
         contextWindow,
         modelProviders: this.config.modelProviders,
         subagentDisallowedTools: this.config.subagentDisallowedTools
@@ -300116,7 +300177,8 @@ class QueryEngine {
         });
       },
       setSDKStatus,
-      onToolInvoke
+      onToolInvoke,
+      uploadMedia
     };
     if (orphanedPermission && !this.hasHandledOrphanedPermission) {
       this.hasHandledOrphanedPermission = true;
@@ -300189,6 +300251,7 @@ class QueryEngine {
         agentDefinitions: { activeAgents: agents, allAgents: [] },
         maxBudgetUsd,
         maxOutputTokens,
+        maxOutputTokensLimit,
         contextWindow,
         modelProviders: this.config.modelProviders,
         subagentDisallowedTools: this.config.subagentDisallowedTools
@@ -300205,7 +300268,8 @@ class QueryEngine {
       setResponseLength: () => {},
       updateFileHistoryState: processUserInputContext.updateFileHistoryState,
       updateAttributionState: processUserInputContext.updateAttributionState,
-      setSDKStatus
+      setSDKStatus,
+      uploadMedia
     };
     headlessProfilerCheckpoint("before_skills_plugins");
     const [skills, { enabled: enabledPlugins }] = await Promise.all([
@@ -300308,6 +300372,7 @@ class QueryEngine {
       querySource: "sdk",
       maxTurns,
       maxOutputTokensOverride: maxOutputTokens,
+      maxOutputTokensLimitOverride: maxOutputTokensLimit,
       compactRequest: compact,
       taskBudget
     })) {
@@ -300678,6 +300743,7 @@ async function* ask({
   maxTurns,
   maxBudgetUsd,
   maxOutputTokens,
+  maxOutputTokensLimit,
   contextWindow,
   compact,
   taskBudget,
@@ -300700,6 +300766,7 @@ async function* ask({
   agents = [],
   setSDKStatus,
   onToolInvoke,
+  uploadMedia,
   orphanedPermission
 }) {
   const engine = new QueryEngine({
@@ -300722,6 +300789,7 @@ async function* ask({
     maxTurns,
     maxBudgetUsd,
     maxOutputTokens,
+    maxOutputTokensLimit,
     contextWindow,
     compact,
     taskBudget,
@@ -300732,6 +300800,7 @@ async function* ask({
     includePartialMessages,
     setSDKStatus,
     onToolInvoke,
+    uploadMedia,
     abortController,
     orphanedPermission,
     ...{}
@@ -329479,7 +329548,7 @@ function toInternalTool(sdkTool) {
       });
       const content = await translateCallToolResultContent({
         content: result.content,
-        options: { sourceName: sdkTool.name }
+        options: { sourceName: sdkTool.name, uploadMedia: context4.uploadMedia }
       });
       return { data: content };
     }
@@ -329742,14 +329811,20 @@ function normalizeInitialMessages(raw) {
 }
 function optionsWithProviderRoutingEnv(options2) {
   const transport = options2.transport;
+  const reasoningEffort = options2.reasoningEffort;
   const openaiResponses = options2.providerSpecific?.openaiResponses;
-  if (transport === undefined && openaiResponses === undefined) {
+  if (transport === undefined && reasoningEffort === undefined && openaiResponses === undefined) {
     return options2;
   }
   const mergedEnv = { ...options2.env ?? {} };
   if (typeof transport === "string" && transport.length > 0) {
     mergedEnv[QUERY_ENV_KEY_TRANSPORT_OVERRIDE] = transport;
   }
+  if (reasoningEffort === null) {
+    mergedEnv[QUERY_ENV_KEY_REASONING_EFFORT_OVERRIDE] = QUERY_ENV_VALUE_REASONING_EFFORT_CLEAR;
+  } else if (typeof reasoningEffort === "string" && reasoningEffort.length > 0) {
+    mergedEnv[QUERY_ENV_KEY_REASONING_EFFORT_OVERRIDE] = reasoningEffort;
+  }
   if (openaiResponses && typeof openaiResponses === "object") {
     mergedEnv[QUERY_ENV_KEY_PROVIDER_SPECIFIC_OPENAI_RESPONSES] = JSON.stringify(openaiResponses);
   }
@@ -329979,6 +330054,7 @@ function runSdkQueryRuntime(params) {
           maxTurns: options2.maxTurns,
           maxBudgetUsd: options2.maxBudgetUsd,
           maxOutputTokens: options2.maxOutputTokens,
+          maxOutputTokensLimit: options2.maxOutputTokensLimit,
           contextWindow: options2.contextWindow,
           compact: options2.compact,
           taskBudget: options2.taskBudget,
@@ -330002,6 +330078,7 @@ function runSdkQueryRuntime(params) {
           includePartialMessages: Boolean(options2.includePartialMessages),
           agents: mergedAgents,
           onToolInvoke: typeof options2.onToolInvoke === "function" ? options2.onToolInvoke : undefined,
+          uploadMedia: typeof options2.uploadMedia === "function" ? options2.uploadMedia : undefined,
           setSDKStatus: (status) => {
             turnStatusStream.enqueue({
               type: "system",
@@ -336055,4 +336132,4 @@ export {
   AbortError2 as AbortError
 };
 
-//# debugId=7376AE95E91B9BFD64756E2164756E21
+//# debugId=F19FA9D2F1AEFB9664756E2164756E21