@memberjunction/ai 6.2.0-edge.0 → 6.2.0-edge.2

package/dist/index.js

@@ -2,16 +2,20 @@ export * from './generic/baseModel.js';
 export * from './generic/baseLLM.js';
 export * from './generic/baseImage.js';
 export * from './generic/baseReranker.js';
+export * from './generic/baseDecision.js';
 export * from './generic/chat.types.js';
 export * from './generic/toolTurnEncoding.js';
 export * from './generic/openAICompatibleTools.js';
 export * from './generic/classify.types.js';
 export * from './generic/summarize.types.js';
 export * from './generic/reranker.types.js';
+export * from './generic/decision.types.js';
 export * from './generic/apiKeyDictionary.js';
 export * from './generic/embed.types.js';
 export * from './generic/baseEmbeddings.js';
 export * from './generic/baseAudio.js';
+export * from './generic/baseTextToSpeech.js';
+export * from './generic/baseSpeechToText.js';
 export * from './generic/baseVideo.js';
 export * from './generic/baseRealtime.js';
 export * from './generic/realtimeUsage.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oCAAoC,CAAC;AACnD,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oCAAoC,CAAC;AACnD,cAAc,0BAA0B,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/ai",
   "type": "module",
-  "version": "6.2.0-edge.0",
+  "version": "6.2.0-edge.2",
   "description": "MemberJunction: AI - core components for abstracting LLMs and other AI model types that are usable anywhere without ANY other MJ dependencies past @memberjunction/global which itself has zero additional dependencies.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,7 +11,7 @@
   "author": "MemberJunction.com",
   "license": "BUSL-1.1",
   "dependencies": {
-    "@memberjunction/global": "6.2.0-edge.0",
+    "@memberjunction/global": "6.2.0-edge.2",
     "dotenv": "^17.2.4",
     "rxjs": "^7.8.2"
   },

package/readme.md

@@ -21,9 +21,12 @@ Every AI capability is represented by an abstract base class. Provider packages
 | `BaseLLM` | Chat completions (text generation) | `ChatCompletion()`, `ChatCompletions()` (parallel batch), `GetFileCapabilities()` |
 | `BaseEmbeddings` | Text & multimodal embeddings | `EmbedText()`, `EmbedTexts()`, `EmbedContent()`, `GetFileCapabilities()` |
 | `BaseImageGenerator` | Image generation, editing, variations | `GenerateImage()`, `EditImage()`, `CreateVariation()` |
-| `BaseAudio` | Text-to-speech and speech-to-text | `TextToSpeech()`, `SpeechToText()` |
-| `BaseVideo` | Video generation from text/images | `GenerateVideo()` |
+| `BaseTextToSpeech` | Text-to-speech (`TTS` models) | `CreateSpeech()`, `GetVoices()`, `GetModels()`, `GetPronounciationDictionaries()` |
+| `BaseSpeechToText` | Speech-to-text (`Speech to Text` models) | `SpeechToText()`, `GetModels()`; oversized audio via `TranscribeAudioWithSplitting()` |
+| `BaseAudioGenerator` | **Deprecated.** Both of the above on one class. Kept, and still working, for existing drivers and callers; it implements both new classes | `CreateSpeech()`, `SpeechToText()`, `GetVoices()` |
+| `BaseVideoGenerator` | Avatar video generation (`Video` models) | `CreateAvatarVideo()`, `GetAvatars()` |
 | `BaseReranker` | Document reranking for retrieval | `Rerank()` |
+| `BaseDecision` | Typed decisions (Likelihood, Choice, Score) with a probability per answer | `Decide()` |
 | `BaseRealtimeModel` | Live, full-duplex, tool-calling realtime sessions (voice) | `StartSession()`, `CreateClientSession()` |
 
 All inherit from `BaseModel`, which manages API key storage and provides the `@RegisterClass` integration point.
@@ -43,6 +46,7 @@ One additional realtime primitive lives here that is *not* a `BaseModel` capabil
 | `StreamingChatCallbacks` | Callbacks for real-time streaming: `OnContent`, `OnComplete`, `OnError` |
 | `ParallelChatCompletionsCallbacks` | Callbacks for batch parallel completions |
 | `ChatMessageRole` | Enum: `system`, `user`, `assistant` |
+| `VolatileStateMessageMetadata` / `TrailingVolatileStateSplit` | The one metadata flag (`volatileState`) drivers and the agent layer agree on for a per-request trailing message, and the `{ head, tail }` split `BaseLLM.splitTrailingVolatileState` returns so a driver can place its cache boundary before the volatile tail (protected seam: `isVolatileStateMessage`, `trailingVolatileStateIndex`, `splitTrailingVolatileState`) |
 
 ### Embedding Types
 
@@ -57,10 +61,12 @@ One additional realtime primitive lives here that is *not* a `BaseModel` capabil
 | Type | Description |
 |------|-------------|
 | `ImageGenerationParams` / `ImageGenerationResult` | Image generation parameters and results |
-| `SummarizeParams` / `SummarizeResult` | Text summarization |
-| `ClassifyParams` / `ClassifyResult` | Text classification |
+| `SummarizeParams` / `SummarizeResult` | Text summarization (deprecated) |
+| `ClassifyParams` / `ClassifyResult` | Text classification (deprecated) |
 | `RerankParams` / `RerankResult` | Document reranking |
+| `DecisionParams` / `DecisionResult` | Typed decision parameters and structured results with probabilities |
 | `ModelUsage` | Token counts and cost tracking (prompt tokens, completion tokens, total cost, currency) |
+| `AIModelConfiguration` / `LLMConfigurationSettings` / `IsPrefixPromptCache` | The model catalog's `ModelConfiguration` JSONType bag (Model Types < Models < the vendor's `Configuration.ModelDefaults` (`AIVendorConfiguration`, parsed by `ParseVendorConfiguration`) < Model Vendors, resolved by `ResolveEffectiveModelConfiguration`). `LLMConfigurationSettings.PrefixPromptCache` (read via `IsPrefixPromptCache`) says whether a serving path's prompt cache is an exact byte-prefix match (OpenAI, xAI — set once under the vendor row's `Configuration.ModelDefaults`, inherited by every model it serves) rather than block/segment based, which decides whether the agent layer appends or replaces its trailing runtime-state message |
 | `BaseResult` | Common result base with success flag, timing, and error info |
 | `FileCapabilities` | Declares which non-text inputs a provider accepts: `SupportedMimeTypes` (e.g. `image/png`, `audio/mp3`, supports `image/*` wildcards), `MaxFileSize`, `MaxFilesPerRequest`, `HasFileAPI`. Returned by `GetFileCapabilities()` on `BaseLLM` (file inputs to chat) and `BaseEmbeddings` (media inputs to `EmbedContent`); `null` means text-only |
 
@@ -184,10 +190,10 @@ export class MyProviderLLM extends BaseLLM {
         // Your API call here
     }
 
-    // Optional: implement text classification
+    // Required by BaseLLM but deprecated: new drivers should throw a "not supported" error
     public async ClassifyText(params: ClassifyParams): Promise<ClassifyResult> { /* ... */ }
 
-    // Optional: implement summarization
+    // Required by BaseLLM but deprecated: new drivers should throw a "not supported" error
     public async SummarizeText(params: SummarizeParams): Promise<SummarizeResult> { /* ... */ }
 
     // Optional: enable streaming by overriding these