@core-ai/core-ai 0.19.0 → 0.21.0

package/dist/index.d.ts

@@ -4,6 +4,11 @@ type Message = SystemMessage | UserMessage | AssistantMessage | ToolResultMessag
 type SystemMessage = {
     role: 'system';
     content: string;
+    /**
+     * Application-owned metadata for this message. Provider adapters ignore
+     * this field and never serialize it to provider APIs.
+     */
+    metadata?: Record<string, unknown>;
 };
 type UserMessage = {
     role: 'user';
@@ -67,20 +72,35 @@ type ReasoningPart = {
     metadata?: Record<string, unknown>;
     /**
      * Provider-namespaced metadata for this reasoning block. The top-level key is
-     * the provider identifier (e.g. `'anthropic'`, `'openai'`), which also serves as
-     * the ownership discriminator: an adapter checks for the presence of its own key
-     * to detect cross-provider blocks. Cross-provider blocks are downgraded to plain
-     * text (preserving context) rather than forwarding opaque metadata that would
-     * cause an API error on the receiving provider.
+     * the provider identifier (e.g. `'anthropic'`, `'openai'`, `'azure-openai'`),
+     * which also serves as the ownership discriminator: an adapter checks for the
+     * presence of its own key to detect cross-provider blocks. Cross-provider
+     * blocks are downgraded to plain text (preserving context) rather than
+     * forwarding opaque metadata that would cause an API error on the receiving
+     * provider.
      *
-     * @example Anthropic: `{ anthropic: { signature: '...' } }`
-     * @example OpenAI:    `{ openai: { encryptedContent: '...' } }`
+     * @example Anthropic:    `{ anthropic: { signature: '...' } }`
+     * @example OpenAI:       `{ openai: { encryptedContent: '...' } }`
+     * @example Azure OpenAI: `{ 'azure-openai': { encryptedContent: '...' } }`
      */
     providerMetadata?: Record<string, Record<string, unknown>>;
 };
 type ToolCallPart = {
     type: 'tool-call';
     toolCall: ToolCall;
+    /**
+     * Provider-namespaced metadata for this tool call. The top-level key is the
+     * provider identifier and serves as the ownership discriminator, exactly as
+     * for `ReasoningPart`: an adapter only forwards metadata stored under its
+     * own key and ignores blocks produced by another provider.
+     *
+     * Some providers require this data to be replayed verbatim. Gemini 3 rejects
+     * a request when a function call from the current turn is sent back without
+     * the thought signature it was issued with.
+     *
+     * @example Google: `{ google: { thoughtSignature: '...' } }`
+     */
+    providerMetadata?: Record<string, Record<string, unknown>>;
 };
 type AssistantContentPart = AssistantTextPart | ReasoningPart | ToolCallPart;
 type AssistantMessage = {
@@ -310,6 +330,7 @@ type StreamEvent = {
 } | {
     type: 'tool-call-end';
     toolCall: ToolCall;
+    providerMetadata?: Record<string, Record<string, unknown>>;
 } | {
     type: 'finish';
     finishReason: FinishReason;

package/dist/index.js

@@ -743,14 +743,15 @@ function createChatStream(source, options = {}) {
     }
     textBuffer += text;
   };
-  const appendToolCall = (toolCall) => {
+  const appendToolCall = (toolCall, providerMetadata) => {
     flushText();
     insideText = false;
     flushReasoning();
     insideReasoning = false;
     parts.push({
       type: "tool-call",
-      toolCall
+      toolCall,
+      ...providerMetadata ? { providerMetadata } : {}
     });
   };
   const setFinish = (event) => {
@@ -806,7 +807,7 @@ function createChatStream(source, options = {}) {
           endText(event.metadata);
           break;
         case "tool-call-end":
-          appendToolCall(event.toolCall);
+          appendToolCall(event.toolCall, event.providerMetadata);
           break;
         case "finish":
           setFinish(event);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@core-ai/core-ai",
-    "version": "0.19.0",
+    "version": "0.21.0",
     "description": "Type-safe LLM abstraction layer over native provider SDKs",
     "license": "MIT",
     "author": "Omnifact (https://omnifact.ai)",