@jambonz/llm 0.1.0 → 0.2.0

package/dist/{types-D8rgMCbi.d.cts → types-bq1XMi_T.d.cts}

@@ -93,6 +93,10 @@ type LlmEvent = {
     usage?: Usage;
     rawReason?: string;
 };
+/** Convenience alias for the fully-accumulated tool-call event shape. */
+type ToolCallEvent = Extract<LlmEvent, {
+    type: 'toolCall';
+}>;
 type FinishReason = 'stop' | 'tool' | 'length' | 'filtered' | 'error' | 'aborted';
 interface Usage {
     inputTokens?: number;
@@ -211,8 +215,9 @@ interface FormField {
  *   1. Declares which auth kinds it accepts (`acceptedAuth`).
  *   2. Initializes a client from an `AuthSpec` (`init`).
  *   3. Streams a prompt as an AsyncIterable of `LlmEvent`s (`stream`).
- *   4. Appends a tool result to history in the vendor's native shape (`appendToolResult`).
- *   5. Lists models accessible to the credential (`listAvailableModels`).
+ *   4. Appends an assistant-with-tool-call turn to history (`appendAssistantToolCall`).
+ *   5. Appends a tool result to history in the vendor's native shape (`appendToolResult`).
+ *   6. Lists models accessible to the credential (`listAvailableModels`).
  *
  * The `manifest` is exported as a module-level constant alongside the adapter.
  * See src/adapters/_template/ for a working skeleton.
@@ -235,10 +240,24 @@ interface LlmAdapter<A extends AuthSpec = AuthSpec> {
      * and do not emit any pending `toolCall` events.
      */
     stream(req: PromptRequest): AsyncIterable<LlmEvent>;
+    /**
+     * Append an assistant turn containing one or more tool calls to history,
+     * in the vendor's native shape. Stateful callers use this after `stream()`
+     * yields `toolCall` events to build the assistant turn that must precede
+     * the tool-result messages on the next `stream()` call.
+     *
+     * Vendors encode this turn differently (OpenAI: `{role:'assistant',
+     * content:null, tool_calls:[...]}`; Anthropic: `{role:'assistant',
+     * content:[{type:'tool_use',...}]}`; Google: `{role:'model',
+     * parts:[{functionCall,...}]}`; etc.). The returned `Message` carries the
+     * wire shape in `vendorRaw` and is round-trippable through `stream()`.
+     */
+    appendAssistantToolCall(history: Message[], toolCalls: ReadonlyArray<ToolCallEvent>): Message[];
     /**
      * Append a tool-result message to history in the vendor's native shape.
      * The returned array MUST be a valid `messages` input for a subsequent `stream()` call
-     * on the same adapter.
+     * on the same adapter. Callers MUST have already appended the preceding
+     * assistant-with-tool-call turn via `appendAssistantToolCall`.
      */
     appendToolResult(history: Message[], toolCallId: string, result: unknown): Message[];
     /**
@@ -277,4 +296,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 };
+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 };

package/dist/{types-D8rgMCbi.d.ts → types-bq1XMi_T.d.ts}

@@ -93,6 +93,10 @@ type LlmEvent = {
     usage?: Usage;
     rawReason?: string;
 };
+/** Convenience alias for the fully-accumulated tool-call event shape. */
+type ToolCallEvent = Extract<LlmEvent, {
+    type: 'toolCall';
+}>;
 type FinishReason = 'stop' | 'tool' | 'length' | 'filtered' | 'error' | 'aborted';
 interface Usage {
     inputTokens?: number;
@@ -211,8 +215,9 @@ interface FormField {
  *   1. Declares which auth kinds it accepts (`acceptedAuth`).
  *   2. Initializes a client from an `AuthSpec` (`init`).
  *   3. Streams a prompt as an AsyncIterable of `LlmEvent`s (`stream`).
- *   4. Appends a tool result to history in the vendor's native shape (`appendToolResult`).
- *   5. Lists models accessible to the credential (`listAvailableModels`).
+ *   4. Appends an assistant-with-tool-call turn to history (`appendAssistantToolCall`).
+ *   5. Appends a tool result to history in the vendor's native shape (`appendToolResult`).
+ *   6. Lists models accessible to the credential (`listAvailableModels`).
  *
  * The `manifest` is exported as a module-level constant alongside the adapter.
  * See src/adapters/_template/ for a working skeleton.
@@ -235,10 +240,24 @@ interface LlmAdapter<A extends AuthSpec = AuthSpec> {
      * and do not emit any pending `toolCall` events.
      */
     stream(req: PromptRequest): AsyncIterable<LlmEvent>;
+    /**
+     * Append an assistant turn containing one or more tool calls to history,
+     * in the vendor's native shape. Stateful callers use this after `stream()`
+     * yields `toolCall` events to build the assistant turn that must precede
+     * the tool-result messages on the next `stream()` call.
+     *
+     * Vendors encode this turn differently (OpenAI: `{role:'assistant',
+     * content:null, tool_calls:[...]}`; Anthropic: `{role:'assistant',
+     * content:[{type:'tool_use',...}]}`; Google: `{role:'model',
+     * parts:[{functionCall,...}]}`; etc.). The returned `Message` carries the
+     * wire shape in `vendorRaw` and is round-trippable through `stream()`.
+     */
+    appendAssistantToolCall(history: Message[], toolCalls: ReadonlyArray<ToolCallEvent>): Message[];
     /**
      * Append a tool-result message to history in the vendor's native shape.
      * The returned array MUST be a valid `messages` input for a subsequent `stream()` call
-     * on the same adapter.
+     * on the same adapter. Callers MUST have already appended the preceding
+     * assistant-with-tool-call turn via `appendAssistantToolCall`.
      */
     appendToolResult(history: Message[], toolCallId: string, result: unknown): Message[];
     /**
@@ -277,4 +296,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 };
+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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jambonz/llm",
-  "version": "0.1.0",
+  "version": "0.2.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",