@redhat-cloud-services/ai-client-common 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
+
+## 0.1.0 (2025-07-23)
+
+
+### Features
+
+* allow additional properties on message response ([c8b4878](https://github.com/Hyperkid123/ai-web-clients/commit/c8b48783e62706f4463f7091805f79a02fab0fab))
+* create common client package ([584467d](https://github.com/Hyperkid123/ai-web-clients/commit/584467d774a45dd8a5f83fce73a8d00766200934))
+* **manager:** initialize conversation from history ([99f46de](https://github.com/Hyperkid123/ai-web-clients/commit/99f46dedbae10c42c6b275ce93364ffeea6b8006))
+* setup simple react arh integration ([456d10a](https://github.com/Hyperkid123/ai-web-clients/commit/456d10a059d8da36c4b3275926b7a7d908229d10))
+
+
+### Bug Fixes
+
+* move metadata to additionalAttributes field ([de42be2](https://github.com/Hyperkid123/ai-web-clients/commit/de42be2368619a9e89c87d7dd034991169dffafa))

package/README.md

@@ -0,0 +1,208 @@
+# @redhat-cloud-services/ai-client-common
+
+Common interfaces and utilities for AI client packages in the Red Hat Cloud Services ecosystem.
+
+## Features
+
+- **Standardized AI Client Interface** - Common `IAIClient` interface for all AI services
+- **Dependency Injection** - Interfaces for custom fetch implementations and streaming handlers  
+- **TypeScript Support** - Comprehensive type definitions for AI client development
+- **Error Handling** - Base error classes with validation error support
+- **Streaming Support** - Generic streaming handler interface for real-time responses
+- **Zero Dependencies** - Pure TypeScript interfaces with no runtime dependencies
+
+## Installation
+
+```bash
+npm install @redhat-cloud-services/ai-client-common
+```
+
+## Core Interfaces
+
+### IAIClient Interface
+
+All AI clients in this workspace implement the `IAIClient` interface:
+
+```typescript
+import { IAIClient } from '@redhat-cloud-services/ai-client-common';
+
+interface IAIClient {
+  init(): Promise<string>;
+  sendMessage<TChunk = unknown>(
+    conversationId: string, 
+    message: string, 
+    options?: ISendMessageOptions<TChunk>
+  ): Promise<TChunk | IMessageResponse | void>;
+  getDefaultStreamingHandler?<TChunk = unknown>(): IStreamingHandler<TChunk> | undefined;
+  getConversationHistory(conversationId: string, options?: IRequestOptions): Promise<IConversationHistoryResponse>;
+  healthCheck(options?: IRequestOptions): Promise<unknown>;
+  getServiceStatus?(options?: IRequestOptions): Promise<unknown>;
+}
+```
+
+### Dependency Injection
+
+#### Custom Fetch Implementation
+
+**Important**: Do NOT set `'Content-Type'` headers in your fetchFunction - AI clients manage these internally based on endpoint requirements.
+
+```typescript
+import { IFetchFunction } from '@redhat-cloud-services/ai-client-common';
+
+const customFetch: IFetchFunction = async (input, init) => {
+  // Add authentication headers
+  const token = await getAuthToken();
+  
+  return fetch(input, {
+    ...init,
+    headers: {
+      ...init?.headers,
+      'Authorization': `Bearer ${token}`,
+      // DO NOT set 'Content-Type' - AI clients handle this internally
+    },
+  });
+};
+```
+
+#### Base Client Configuration
+
+```typescript
+import { IBaseClientConfig } from '@redhat-cloud-services/ai-client-common';
+
+const config: IBaseClientConfig = {
+  baseUrl: 'https://your-ai-service.com',
+  fetchFunction: customFetch,
+  defaultStreamingHandler: new CustomStreamingHandler()
+};
+```
+
+### Streaming Support
+
+#### Implementing a Custom Streaming Handler
+
+```typescript
+import { IStreamingHandler } from '@redhat-cloud-services/ai-client-common';
+
+class CustomStreamingHandler implements IStreamingHandler<string> {
+  onChunk(chunk: string, afterChunk?: (chunk: string) => void): void {
+    console.log('Received chunk:', chunk);
+    // Process the chunk
+    if (afterChunk) {
+      afterChunk(chunk);
+    }
+  }
+
+  onStart?(conversationId?: string, messageId?: string): void {
+    console.log('Stream started', { conversationId, messageId });
+  }
+
+  onComplete?(finalChunk: string): void {
+    console.log('Stream completed:', finalChunk);
+  }
+
+  onError?(error: Error): void {
+    console.error('Stream error:', error);
+  }
+
+  onAbort?(): void {
+    console.log('Stream aborted');
+  }
+}
+```
+
+#### Streaming Request Options
+
+```typescript
+import { ISendMessageOptions } from '@redhat-cloud-services/ai-client-common';
+
+const streamingOptions: ISendMessageOptions<string> = {
+  stream: true,
+  headers: { 'Custom-Header': 'value' },
+  signal: abortController.signal,
+  afterChunk: (chunk) => {
+    // Process each chunk as it arrives
+    updateUI(chunk);
+  }
+};
+```
+
+## Error Handling
+
+### Base Error Classes
+
+```typescript
+import { 
+  AIClientError, 
+  AIClientValidationError 
+} from '@redhat-cloud-services/ai-client-common';
+
+try {
+  const response = await client.sendMessage(conversationId, message);
+} catch (error) {
+  if (error instanceof AIClientValidationError) {
+    console.error('Validation errors:', error.validationErrors);
+    error.validationErrors.forEach(validationError => {
+      console.log(`Field: ${validationError.loc.join('.')}`);
+      console.log(`Message: ${validationError.msg}`);
+      console.log(`Type: ${validationError.type}`);
+    });
+  } else if (error instanceof AIClientError) {
+    console.error(`API Error ${error.status}: ${error.message}`);
+    console.error('Response data:', error.data);
+  } else {
+    console.error('Unexpected error:', error);
+  }
+}
+```
+
+## Type Definitions
+
+### Request and Response Types
+
+```typescript
+import { 
+  IRequestOptions,
+  IMessageResponse,
+  IConversationHistoryResponse,
+  IAPIResponse
+} from '@redhat-cloud-services/ai-client-common';
+
+// Standard request options
+const options: IRequestOptions = {
+  headers: { 'Custom-Header': 'value' },
+  signal: new AbortController().signal
+};
+
+// Message response structure
+interface IMessageResponse {
+  messageId: string;
+  answer: string;
+  conversationId: string;
+  createdAt?: string;
+  metadata?: unknown;
+}
+```
+
+## Compatible Packages
+
+This package provides the foundation for:
+
+- **[@redhat-cloud-services/arh-client](../arh-client)** - Intelligent Front Door (IFD) API client
+- **[@redhat-cloud-services/lightspeed-client](../lightspeed-client)** - OpenShift Lightspeed API client  
+- **[@redhat-cloud-services/ai-client-state](../ai-client-state)** - State management for AI conversations
+- **[@redhat-cloud-services/ai-react-state](../ai-react-state)** - React hooks and context for AI state
+
+## Building
+
+Run `nx build ai-client-common` to build the library.
+
+## Running unit tests
+
+Run `nx test ai-client-common` to execute the unit tests via [Jest](https://jestjs.io).
+
+## Development
+
+This package follows the workspace standards:
+- Strict TypeScript with no `any` types
+- Zero runtime dependencies  
+- Comprehensive interface definitions

package/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "@redhat-cloud-services/ai-client-common",
+  "version": "0.1.0",
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "dependencies": {}
+}

package/src/index.d.ts

@@ -0,0 +1,2 @@
+export * from './lib/ai-client-common';
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/ai-client-common/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/src/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lib/ai-client-common"), exports);
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/ai-client-common/src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC"}

package/src/lib/ai-client-common.d.ts

@@ -0,0 +1,249 @@
+/**
+ * Generic interface for custom fetch implementation that must be injected into AI clients.
+ * Mirrors exactly the native browser fetch interface for maximum compatibility.
+ */
+export interface IFetchFunction {
+    (input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+}
+/**
+ * Base configuration interface for all AI clients
+ */
+export interface IBaseClientConfig<TChunk = unknown> {
+    /**
+     * The base URL for the API
+     */
+    baseUrl: string;
+    /**
+     * Custom fetch implementation for making HTTP requests
+     * Must include authentication headers (Bearer token) if needed
+     */
+    fetchFunction: IFetchFunction;
+    /**
+     * Default streaming handler for the client
+     * Used when sendMessage is called with stream=true but no streamingHandler provided
+     * Individual requests can override this by providing their own streamingHandler
+     */
+    defaultStreamingHandler?: IStreamingHandler<TChunk>;
+}
+/**
+ * Standard request options that can be passed to individual client methods
+ */
+export interface IRequestOptions {
+    /**
+     * Custom headers for this specific request
+     */
+    headers?: Record<string, string>;
+    /**
+     * AbortSignal to cancel the request
+     */
+    signal?: AbortSignal;
+}
+/**
+ * Common interface that all AI clients must implement
+ * Provides a standardized way to interact with different AI services
+ */
+export interface IAIClient<AP extends Record<string, unknown> = Record<string, unknown>> {
+    /**
+     * Initialize the client and return the initial conversation ID
+     * This method is called once when the client is first used by a state manager
+     * @returns Promise that resolves to the initial conversation ID
+     */
+    init(): Promise<string>;
+    /**
+     * Send a message to the AI service
+     * @param conversationId - The conversation ID to send the message to
+     * @param message - The message content to send
+     * @param options - Optional configuration for the request
+     * @returns Promise that resolves to the AI's response
+     */
+    sendMessage<TChunk = unknown>(conversationId: string, message: string, options?: ISendMessageOptions<TChunk>): Promise<TChunk | IMessageResponse<AP> | void>;
+    /**
+     * Get the default streaming handler for this client (if any)
+     * @returns The default streaming handler or undefined if not configured
+     */
+    getDefaultStreamingHandler?<TChunk = unknown>(): IStreamingHandler<TChunk> | undefined;
+    /**
+     * Get the conversation history for a specific conversation
+     * @param conversationId - The conversation ID to retrieve history for
+     * @param options - Optional request configuration
+     * @returns Promise that resolves to the conversation history
+     */
+    getConversationHistory(conversationId: string, options?: IRequestOptions): Promise<IConversationHistoryResponse<AP>>;
+    /**
+     * Perform a health check on the AI service
+     * @param options - Optional request configuration
+     * @returns Promise that resolves to health status information
+     */
+    healthCheck(options?: IRequestOptions): Promise<unknown>;
+    /**
+     * Get the current status of the AI service
+     * @param options - Optional request configuration
+     * @returns Promise that resolves to service status information
+     */
+    getServiceStatus?(options?: IRequestOptions): Promise<unknown>;
+}
+/**
+ * Base error class for all AI client errors
+ */
+export declare class AIClientError extends Error {
+    status: number;
+    statusText: string;
+    data?: unknown | undefined;
+    constructor(status: number, statusText: string, message: string, data?: unknown | undefined);
+}
+/**
+ * Validation error class for 422 responses
+ */
+export interface IValidationError {
+    loc: (string | number)[];
+    msg: string;
+    type: string;
+}
+export declare class AIClientValidationError extends AIClientError {
+    validationErrors: IValidationError[];
+    constructor(validationErrors: IValidationError[]);
+}
+/**
+ * Common utility types used across AI clients
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+/**
+ * Standard API response wrapper that many AI services use
+ */
+export interface IAPIResponse<T = unknown> {
+    data?: T;
+    error?: string;
+    status?: number;
+}
+/**
+ * Generic streaming handler interface for AI clients that support streaming
+ */
+export interface IStreamingHandler<TChunk = unknown> {
+    /**
+     * Handle a single chunk of streaming data
+     */
+    onChunk(chunk: TChunk, afterChunk?: (chunk: TChunk) => void): void;
+    /**
+     * Called when the stream starts
+     */
+    onStart?(conversationId?: string, messageId?: string): void;
+    /**
+     * Called when the stream completes successfully
+     */
+    onComplete?(finalChunk: TChunk): void;
+    /**
+     * Called when an error occurs during streaming
+     */
+    onError?(error: Error): void;
+    /**
+     * Called when the stream is aborted
+     */
+    onAbort?(): void;
+}
+/**
+ * Streaming request options for clients that support streaming
+ */
+export interface IStreamingRequestOptions<TChunk = unknown> extends IRequestOptions {
+    /**
+     * The streaming handler to process the response
+     */
+    streamingHandler: IStreamingHandler<TChunk>;
+}
+/**
+ * Standard message response for non-streaming requests
+ */
+export interface IMessageResponse<AP extends Record<string, unknown> = Record<string, unknown>> {
+    /**
+     * Unique identifier for the message
+     */
+    messageId: string;
+    /**
+     * The response answer/text
+     */
+    answer: string;
+    /**
+     * Conversation identifier this message belongs to
+     */
+    conversationId: string;
+    /**
+     * Timestamp when the message was created
+     */
+    createdAt?: string;
+    /**
+     * Additional attributes specific to the AI client
+     */
+    additionalAttributes?: AP;
+}
+/**
+ * Source citation information for AI responses
+ */
+export interface IAnswerSource {
+    /**
+     * URL to the source content
+     */
+    link?: string | null;
+    /**
+     * Title of the source content
+     */
+    title?: string | null;
+    /**
+     * Relevance score of the source
+     */
+    score?: number | null;
+    /**
+     * Text snippet from the source
+     */
+    snippet?: string | null;
+}
+/**
+ * Single message in conversation history
+ */
+export interface IConversationHistoryMessage<T extends Record<string, unknown> = Record<string, unknown>> {
+    /**
+     * Unique identifier for the message
+     */
+    message_id: string;
+    /**
+     * When the message was received
+     */
+    received_at: string;
+    /**
+     * The user's input/question
+     */
+    input: string;
+    /**
+     * When the AI response was created
+     */
+    created_at: string;
+    /**
+     * The AI's answer
+     */
+    answer: string;
+    /**
+     * Sources used to generate the answer
+     */
+    sources: IAnswerSource[];
+    /**
+     * Additional data associated with the message
+     */
+    additionalData?: T;
+}
+/**
+ * Response type for conversation history requests
+ */
+export type IConversationHistoryResponse<T extends Record<string, unknown> = Record<string, unknown>> = IConversationHistoryMessage<T>[] | null;
+export interface IErrorMessageResponse {
+    error: any;
+}
+/**
+ * Options for sending messages, supporting both streaming and non-streaming modes
+ */
+export interface ISendMessageOptions<TChunk = unknown> extends IRequestOptions {
+    /**
+     * Whether to use streaming mode for the response
+     * When true, the client's default streaming handler will be used
+     */
+    stream?: boolean;
+    afterChunk?: (chunk: TChunk) => void;
+}
+//# sourceMappingURL=ai-client-common.d.ts.map

package/src/lib/ai-client-common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-client-common.d.ts","sourceRoot":"","sources":["../../../../../packages/ai-client-common/src/lib/ai-client-common.ts"],"names":[],"mappings":"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"}

package/src/lib/ai-client-common.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AIClientValidationError = exports.AIClientError = void 0;
+/**
+ * Base error class for all AI client errors
+ */
+class AIClientError extends Error {
+    constructor(status, statusText, message, data) {
+        super(message);
+        this.status = status;
+        this.statusText = statusText;
+        this.data = data;
+        this.name = 'AIClientError';
+    }
+}
+exports.AIClientError = AIClientError;
+class AIClientValidationError extends AIClientError {
+    constructor(validationErrors) {
+        super(422, 'Validation Error', 'Request validation failed', validationErrors);
+        this.validationErrors = validationErrors;
+        this.name = 'AIClientValidationError';
+    }
+}
+exports.AIClientValidationError = AIClientValidationError;
+//# sourceMappingURL=ai-client-common.js.map

package/src/lib/ai-client-common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-client-common.js","sourceRoot":"","sources":["../../../../../packages/ai-client-common/src/lib/ai-client-common.ts"],"names":[],"mappings":";;;AAuGA;;GAEG;AACH,MAAa,aAAc,SAAQ,KAAK;IACtC,YACS,MAAc,EACd,UAAkB,EACzB,OAAe,EACR,IAAc;QAErB,KAAK,CAAC,OAAO,CAAC,CAAC;QALR,WAAM,GAAN,MAAM,CAAQ;QACd,eAAU,GAAV,UAAU,CAAQ;QAElB,SAAI,GAAJ,IAAI,CAAU;QAGrB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAVD,sCAUC;AAWD,MAAa,uBAAwB,SAAQ,aAAa;IACxD,YAAmB,gBAAoC;QACrD,KAAK,CAAC,GAAG,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,gBAAgB,CAAC,CAAC;QAD7D,qBAAgB,GAAhB,gBAAgB,CAAoB;QAErD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AALD,0DAKC"}