@aigne/transport 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+## [0.1.0](https://github.com/AIGNE-io/aigne-framework/compare/transport-v0.0.1...transport-v0.1.0) (2025-05-23)
+
+
+### Features
+
+* **models:** publish model adapters as standalone packages ([#126](https://github.com/AIGNE-io/aigne-framework/issues/126)) ([588b8ae](https://github.com/AIGNE-io/aigne-framework/commit/588b8aea6abcee5fa87def1358bf51f84021c6ef))
+
+
+### Bug Fixes
+
+* automatically convert tool names to a valid format ([#128](https://github.com/AIGNE-io/aigne-framework/issues/128)) ([e9ee91d](https://github.com/AIGNE-io/aigne-framework/commit/e9ee91d9d782fa19000adb4cf95b9d65196ab651))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/openai bumped to 0.1.0
+  * devDependencies
+    * @aigne/core bumped to 1.16.0
+    * @aigne/test-utils bumped to 0.3.0

package/LICENSE.md

@@ -0,0 +1,93 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/README.md

@@ -0,0 +1,162 @@
+# @aigne/transport
+
+[![GitHub star chart](https://img.shields.io/github/stars/AIGNE-io/aigne-framework?style=flat-square)](https://star-history.com/#AIGNE-io/aigne-framework)
+[![Open Issues](https://img.shields.io/github/issues-raw/AIGNE-io/aigne-framework?style=flat-square)](https://github.com/AIGNE-io/aigne-framework/issues)
+[![codecov](https://codecov.io/gh/AIGNE-io/aigne-framework/graph/badge.svg?token=DO07834RQL)](https://codecov.io/gh/AIGNE-io/aigne-framework)
+[![NPM Version](https://img.shields.io/npm/v/@aigne/transport)](https://www.npmjs.com/package/@aigne/transport)
+[![Elastic-2.0 licensed](https://img.shields.io/npm/l/@aigne/transport)](https://github.com/AIGNE-io/aigne-framework/blob/main/LICENSE.md)
+
+**English** | [中文](README.zh.md)
+
+AIGNE Transport SDK providing HTTP client and server implementations for communication between AIGNE components within the [AIGNE Framework](https://github.com/AIGNE-io/aigne-framework).
+
+## Introduction
+
+`@aigne/transport` provides a robust communication layer for AIGNE components, enabling seamless interaction between different parts of your AI applications. This package offers both HTTP client and server implementations that adhere to a consistent protocol, making it easy to build distributed AI systems with the AIGNE Framework.
+
+## Features
+
+* **HTTP Client Implementation**: Easy-to-use client for communicating with AIGNE servers
+* **HTTP Server Implementation**: Flexible server implementation that integrates with popular Node.js frameworks
+* **Framework Agnostic**: Supports Express, Hono, and other Node.js HTTP frameworks
+* **Streaming Support**: First-class support for streaming responses
+* **Type Safety**: Comprehensive TypeScript typings for all APIs
+* **Error Handling**: Robust error handling with detailed error messages
+* **Middleware Support**: Compatible with common HTTP middleware like compression
+
+## Installation
+
+### Using npm
+
+```bash
+npm install @aigne/transport @aigne/core
+```
+
+### Using yarn
+
+```bash
+yarn add @aigne/transport @aigne/core
+```
+
+### Using pnpm
+
+```bash
+pnpm add @aigne/transport @aigne/core
+```
+
+## Basic Usage
+
+### Server Usage
+
+You can use the AIGNE HTTP server with either Express or Hono frameworks.
+
+#### Express Example
+
+```typescript file="test/http-server/http-server.test.ts" region="example-aigne-server-express"
+import { AIAgent, AIGNE } from "@aigne/core";
+import { AIGNEHTTPClient } from "@aigne/transport/http-client/index.js";
+import { AIGNEHTTPServer } from "@aigne/transport/http-server/index.js";
+import express from "express";
+import { OpenAIChatModel } from "../_mocks_/mock-models.js";
+
+const model = new OpenAIChatModel();
+
+const chat = AIAgent.from({
+  name: "chat",
+});
+
+// AIGNE: Main execution engine of AIGNE Framework.
+const aigne = new AIGNE({ model, agents: [chat] });
+
+// Create an AIGNEServer instance
+const aigneServer = new AIGNEHTTPServer(aigne);
+
+// Setup the server to handle incoming requests
+const server = express();
+server.post("/aigne/invoke", async (req, res) => {
+  await aigneServer.invoke(req, res);
+});
+const httpServer = server.listen(port);
+
+// Create an AIGNEClient instance
+const client = new AIGNEHTTPClient({ url });
+
+// Invoke the agent by client
+const response = await client.invoke("chat", { $message: "hello" });
+
+console.log(response); // Output: {$message: "Hello world!"}
+```
+
+#### Hono Example
+
+```typescript file="test/http-server/http-server.test.ts" region="example-aigne-server-hono"
+import { AIAgent, AIGNE } from "@aigne/core";
+import { AIGNEHTTPClient } from "@aigne/transport/http-client/index.js";
+import { AIGNEHTTPServer } from "@aigne/transport/http-server/index.js";
+import { serve } from "bun";
+import { Hono } from "hono";
+import { OpenAIChatModel } from "../_mocks_/mock-models.js";
+
+const model = new OpenAIChatModel();
+
+const chat = AIAgent.from({
+  name: "chat",
+});
+
+// AIGNE: Main execution engine of AIGNE Framework.
+const aigne = new AIGNE({ model, agents: [chat] });
+
+// Create an AIGNEServer instance
+const aigneServer = new AIGNEHTTPServer(aigne);
+
+// Setup the server to handle incoming requests
+const honoApp = new Hono();
+honoApp.post("/aigne/invoke", async (c) => {
+  return aigneServer.invoke(c.req.raw);
+});
+const server = serve({ port, fetch: honoApp.fetch });
+
+// Create an AIGNEClient instance
+const client = new AIGNEHTTPClient({ url });
+
+// Invoke the agent by client
+const response = await client.invoke("chat", { $message: "hello" });
+console.log(response); // Output: {$message: "Hello world!"}
+```
+
+### HTTP Client
+
+```typescript file="test/http-client/http-client.test.ts" region="example-aigne-client-simple"
+import { AIGNEHTTPClient } from "@aigne/transport/http-client/index.js";
+
+const client = new AIGNEHTTPClient({ url });
+
+const response = await client.invoke("chat", { $message: "hello" });
+
+console.log(response); // Output: {$message: "Hello world!"}
+```
+
+### Streaming Responses
+
+```typescript file="test/http-client/http-client.test.ts" region="example-aigne-client-streaming"
+import { AIGNEHTTPClient } from "@aigne/transport/http-client/index.js";
+
+const client = new AIGNEHTTPClient({ url });
+
+const stream = await client.invoke(
+  "chat",
+  { $message: "hello" },
+  { streaming: true },
+);
+
+let text = "";
+for await (const chunk of stream) {
+  if (chunk.delta.text?.$message) text += chunk.delta.text.$message;
+}
+
+console.log(text); // Output: "Hello world!"
+```
+
+## License
+
+Elastic-2.0

package/README.zh.md

@@ -0,0 +1,162 @@
+# @aigne/transport
+
+[![GitHub star chart](https://img.shields.io/github/stars/AIGNE-io/aigne-framework?style=flat-square)](https://star-history.com/#AIGNE-io/aigne-framework)
+[![Open Issues](https://img.shields.io/github/issues-raw/AIGNE-io/aigne-framework?style=flat-square)](https://github.com/AIGNE-io/aigne-framework/issues)
+[![codecov](https://codecov.io/gh/AIGNE-io/aigne-framework/graph/badge.svg?token=DO07834RQL)](https://codecov.io/gh/AIGNE-io/aigne-framework)
+[![NPM Version](https://img.shields.io/npm/v/@aigne/transport)](https://www.npmjs.com/package/@aigne/transport)
+[![Elastic-2.0 licensed](https://img.shields.io/npm/l/@aigne/transport)](https://github.com/AIGNE-io/aigne-framework/blob/main/LICENSE.md)
+
+[English](README.md) | **中文**
+
+AIGNE Transport SDK，为 [AIGNE 框架](https://github.com/AIGNE-io/aigne-framework) 中的 AIGNE 组件之间的通信提供 HTTP 客户端和服务器实现。
+
+## 简介
+
+`@aigne/transport` 为 AIGNE 组件提供了一个强大的通信层，使 AI 应用程序的不同部分之间能够无缝交互。该包提供了遵循一致协议的 HTTP 客户端和服务器实现，使用 AIGNE 框架构建分布式 AI 系统变得简单。
+
+## 特性
+
+* **HTTP 客户端实现**：易于使用的客户端，用于与 AIGNE 服务器通信
+* **HTTP 服务器实现**：灵活的服务器实现，可与流行的 Node.js 框架集成
+* **框架无关**：支持 Express、Hono 和其他 Node.js HTTP 框架
+* **流式响应支持**：对流式响应的一流支持
+* **类型安全**：为所有 API 提供全面的 TypeScript 类型定义
+* **错误处理**：健壮的错误处理机制，提供详细的错误信息
+* **中间件支持**：兼容常见的 HTTP 中间件，如压缩中间件
+
+## 安装
+
+### 使用 npm
+
+```bash
+npm install @aigne/transport @aigne/core
+```
+
+### 使用 yarn
+
+```bash
+yarn add @aigne/transport @aigne/core
+```
+
+### 使用 pnpm
+
+```bash
+pnpm add @aigne/transport @aigne/core
+```
+
+## 基本用法
+
+### 服务端用法
+
+AIGNE HTTP 服务器可用于 Express 或 Hono 框架。
+
+#### Express 示例
+
+```typescript file="test/http-server/http-server.test.ts" region="example-aigne-server-express"
+import { AIAgent, AIGNE } from "@aigne/core";
+import { AIGNEHTTPClient } from "@aigne/transport/http-client/index.js";
+import { AIGNEHTTPServer } from "@aigne/transport/http-server/index.js";
+import express from "express";
+import { OpenAIChatModel } from "../_mocks_/mock-models.js";
+
+const model = new OpenAIChatModel();
+
+const chat = AIAgent.from({
+  name: "chat",
+});
+
+// AIGNE: Main execution engine of AIGNE Framework.
+const aigne = new AIGNE({ model, agents: [chat] });
+
+// Create an AIGNEServer instance
+const aigneServer = new AIGNEHTTPServer(aigne);
+
+// Setup the server to handle incoming requests
+const server = express();
+server.post("/aigne/invoke", async (req, res) => {
+  await aigneServer.invoke(req, res);
+});
+const httpServer = server.listen(port);
+
+// Create an AIGNEClient instance
+const client = new AIGNEHTTPClient({ url });
+
+// Invoke the agent by client
+const response = await client.invoke("chat", { $message: "hello" });
+
+console.log(response); // Output: {$message: "Hello world!"}
+```
+
+#### Hono 示例
+
+```typescript file="test/http-server/http-server.test.ts" region="example-aigne-server-hono"
+import { AIAgent, AIGNE } from "@aigne/core";
+import { AIGNEHTTPClient } from "@aigne/transport/http-client/index.js";
+import { AIGNEHTTPServer } from "@aigne/transport/http-server/index.js";
+import { serve } from "bun";
+import { Hono } from "hono";
+import { OpenAIChatModel } from "../_mocks_/mock-models.js";
+
+const model = new OpenAIChatModel();
+
+const chat = AIAgent.from({
+  name: "chat",
+});
+
+// AIGNE: Main execution engine of AIGNE Framework.
+const aigne = new AIGNE({ model, agents: [chat] });
+
+// Create an AIGNEServer instance
+const aigneServer = new AIGNEHTTPServer(aigne);
+
+// Setup the server to handle incoming requests
+const honoApp = new Hono();
+honoApp.post("/aigne/invoke", async (c) => {
+  return aigneServer.invoke(c.req.raw);
+});
+const server = serve({ port, fetch: honoApp.fetch });
+
+// Create an AIGNEClient instance
+const client = new AIGNEHTTPClient({ url });
+
+// Invoke the agent by client
+const response = await client.invoke("chat", { $message: "hello" });
+console.log(response); // Output: {$message: "Hello world!"}
+```
+
+### HTTP 客户端
+
+```typescript file="test/http-client/http-client.test.ts" region="example-aigne-client-simple"
+import { AIGNEHTTPClient } from "@aigne/transport/http-client/index.js";
+
+const client = new AIGNEHTTPClient({ url });
+
+const response = await client.invoke("chat", { $message: "hello" });
+
+console.log(response); // Output: {$message: "Hello world!"}
+```
+
+### 流式响应
+
+```typescript file="test/http-client/http-client.test.ts" region="example-aigne-client-streaming"
+import { AIGNEHTTPClient } from "@aigne/transport/http-client/index.js";
+
+const client = new AIGNEHTTPClient({ url });
+
+const stream = await client.invoke(
+  "chat",
+  { $message: "hello" },
+  { streaming: true },
+);
+
+let text = "";
+for await (const chunk of stream) {
+  if (chunk.delta.text?.$message) text += chunk.delta.text.$message;
+}
+
+console.log(text); // Output: "Hello world!"
+```
+
+## 许可证
+
+Elastic-2.0

package/lib/cjs/http-client/client.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Client module used to interact with the AIGNE framework.
+ */
+import type { AgentInvokeOptions, AgentResponse, AgentResponseStream, Message } from "@aigne/core";
+/**
+ * Configuration options for the AIGNEHTTPClient.
+ */
+export interface AIGNEHTTPClientOptions {
+    /**
+     * The URL of the AIGNE server to connect to.
+     * This should point to the base endpoint where the AIGNEServer is hosted.
+     */
+    url: string;
+}
+/**
+ * Options for invoking an agent through the AIGNEHTTPClient.
+ * Extends the standard AgentInvokeOptions with client-specific options.
+ */
+export interface AIGNEHTTPClientInvokeOptions extends AgentInvokeOptions {
+    /**
+     * Additional fetch API options to customize the HTTP request.
+     * These options will be merged with the default options used by the client.
+     */
+    fetchOptions?: Partial<RequestInit>;
+}
+/**
+ * Http client for interacting with a remote AIGNE server.
+ * AIGNEHTTPClient provides a client-side interface that matches the AIGNE API,
+ * allowing applications to invoke agents and receive responses from a remote AIGNE instance.
+ *
+ * @example
+ * Here's a simple example of how to use AIGNEClient:
+ * {@includeCode ../../test/http-client/http-client.test.ts#example-aigne-client-simple}
+ *
+ * @example
+ * Here's an example of how to use AIGNEClient with streaming response:
+ * {@includeCode ../../test/http-client/http-client.test.ts#example-aigne-client-streaming}
+ */
+export declare class AIGNEHTTPClient {
+    options: AIGNEHTTPClientOptions;
+    /**
+     * Creates a new AIGNEClient instance.
+     *
+     * @param options - Configuration options for connecting to the AIGNE server
+     */
+    constructor(options: AIGNEHTTPClientOptions);
+    /**
+     * Invokes an agent in non-streaming mode and returns the complete response.
+     *
+     * @param agent - Name of the agent to invoke
+     * @param input - Input message for the agent
+     * @param options - Options with streaming mode explicitly set to false or omitted
+     * @returns The complete agent response
+     *
+     * @example
+     * Here's a simple example of how to use AIGNEClient:
+     * {@includeCode ../../test/http-client/http-client.test.ts#example-aigne-client-simple}
+     */
+    invoke<I extends Message, O extends Message>(agent: string, input: string | I, options?: AIGNEHTTPClientInvokeOptions & {
+        streaming?: false;
+    }): Promise<O>;
+    /**
+     * Invokes an agent with streaming mode enabled and returns a stream of response chunks.
+     *
+     * @param agent - Name of the agent to invoke
+     * @param input - Input message for the agent
+     * @param options - Options with streaming mode explicitly set to true
+     * @returns A stream of agent response chunks
+     *
+     * @example
+     * Here's an example of how to use AIGNEClient with streaming response:
+     * {@includeCode ../../test/http-client/http-client.test.ts#example-aigne-client-streaming}
+     */
+    invoke<I extends Message, O extends Message>(agent: string, input: string | I, options: AIGNEHTTPClientInvokeOptions & {
+        streaming: true;
+    }): Promise<AgentResponseStream<O>>;
+    /**
+     * Invokes an agent with the given input and options.
+     *
+     * @param agent - Name of the agent to invoke
+     * @param input - Input message for the agent
+     * @param options - Options for the invocation
+     * @returns Either a complete response or a response stream depending on the streaming option
+     */
+    invoke<I extends Message, O extends Message>(agent: string, input: string | I, options?: AIGNEHTTPClientInvokeOptions): Promise<AgentResponse<O>>;
+    /**
+     * Enhanced fetch method that handles error responses from the AIGNE server.
+     * This method wraps the standard fetch API to provide better error handling and reporting.
+     *
+     * @param args - Standard fetch API arguments (url and options)
+     * @returns A Response object if the request was successful
+     * @throws Error with detailed information if the request failed
+     *
+     * @private
+     */
+    fetch(...args: Parameters<typeof globalThis.fetch>): Promise<Response>;
+}

package/lib/cjs/http-client/client.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * Client module used to interact with the AIGNE framework.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AIGNEHTTPClient = void 0;
+const event_stream_js_1 = require("@aigne/core/utils/event-stream.js");
+const type_utils_js_1 = require("@aigne/core/utils/type-utils.js");
+/**
+ * Http client for interacting with a remote AIGNE server.
+ * AIGNEHTTPClient provides a client-side interface that matches the AIGNE API,
+ * allowing applications to invoke agents and receive responses from a remote AIGNE instance.
+ *
+ * @example
+ * Here's a simple example of how to use AIGNEClient:
+ * {@includeCode ../../test/http-client/http-client.test.ts#example-aigne-client-simple}
+ *
+ * @example
+ * Here's an example of how to use AIGNEClient with streaming response:
+ * {@includeCode ../../test/http-client/http-client.test.ts#example-aigne-client-streaming}
+ */
+class AIGNEHTTPClient {
+    options;
+    /**
+     * Creates a new AIGNEClient instance.
+     *
+     * @param options - Configuration options for connecting to the AIGNE server
+     */
+    constructor(options) {
+        this.options = options;
+    }
+    async invoke(agent, input, options) {
+        // Send the agent invocation request to the AIGNE server
+        const response = await this.fetch(this.options.url, {
+            ...options?.fetchOptions,
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                ...options?.fetchOptions?.headers,
+            },
+            body: JSON.stringify({ agent, input, options }),
+        });
+        // For non-streaming responses, simply parse the JSON response and return it
+        if (!options?.streaming) {
+            return await response.json();
+        }
+        // For streaming responses, set up the streaming pipeline
+        const stream = response.body;
+        if (!stream)
+            throw new Error("Response body is not a stream");
+        // Process the stream through a series of transforms:
+        // 1. Convert bytes to text
+        // 2. Parse SSE format into structured events
+        // 3. Convert events into a standardized agent response stream
+        return stream
+            .pipeThrough(new TextDecoderStream())
+            .pipeThrough(new event_stream_js_1.EventStreamParser())
+            .pipeThrough(new event_stream_js_1.AgentResponseStreamParser());
+    }
+    /**
+     * Enhanced fetch method that handles error responses from the AIGNE server.
+     * This method wraps the standard fetch API to provide better error handling and reporting.
+     *
+     * @param args - Standard fetch API arguments (url and options)
+     * @returns A Response object if the request was successful
+     * @throws Error with detailed information if the request failed
+     *
+     * @private
+     */
+    async fetch(...args) {
+        const result = await globalThis.fetch(...args);
+        if (!result.ok) {
+            let message;
+            try {
+                const text = await result.text();
+                const json = (0, type_utils_js_1.tryOrThrow)(() => JSON.parse(text));
+                message = json?.error?.message || text;
+            }
+            catch {
+                // ignore
+            }
+            throw new Error(`Failed to fetch url ${args[0]} with status ${result.status}: ${message}`);
+        }
+        return result;
+    }
+}
+exports.AIGNEHTTPClient = AIGNEHTTPClient;

package/lib/cjs/http-client/index.d.ts

@@ -0,0 +1 @@
+export * from "./client.js";

package/lib/cjs/http-client/index.js

@@ -0,0 +1,17 @@
+"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("./client.js"), exports);

package/lib/cjs/http-server/error.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Custom error class for AIGNEServer HTTP-related errors.
+ * Extends the standard Error class with an HTTP status code property.
+ * This allows error responses to include appropriate HTTP status codes.
+ */
+export declare class ServerError extends Error {
+    status: number;
+    /**
+     * Creates a new ServerError instance.
+     *
+     * @param status - The HTTP status code for this error (e.g., 400, 404, 500)
+     * @param message - The error message describing what went wrong
+     */
+    constructor(status: number, message: string);
+}

package/lib/cjs/http-server/error.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerError = void 0;
+/**
+ * Custom error class for AIGNEServer HTTP-related errors.
+ * Extends the standard Error class with an HTTP status code property.
+ * This allows error responses to include appropriate HTTP status codes.
+ */
+class ServerError extends Error {
+    status;
+    /**
+     * Creates a new ServerError instance.
+     *
+     * @param status - The HTTP status code for this error (e.g., 400, 404, 500)
+     * @param message - The error message describing what went wrong
+     */
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+    }
+}
+exports.ServerError = ServerError;