@opencow-ai/opencow-agent-sdk 0.4.10 → 0.4.12

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>;
@@ -143,6 +159,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.10",
+  "version": "0.4.12",
   "description": "Claude Code opened to any LLM — OpenAI, Gemini, DeepSeek, Ollama, and 200+ models",
   "type": "module",
   "main": "./dist/sdk.js",