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

package/dist/session/canonical/imageSource.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Shared, url-aware normalization for canonical image sources.
+ *
+ * Canonical image blocks carry a discriminated `source` union
+ * (`CanonicalImageSource`: base64 | url). Every wire adapter that has to
+ * render an image — OpenAI Chat Completions, OpenAI Responses, and the
+ * tool_result fan-out on both — needs the same "is this base64 or a url"
+ * decision. This module owns that single decision so the providers stay in
+ * lock-step (truthiness checks, the `image/png` fallback, and "drop unknown
+ * sources silently" all live here, not duplicated four times).
+ */
+/** Result of normalizing a raw image `source` into a wire-agnostic shape. */
+export type NormalizedImageSource = {
+    kind: 'base64';
+    mediaType: string;
+    data: string;
+} | {
+    kind: 'url';
+    url: string;
+};
+/**
+ * Reduce a raw (untrusted) image `source` to a normalized base64/url shape,
+ * or `null` when it is neither. Callers treat `null` as "drop this image"
+ * — silently, to avoid smuggling a misleading placeholder into the model's
+ * context.
+ *
+ * Takes `unknown` because the source arrives off a loosely-typed message
+ * payload (history replay, MCP tool output) where the discriminant is not
+ * statically guaranteed.
+ */
+export declare function normalizeCanonicalImageSource(source: unknown): NormalizedImageSource | null;
+/**
+ * Render a normalized image as a single string usable wherever a wire format
+ * wants one field: a `data:` URI for base64, or the url verbatim. Used by the
+ * OpenAI `image_url` and Responses `input_image` parts.
+ */
+export declare function imageSourceToDataUri(img: NormalizedImageSource): string;

package/dist/session/canonical/index.d.ts

@@ -5,4 +5,5 @@
  * future refactors (e.g. splitting types/runtime validators/brands) do
  * not ripple through consumer imports.
  */
-export { CANONICAL_VERSION, CanonicalAPIError, CanonicalUserAbortError, type CanonicalBase64ImageSource, type CanonicalContentBlock, type CanonicalContentBlockParam, type CanonicalImageBlockParam, type CanonicalMessage, type CanonicalMessageParam, type CanonicalStreamEvent, type CanonicalTextBlock, type CanonicalTextBlockParam, type CanonicalRedactedThinkingBlock, type CanonicalRedactedThinkingBlockParam, type CanonicalThinkingBlock, type CanonicalThinkingBlockParam, type CanonicalToolResultBlockParam, type CanonicalToolUnion, type CanonicalToolUseBlock, type CanonicalToolUseBlockParam, type CanonicalUsage, type CanonicalVersion, } from './types.js';
+export { CANONICAL_VERSION, CanonicalAPIError, CanonicalUserAbortError, type CanonicalBase64ImageSource, type CanonicalURLImageSource, type CanonicalImageSource, type CanonicalContentBlock, type CanonicalContentBlockParam, type CanonicalImageBlockParam, type CanonicalMessage, type CanonicalMessageParam, type CanonicalStreamEvent, type CanonicalTextBlock, type CanonicalTextBlockParam, type CanonicalRedactedThinkingBlock, type CanonicalRedactedThinkingBlockParam, type CanonicalThinkingBlock, type CanonicalThinkingBlockParam, type CanonicalToolResultBlockParam, type CanonicalToolUnion, type CanonicalToolUseBlock, type CanonicalToolUseBlockParam, type CanonicalUsage, type CanonicalVersion, } from './types.js';
+export { imageSourceToDataUri, normalizeCanonicalImageSource, type NormalizedImageSource, } from './imageSource.js';

package/dist/session/canonical/types.d.ts

@@ -45,7 +45,7 @@
  * `src/session/canonical/index.js`.
  */
 import { APIError, APIUserAbortError } from '@anthropic-ai/sdk';
-import type { BetaBase64ImageSource, BetaContentBlock, BetaContentBlockParam, BetaImageBlockParam, BetaMessage, BetaMessageParam, BetaRawMessageStreamEvent, BetaRedactedThinkingBlock, BetaRedactedThinkingBlockParam, BetaTextBlock, BetaTextBlockParam, BetaThinkingBlock, BetaThinkingBlockParam, BetaToolResultBlockParam, BetaToolUnion, BetaToolUseBlock, BetaToolUseBlockParam, BetaUsage } from '@anthropic-ai/sdk/resources/beta/messages/messages.mjs';
+import type { BetaBase64ImageSource, BetaURLImageSource, BetaContentBlock, BetaContentBlockParam, BetaImageBlockParam, BetaMessage, BetaMessageParam, BetaRawMessageStreamEvent, BetaRedactedThinkingBlock, BetaRedactedThinkingBlockParam, BetaTextBlock, BetaTextBlockParam, BetaThinkingBlock, BetaThinkingBlockParam, BetaToolResultBlockParam, BetaToolUnion, BetaToolUseBlock, BetaToolUseBlockParam, BetaUsage } from '@anthropic-ai/sdk/resources/beta/messages/messages.mjs';
 export type CanonicalVersion = 'v1';
 /**
  * Current canonical schema version. Consumers that persist canonical
@@ -98,6 +98,10 @@ export type CanonicalStreamEvent = BetaRawMessageStreamEvent;
 export type CanonicalImageBlockParam = BetaImageBlockParam;
 /** Base64-encoded image source inside an image block. */
 export type CanonicalBase64ImageSource = BetaBase64ImageSource;
+/** External-URL image source inside an image block. */
+export type CanonicalURLImageSource = BetaURLImageSource;
+/** Discriminated union of every image-source variant carried by an image block. */
+export type CanonicalImageSource = CanonicalBase64ImageSource | CanonicalURLImageSource;
 /** Token-usage metadata carried on assistant messages and deltas. */
 export type CanonicalUsage = BetaUsage;
 /**

package/dist/types/toolRuntime.d.ts

@@ -48,6 +48,22 @@ export type ValidationResult = {
     message: string;
     errorCode: number;
 };
+/**
+ * Host-supplied media uploader (see `Options.uploadMedia`). Given media
+ * bytes + media type, returns a fetchable URL the model side can render,
+ * or `null` when upload is unavailable. Media-neutral: serves any binary a
+ * tool produces (image / PDF / extracted page image, ...), driven by
+ * `mediaType`. The SDK passes the **compressed** buffer (post token-budget),
+ * so the materialized bytes stay bounded.
+ *
+ * Returning `null` or throwing means "uploader unavailable" — callers fall
+ * back to inline base64. Pure port: no SDK/CLI behavior depends on it being
+ * set, so standalone runs are unaffected.
+ */
+export type UploadMediaFn = (input: {
+    bytes: Uint8Array;
+    mediaType: string;
+}) => Promise<string | null>;
 export type ToolPermissionContext = DeepImmutable<{
     mode: PermissionMode;
     additionalWorkingDirectories: Map<string, AdditionalWorkingDirectory>;
@@ -96,6 +112,7 @@ export type ToolRuntimeContext = {
         agentDefinitions: AgentDefinitionsResult;
         maxBudgetUsd?: number;
         maxOutputTokens?: number;
+        maxOutputTokensLimit?: number;
         contextWindow?: number;
         customSystemPrompt?: string;
         appendSystemPrompt?: string;
@@ -143,6 +160,13 @@ export type ToolRuntimeContext = {
         toolInput: Record<string, unknown>;
         toolUseId: string;
     }) => void | Promise<void>;
+    /**
+     * Host-injected media uploader (see `Options.uploadMedia`). When present,
+     * media-producing tools (FileReadTool) upload the compressed bytes and
+     * carry a URL instead of inline base64. Absent → base64 (zero-config
+     * standalone behavior).
+     */
+    uploadMedia?: UploadMediaFn;
     updateFileHistoryState: (updater: (prev: FileHistoryState) => FileHistoryState) => void;
     updateAttributionState: (updater: (prev: AttributionState) => AttributionState) => void;
     setConversationId?: (id: UUID) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencow-ai/opencow-agent-sdk",
-  "version": "0.4.11",
+  "version": "0.4.13",
   "description": "Claude Code opened to any LLM — OpenAI, Gemini, DeepSeek, Ollama, and 200+ models",
   "type": "module",
   "main": "./dist/sdk.js",