@brownandroot/api 0.7.0 → 0.8.0

package/README.md

@@ -1,6 +1,6 @@
 # @brownandroot/api
 
-Read-only TypeScript client for the Brown & Root APIHub data service. All methods are GET-only — no create, update, or delete operations are supported.
+TypeScript client for the Brown & Root APIHub data service. Provides read-only access to company data and an LLM chat endpoint powered by Azure AI Foundry.
 
 ## Installation
 
@@ -61,10 +61,21 @@ const orders = await client.getWorkorders()
 const order = await client.getWorkorder('WO001')
 ```
 
-### LLM Logs
+### LLM
 
 ```typescript
+// List logs
 const logs = await client.getLlmLogs()
+
+// Chat completion
+const result = await client.chat({
+	messages: [{ role: 'user', content: 'Summarize this document...' }],
+	source: 'my-app',
+	user: 'jane.doe',
+	function: 'summarize',
+})
+console.log(result.message.content)
+console.log(result.usage) // { tokensIn, tokensOut, totalTokens }
 ```
 
 ## Types
@@ -77,9 +88,11 @@ import type {
 	BusinessUnit,
 	Costcode,
 	Paytype,
-	Shift,
 	Workorder,
 	LlmLog,
+	ChatMessage,
+	ChatRequest,
+	ChatResponse,
 	ApiHubClientOptions,
 } from '@brownandroot/api'
 ```

package/dist/index.d.ts

@@ -58,6 +58,26 @@ export interface LlmLog {
     totalTokens: number | null;
     createdAt: string | null;
 }
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface ChatRequest {
+    messages: ChatMessage[];
+    source: string;
+    user: string;
+    function?: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+export interface ChatResponse {
+    message: ChatMessage;
+    usage: {
+        tokensIn: number | null;
+        tokensOut: number | null;
+        totalTokens: number | null;
+    };
+}
 export interface BusinessUnit {
     id: string;
     companyId: string;
@@ -145,6 +165,8 @@ export declare class ApiHubClient {
     }>;
     /** List all LLM log entries (newest first) */
     getLlmLogs(): Promise<LlmLog[]>;
+    /** Send a chat completion request to the LLM */
+    chat(request: ChatRequest): Promise<ChatResponse>;
     getBusinessUnits(): Promise<BusinessUnit[]>;
     getBusinessUnitsDropdown(): Promise<DropdownOption[]>;
     getBusinessUnit(id: string): Promise<BusinessUnit>;

package/dist/index.js

@@ -54,6 +54,22 @@ export class ApiHubClient {
     async getLlmLogs() {
         return this.request('/llm-logs');
     }
+    /** Send a chat completion request to the LLM */
+    async chat(request) {
+        const res = await fetch(`${this.baseUrl}/llm/chat`, {
+            method: 'POST',
+            headers: {
+                'x-api-key': this.apiKey,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(request),
+        });
+        if (!res.ok) {
+            const body = await res.json().catch(() => ({}));
+            throw new Error(body.error ?? `Request failed: ${res.status}`);
+        }
+        return res.json();
+    }
     // -----------------------------------------------------------------------
     // Business Units
     // -----------------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@brownandroot/api",
-	"version": "0.7.0",
+	"version": "0.8.0",
 	"type": "module",
 	"repository": {
 		"type": "git",