@core-ai/core-ai 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -281,15 +281,21 @@ type GeneratedImage = {
     revisedPrompt?: string;
 };
 
-declare class LLMError extends Error {
+declare class CoreAIError extends Error {
     readonly cause?: unknown;
-    constructor(message: string, cause?: unknown);
+    readonly provider?: string;
+    constructor(message: string, cause?: unknown, provider?: string);
 }
-declare class StreamAbortedError extends LLMError {
-    constructor(message?: string, cause?: unknown);
+declare class ValidationError extends CoreAIError {
+    constructor(message: string, cause?: unknown, provider?: string);
 }
-declare class ProviderError extends LLMError {
-    readonly provider: string;
+declare class AbortedError extends CoreAIError {
+    constructor(cause?: unknown, provider?: string);
+}
+declare class StreamAbortedError extends AbortedError {
+    constructor(cause?: unknown, provider?: string);
+}
+declare class ProviderError extends CoreAIError {
     readonly statusCode?: number;
     constructor(message: string, provider: string, statusCode?: number, cause?: unknown);
 }
@@ -298,7 +304,8 @@ type StructuredOutputErrorOptions = {
     cause?: unknown;
     rawOutput?: string;
 };
-declare class StructuredOutputError extends ProviderError {
+declare class StructuredOutputError extends CoreAIError {
+    readonly statusCode?: number;
     readonly rawOutput?: string;
     constructor(message: string, provider: string, options?: StructuredOutputErrorOptions);
 }
@@ -321,6 +328,11 @@ declare function defineTool(options: ToolDefinition): ToolDefinition;
  */
 declare function zodSchemaToJsonSchema(schema: z.ZodType): Record<string, unknown>;
 
+declare function stripModelDateSuffix(modelId: string): string;
+
+declare function asObject(value: unknown): Record<string, unknown>;
+declare function safeParseJsonObject(json: string): Record<string, unknown>;
+
 type ResultToMessageOptions = {
     includeReasoning?: boolean;
 };
@@ -366,4 +378,4 @@ type GenerateImageParams = ImageGenerateOptions & {
 };
 declare function generateImage(params: GenerateImageParams): Promise<ImageGenerateResult>;
 
-export { type AssistantContentPart, type AssistantMessage, type AssistantTextPart, type BaseGenerateOptions, type ChatInputTokenDetails, type ChatModel, type ChatOutputTokenDetails, type ChatStream, type ChatUsage, type EmbedOptions, type EmbedProviderOptions, type EmbedResult, type EmbeddingModel, type EmbeddingUsage, type FilePart, type FinishReason, type GenerateObjectOptions, type GenerateObjectResult, type GenerateOptions, type GenerateProviderOptions, type GenerateResult, type GeneratedImage, type ImageGenerateOptions, type ImageGenerateResult, type ImageModel, type ImagePart, type ImageProviderOptions, LLMError, type Message, type ObjectStream, type ObjectStreamEvent, ProviderError, type ReasoningConfig, type ReasoningEffort, type ReasoningPart, StreamAbortedError, type StreamEvent, type StreamObjectOptions, StructuredOutputError, StructuredOutputNoObjectGeneratedError, StructuredOutputParseError, StructuredOutputValidationError, type SystemMessage, type TextPart, type ToolCall, type ToolCallPart, type ToolChoice, type ToolDefinition, type ToolResultMessage, type ToolSet, type UserContentPart, type UserMessage, assistantMessage, createChatStream, createObjectStream, defineTool, embed, generate, generateImage, generateObject, getProviderMetadata, resultToMessage, stream, streamObject, zodSchemaToJsonSchema };
+export { AbortedError, type AssistantContentPart, type AssistantMessage, type AssistantTextPart, type BaseGenerateOptions, type ChatInputTokenDetails, type ChatModel, type ChatOutputTokenDetails, type ChatStream, type ChatUsage, CoreAIError, type EmbedOptions, type EmbedProviderOptions, type EmbedResult, type EmbeddingModel, type EmbeddingUsage, type FilePart, type FinishReason, type GenerateObjectOptions, type GenerateObjectResult, type GenerateOptions, type GenerateProviderOptions, type GenerateResult, type GeneratedImage, type ImageGenerateOptions, type ImageGenerateResult, type ImageModel, type ImagePart, type ImageProviderOptions, type Message, type ObjectStream, type ObjectStreamEvent, ProviderError, type ReasoningConfig, type ReasoningEffort, type ReasoningPart, StreamAbortedError, type StreamEvent, type StreamObjectOptions, StructuredOutputError, StructuredOutputNoObjectGeneratedError, StructuredOutputParseError, StructuredOutputValidationError, type SystemMessage, type TextPart, type ToolCall, type ToolCallPart, type ToolChoice, type ToolDefinition, type ToolResultMessage, type ToolSet, type UserContentPart, type UserMessage, ValidationError, asObject, assistantMessage, createChatStream, createObjectStream, defineTool, embed, generate, generateImage, generateObject, getProviderMetadata, resultToMessage, safeParseJsonObject, stream, streamObject, stripModelDateSuffix, zodSchemaToJsonSchema };

package/dist/index.js

@@ -1,33 +1,48 @@
 // src/errors.ts
-var LLMError = class extends Error {
+var CoreAIError = class extends Error {
   cause;
-  constructor(message, cause) {
+  provider;
+  constructor(message, cause, provider) {
     super(message);
-    this.name = "LLMError";
+    this.name = "CoreAIError";
     this.cause = cause;
+    this.provider = provider;
+  }
+};
+var ValidationError = class extends CoreAIError {
+  constructor(message, cause, provider) {
+    super(message, cause, provider);
+    this.name = "ValidationError";
   }
 };
-var StreamAbortedError = class extends LLMError {
-  constructor(message = "stream aborted", cause) {
-    super(message, cause);
+var AbortedError = class extends CoreAIError {
+  constructor(cause, provider) {
+    super("operation aborted", cause, provider);
+    this.name = "AbortedError";
+  }
+};
+var StreamAbortedError = class extends AbortedError {
+  constructor(cause, provider) {
+    super(cause, provider);
     this.name = "StreamAbortedError";
+    this.message = "stream aborted";
   }
 };
-var ProviderError = class extends LLMError {
-  provider;
+var ProviderError = class extends CoreAIError {
   statusCode;
   constructor(message, provider, statusCode, cause) {
-    super(message, cause);
+    super(message, cause, provider);
     this.name = "ProviderError";
-    this.provider = provider;
     this.statusCode = statusCode;
   }
 };
-var StructuredOutputError = class extends ProviderError {
+var StructuredOutputError = class extends CoreAIError {
+  statusCode;
   rawOutput;
   constructor(message, provider, options = {}) {
-    super(message, provider, options.statusCode, options.cause);
+    super(message, options.cause, provider);
     this.name = "StructuredOutputError";
+    this.statusCode = options.statusCode;
     this.rawOutput = options.rawOutput;
   }
 };
@@ -65,6 +80,27 @@ function zodSchemaToJsonSchema(schema) {
   });
 }
 
+// src/model-id.ts
+var MODEL_DATE_SUFFIX_PATTERN = /-\d{8}$/;
+function stripModelDateSuffix(modelId) {
+  return modelId.replace(MODEL_DATE_SUFFIX_PATTERN, "");
+}
+
+// src/provider-utils.ts
+function asObject(value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  return {};
+}
+function safeParseJsonObject(json) {
+  try {
+    return asObject(JSON.parse(json));
+  } catch {
+    return {};
+  }
+}
+
 // src/result-to-message.ts
 function resultToMessage(result, options) {
   const includeReasoning = options?.includeReasoning ?? true;
@@ -87,19 +123,19 @@ function isEmptyText(value) {
 }
 function assertNonEmptyMessages(messages) {
   if (messages.length === 0) {
-    throw new LLMError("messages must not be empty");
+    throw new ValidationError("messages must not be empty");
   }
 }
 function assertNonEmptyEmbedInput(input) {
   const isEmptyString = typeof input === "string" && isEmptyText(input);
   const isEmptyArray = Array.isArray(input) && input.length === 0;
   if (isEmptyString || isEmptyArray) {
-    throw new LLMError("input must not be empty");
+    throw new ValidationError("input must not be empty");
   }
 }
 function assertNonEmptyPrompt(prompt) {
   if (isEmptyText(prompt)) {
-    throw new LLMError("prompt must not be empty");
+    throw new ValidationError("prompt must not be empty");
   }
 }
 
@@ -111,26 +147,33 @@ function splitModelFromParams(params) {
     options
   };
 }
+function callModelWithOptions(params, call) {
+  const { model, options } = splitModelFromParams(params);
+  return call(model, options);
+}
 
 // src/generate.ts
 async function generate(params) {
   assertNonEmptyMessages(params.messages);
-  const { model, options } = splitModelFromParams(params);
-  return model.generate(options);
+  return callModelWithOptions(
+    params,
+    (model, options) => model.generate(options)
+  );
 }
 
 // src/generate-object.ts
 async function generateObject(params) {
   assertNonEmptyMessages(params.messages);
-  const { model, options } = splitModelFromParams(params);
-  return model.generateObject(options);
+  return callModelWithOptions(
+    params,
+    (model, options) => model.generateObject(options)
+  );
 }
 
 // src/stream-chat.ts
 async function stream(params) {
   assertNonEmptyMessages(params.messages);
-  const { model, options } = splitModelFromParams(params);
-  return model.stream(options);
+  return callModelWithOptions(params, (model, options) => model.stream(options));
 }
 
 // src/base-stream.ts
@@ -170,31 +213,31 @@ function createStream(options) {
   function cleanupSignalListener() {
     signal?.removeEventListener("abort", abortStream);
   }
-  function settleCompleted(finalResult) {
+  function settleTerminalState(nextState) {
     if (terminalState.status !== "running") {
       return;
     }
-    terminalState = {
-      status: "completed",
-      result: finalResult
-    };
+    terminalState = nextState;
     cleanupSignalListener();
-    resolveResult?.(finalResult);
+    if (nextState.status === "completed") {
+      resolveResult?.(nextState.result);
+    } else {
+      rejectResult?.(nextState.error);
+    }
     resolveEvents?.([...bufferedEvents]);
     notifyWaiters();
   }
+  function settleCompleted(finalResult) {
+    settleTerminalState({
+      status: "completed",
+      result: finalResult
+    });
+  }
   function settleRejected(error) {
-    if (terminalState.status !== "running") {
-      return;
-    }
-    terminalState = {
+    settleTerminalState({
       status: "rejected",
       error
-    };
-    cleanupSignalListener();
-    rejectResult?.(error);
-    resolveEvents?.([...bufferedEvents]);
-    notifyWaiters();
+    });
   }
   function closeSourceIterator() {
     if (closeSourceIteratorPromise) {
@@ -212,7 +255,7 @@ function createStream(options) {
     if (terminalState.status !== "running") {
       return;
     }
-    settleRejected(new StreamAbortedError("stream aborted"));
+    settleRejected(new StreamAbortedError());
     void closeSourceIterator();
   }
   if (signal) {
@@ -248,6 +291,12 @@ function createStream(options) {
     }
   }
   void pump();
+  function getDoneResult() {
+    return {
+      done: true,
+      value: void 0
+    };
+  }
   return {
     [Symbol.asyncIterator]() {
       let index = 0;
@@ -255,17 +304,11 @@ function createStream(options) {
       return {
         async next() {
           if (closed) {
-            return {
-              done: true,
-              value: void 0
-            };
+            return getDoneResult();
           }
           while (!closed && index >= bufferedEvents.length) {
             if (terminalState.status === "completed") {
-              return {
-                done: true,
-                value: void 0
-              };
+              return getDoneResult();
             }
             if (terminalState.status === "rejected") {
               throw terminalState.error;
@@ -273,10 +316,7 @@ function createStream(options) {
             await resolveWhenUpdated();
           }
           if (closed) {
-            return {
-              done: true,
-              value: void 0
-            };
+            return getDoneResult();
           }
           const value = bufferedEvents[index];
           index += 1;
@@ -288,10 +328,7 @@ function createStream(options) {
         async return() {
           closed = true;
           notifyWaiters();
-          return {
-            done: true,
-            value: void 0
-          };
+          return getDoneResult();
         }
       };
     },
@@ -303,8 +340,10 @@ function createStream(options) {
 // src/stream-object.ts
 async function streamObject(params) {
   assertNonEmptyMessages(params.messages);
-  const { model, ...options } = params;
-  return model.streamObject(options);
+  return callModelWithOptions(
+    params,
+    (model, options) => model.streamObject(options)
+  );
 }
 function createObjectStream(source, options = {}) {
   const { signal } = options;
@@ -337,7 +376,7 @@ function createObjectStream(source, options = {}) {
     },
     finalizeResult() {
       if (objectState.status !== "ready") {
-        throw new LLMError(
+        throw new CoreAIError(
           "object stream completed without emitting a final object"
         );
       }
@@ -430,6 +469,31 @@ function createChatStream(source, options = {}) {
     finishReason = event.finishReason;
     usage = event.usage;
   };
+  const collectFinalizedData = () => {
+    const contentSegments = [];
+    const reasoningSegments = [];
+    const toolCalls = [];
+    for (const part of parts) {
+      if (part.type === "text") {
+        contentSegments.push(part.text);
+        continue;
+      }
+      if (part.type === "reasoning") {
+        reasoningSegments.push(part.text);
+        continue;
+      }
+      if (part.type === "tool-call") {
+        toolCalls.push(part.toolCall);
+      }
+    }
+    const content = contentSegments.join("");
+    const reasoning = reasoningSegments.join("");
+    return {
+      content: content.length > 0 ? content : null,
+      reasoning: reasoning.length > 0 ? reasoning : null,
+      toolCalls
+    };
+  };
   return createStream({
     source: resolvedSource,
     signal,
@@ -460,17 +524,11 @@ function createChatStream(source, options = {}) {
     finalizeResult() {
       flushText();
       flushReasoning();
-      const content = parts.flatMap((part) => part.type === "text" ? [part.text] : []).join("");
-      const reasoning = parts.flatMap(
-        (part) => part.type === "reasoning" ? [part.text] : []
-      ).join("");
-      const toolCalls = parts.flatMap(
-        (part) => part.type === "tool-call" ? [part.toolCall] : []
-      );
+      const { content, reasoning, toolCalls } = collectFinalizedData();
       return {
         parts,
-        content: content.length > 0 ? content : null,
-        reasoning: reasoning.length > 0 ? reasoning : null,
+        content,
+        reasoning,
         toolCalls,
         finishReason,
         usage
@@ -487,24 +545,28 @@ function getProviderMetadata(providerMetadata, provider) {
 // src/embed.ts
 async function embed(params) {
   assertNonEmptyEmbedInput(params.input);
-  const { model, options } = splitModelFromParams(params);
-  return model.embed(options);
+  return callModelWithOptions(params, (model, options) => model.embed(options));
 }
 
 // src/generate-image.ts
 async function generateImage(params) {
   assertNonEmptyPrompt(params.prompt);
-  const { model, options } = splitModelFromParams(params);
-  return model.generate(options);
+  return callModelWithOptions(
+    params,
+    (model, options) => model.generate(options)
+  );
 }
 export {
-  LLMError,
+  AbortedError,
+  CoreAIError,
   ProviderError,
   StreamAbortedError,
   StructuredOutputError,
   StructuredOutputNoObjectGeneratedError,
   StructuredOutputParseError,
   StructuredOutputValidationError,
+  ValidationError,
+  asObject,
   assistantMessage,
   createChatStream,
   createObjectStream,
@@ -515,7 +577,9 @@ export {
   generateObject,
   getProviderMetadata,
   resultToMessage,
+  safeParseJsonObject,
   stream,
   streamObject,
+  stripModelDateSuffix,
   zodSchemaToJsonSchema
 };

package/package.json

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