@core-ai/core-ai 0.13.0 → 0.14.0

package/dist/index.d.ts

@@ -13,6 +13,11 @@ type UserContentPart = TextPart | ImagePart | FilePart;
 type TextPart = {
     type: 'text';
     text: string;
+    /**
+     * Application-owned metadata for this part. Provider adapters ignore this
+     * field and never serialize it to provider APIs.
+     */
+    metadata?: Record<string, unknown>;
 };
 type ImagePart = {
     type: 'image';
@@ -38,10 +43,20 @@ type ReasoningConfig = {
 type AssistantTextPart = {
     type: 'text';
     text: string;
+    /**
+     * Application-owned metadata for this part. Provider adapters ignore this
+     * field and never serialize it to provider APIs.
+     */
+    metadata?: Record<string, unknown>;
 };
 type ReasoningPart = {
     type: 'reasoning';
     text: string;
+    /**
+     * Application-owned metadata for this part. Provider adapters ignore this
+     * field and never serialize it to provider APIs.
+     */
+    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
@@ -68,12 +83,22 @@ type ToolCall = {
     id: string;
     name: string;
     arguments: Record<string, unknown>;
+    /**
+     * Application-owned metadata for this tool call. Provider adapters ignore
+     * this field and never serialize it to provider APIs.
+     */
+    metadata?: Record<string, unknown>;
 };
 type ToolResultMessage = {
     role: 'tool';
     toolCallId: string;
     content: string;
     isError?: boolean;
+    /**
+     * Application-owned metadata for this tool result. Provider adapters ignore
+     * this field and never serialize it to provider APIs.
+     */
+    metadata?: Record<string, unknown>;
 };
 type ToolDefinition = {
     name: string;
@@ -230,10 +255,16 @@ type StreamEvent = {
     text: string;
 } | {
     type: 'reasoning-end';
+    metadata?: Record<string, unknown>;
     providerMetadata?: Record<string, Record<string, unknown>>;
+} | {
+    type: 'text-start';
 } | {
     type: 'text-delta';
     text: string;
+} | {
+    type: 'text-end';
+    metadata?: Record<string, unknown>;
 } | {
     type: 'tool-call-start';
     toolCallId: string;

package/dist/index.js

@@ -423,8 +423,11 @@ function createChatStream(source, options = {}) {
   })() : source;
   const parts = [];
   let textBuffer = "";
+  let textMetadata;
   let reasoningBuffer = "";
+  let reasoningMetadata;
   let reasoningProviderMetadata;
+  let insideText = false;
   let insideReasoning = false;
   let finishReason = "unknown";
   let usage = {
@@ -438,52 +441,78 @@ function createChatStream(source, options = {}) {
   };
   const flushText = () => {
     if (textBuffer.length === 0) {
+      textMetadata = void 0;
       return;
     }
     parts.push({
       type: "text",
-      text: textBuffer
+      text: textBuffer,
+      ...textMetadata ? { metadata: textMetadata } : {}
     });
     textBuffer = "";
+    textMetadata = void 0;
   };
   const flushReasoning = () => {
     if (reasoningBuffer.length === 0 && reasoningProviderMetadata === void 0) {
+      reasoningMetadata = void 0;
       return;
     }
     parts.push({
       type: "reasoning",
       text: reasoningBuffer,
+      ...reasoningMetadata ? { metadata: reasoningMetadata } : {},
       ...reasoningProviderMetadata ? { providerMetadata: reasoningProviderMetadata } : {}
     });
     reasoningBuffer = "";
+    reasoningMetadata = void 0;
     reasoningProviderMetadata = void 0;
   };
+  const startText = () => {
+    if (insideReasoning) {
+      flushReasoning();
+      insideReasoning = false;
+    }
+    flushText();
+    insideText = true;
+  };
   const startReasoning = () => {
     flushText();
+    insideText = false;
     flushReasoning();
     insideReasoning = true;
   };
   const appendReasoning = (text) => {
     if (!insideReasoning) {
       flushText();
+      insideText = false;
       insideReasoning = true;
     }
     reasoningBuffer += text;
   };
-  const endReasoning = (providerMetadata) => {
+  const endReasoning = (providerMetadata, metadata) => {
     reasoningProviderMetadata = providerMetadata;
+    reasoningMetadata = metadata;
     flushReasoning();
     insideReasoning = false;
   };
+  const endText = (metadata) => {
+    textMetadata = metadata;
+    flushText();
+    insideText = false;
+  };
   const appendText = (text) => {
     if (insideReasoning) {
       flushReasoning();
       insideReasoning = false;
     }
+    if (!insideText) {
+      insideText = true;
+    }
     textBuffer += text;
   };
   const appendToolCall = (toolCall) => {
     flushText();
+    insideText = false;
     flushReasoning();
     insideReasoning = false;
     parts.push({
@@ -525,6 +554,9 @@ function createChatStream(source, options = {}) {
     signal,
     reduceEvent(event) {
       switch (event.type) {
+        case "text-start":
+          startText();
+          break;
         case "reasoning-start":
           startReasoning();
           break;
@@ -532,11 +564,14 @@ function createChatStream(source, options = {}) {
           appendReasoning(event.text);
           break;
         case "reasoning-end":
-          endReasoning(event.providerMetadata);
+          endReasoning(event.providerMetadata, event.metadata);
           break;
         case "text-delta":
           appendText(event.text);
           break;
+        case "text-end":
+          endText(event.metadata);
+          break;
         case "tool-call-end":
           appendToolCall(event.toolCall);
           break;

package/package.json

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