@jambonz/llm 0.3.3 → 0.4.0

package/dist/{types-4d2QrlAe.d.cts → types-DxknK0Rc.d.cts}

@@ -103,12 +103,35 @@ interface Usage {
     outputTokens?: number;
     totalTokens?: number;
 }
-type AuthSpec = ApiKeyAuth | BedrockIamAuth | BedrockApiKeyAuth | GoogleApiKeyAuth | GoogleServiceAccountAuth | VertexServiceAccountAuth;
+type AuthSpec = ApiKeyAuth | AzureOpenAIApiKeyAuth | BedrockIamAuth | BedrockApiKeyAuth | GoogleApiKeyAuth | GoogleServiceAccountAuth | VertexServiceAccountAuth;
 interface ApiKeyAuth {
     kind: 'apiKey';
     apiKey: string;
     baseURL?: string;
 }
+/**
+ * Azure OpenAI Service uses an OpenAI-compatible wire protocol but differs
+ * from `api.openai.com` in three important ways:
+ *   1. Auth header is `api-key: {key}` (not `Authorization: Bearer {key}`).
+ *   2. The URL embeds the deployment name, not the model id:
+ *      `https://{endpoint}/openai/deployments/{deployment}/chat/completions?api-version={version}`.
+ *      The `model` field on the request is ignored by Azure; the deployment in
+ *      the URL determines which model runs. Capability flags in the manifest
+ *      are keyed by the underlying model (gpt-4o, gpt-4o-mini, ...).
+ *   3. `apiVersion` is a user-supplied knob — Microsoft rolls versions
+ *      frequently and customers shouldn't need a library release to move to a
+ *      newer one.
+ */
+interface AzureOpenAIApiKeyAuth {
+    kind: 'azureOpenAIApiKey';
+    apiKey: string;
+    /** Resource endpoint, e.g. `https://my-resource.openai.azure.com`. No trailing slash. */
+    endpoint: string;
+    /** Deployment name the user created in Azure AI Studio / Azure OpenAI Studio. */
+    deployment: string;
+    /** Azure OpenAI data-plane api-version, e.g. `2024-10-21`. */
+    apiVersion: string;
+}
 interface BedrockIamAuth {
     kind: 'bedrockIam';
     accessKeyId: string;
@@ -318,4 +341,4 @@ interface CreateLlmArgs<A extends AuthSpec = AuthSpec> {
     client?: ClientOptions;
 }
 
-export type { AuthSpec as A, BedrockApiKeyAuth as B, CreateLlmArgs as C, FinishReason as F, GoogleApiKeyAuth as G, JsonSchema as J, LlmAdapter as L, Message as M, PromptRequest as P, Role as R, ServiceAccountJson as S, Tool as T, Usage as U, VertexServiceAccountAuth as V, AdapterFactory as a, AdapterManifest as b, ApiKeyAuth as c, AuthKind as d, AuthKindSchema as e, BedrockIamAuth as f, ClientOptions as g, ContentBlock as h, FormField as i, FormFieldType as j, GoogleServiceAccountAuth as k, LlmEvent as l, ModelCapabilities as m, ModelInfo as n, ToolCallEvent as o };
+export type { AuthSpec as A, BedrockApiKeyAuth as B, CreateLlmArgs as C, FinishReason as F, GoogleApiKeyAuth as G, JsonSchema as J, LlmAdapter as L, Message as M, PromptRequest as P, Role as R, ServiceAccountJson as S, Tool as T, Usage as U, VertexServiceAccountAuth as V, AuthKindSchema as a, AdapterFactory as b, AdapterManifest as c, ApiKeyAuth as d, AuthKind as e, AzureOpenAIApiKeyAuth as f, BedrockIamAuth as g, ClientOptions as h, ContentBlock as i, FormField as j, FormFieldType as k, GoogleServiceAccountAuth as l, LlmEvent as m, ModelCapabilities as n, ModelInfo as o, ToolCallEvent as p };

package/dist/{types-4d2QrlAe.d.ts → types-DxknK0Rc.d.ts}

@@ -103,12 +103,35 @@ interface Usage {
     outputTokens?: number;
     totalTokens?: number;
 }
-type AuthSpec = ApiKeyAuth | BedrockIamAuth | BedrockApiKeyAuth | GoogleApiKeyAuth | GoogleServiceAccountAuth | VertexServiceAccountAuth;
+type AuthSpec = ApiKeyAuth | AzureOpenAIApiKeyAuth | BedrockIamAuth | BedrockApiKeyAuth | GoogleApiKeyAuth | GoogleServiceAccountAuth | VertexServiceAccountAuth;
 interface ApiKeyAuth {
     kind: 'apiKey';
     apiKey: string;
     baseURL?: string;
 }
+/**
+ * Azure OpenAI Service uses an OpenAI-compatible wire protocol but differs
+ * from `api.openai.com` in three important ways:
+ *   1. Auth header is `api-key: {key}` (not `Authorization: Bearer {key}`).
+ *   2. The URL embeds the deployment name, not the model id:
+ *      `https://{endpoint}/openai/deployments/{deployment}/chat/completions?api-version={version}`.
+ *      The `model` field on the request is ignored by Azure; the deployment in
+ *      the URL determines which model runs. Capability flags in the manifest
+ *      are keyed by the underlying model (gpt-4o, gpt-4o-mini, ...).
+ *   3. `apiVersion` is a user-supplied knob — Microsoft rolls versions
+ *      frequently and customers shouldn't need a library release to move to a
+ *      newer one.
+ */
+interface AzureOpenAIApiKeyAuth {
+    kind: 'azureOpenAIApiKey';
+    apiKey: string;
+    /** Resource endpoint, e.g. `https://my-resource.openai.azure.com`. No trailing slash. */
+    endpoint: string;
+    /** Deployment name the user created in Azure AI Studio / Azure OpenAI Studio. */
+    deployment: string;
+    /** Azure OpenAI data-plane api-version, e.g. `2024-10-21`. */
+    apiVersion: string;
+}
 interface BedrockIamAuth {
     kind: 'bedrockIam';
     accessKeyId: string;
@@ -318,4 +341,4 @@ interface CreateLlmArgs<A extends AuthSpec = AuthSpec> {
     client?: ClientOptions;
 }
 
-export type { AuthSpec as A, BedrockApiKeyAuth as B, CreateLlmArgs as C, FinishReason as F, GoogleApiKeyAuth as G, JsonSchema as J, LlmAdapter as L, Message as M, PromptRequest as P, Role as R, ServiceAccountJson as S, Tool as T, Usage as U, VertexServiceAccountAuth as V, AdapterFactory as a, AdapterManifest as b, ApiKeyAuth as c, AuthKind as d, AuthKindSchema as e, BedrockIamAuth as f, ClientOptions as g, ContentBlock as h, FormField as i, FormFieldType as j, GoogleServiceAccountAuth as k, LlmEvent as l, ModelCapabilities as m, ModelInfo as n, ToolCallEvent as o };
+export type { AuthSpec as A, BedrockApiKeyAuth as B, CreateLlmArgs as C, FinishReason as F, GoogleApiKeyAuth as G, JsonSchema as J, LlmAdapter as L, Message as M, PromptRequest as P, Role as R, ServiceAccountJson as S, Tool as T, Usage as U, VertexServiceAccountAuth as V, AuthKindSchema as a, AdapterFactory as b, AdapterManifest as c, ApiKeyAuth as d, AuthKind as e, AzureOpenAIApiKeyAuth as f, BedrockIamAuth as g, ClientOptions as h, ContentBlock as i, FormField as j, FormFieldType as k, GoogleServiceAccountAuth as l, LlmEvent as m, ModelCapabilities as n, ModelInfo as o, ToolCallEvent as p };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jambonz/llm",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "Voice-oriented LLM adapter library — a uniform interface for streaming chat completions from multiple LLM vendors, with first-class support for tool calls, AbortSignal interruption, and lossless history round-tripping.",
   "type": "module",
   "main": "./dist/index.cjs",