@sisu-ai/server 7.0.1 → 7.0.3

package/README.md

@@ -1,3 +1,9 @@
+<div align="right">
+  <a href="https://github.com/finger-gun/sisu"><img src="https://github.com/finger-gun/sisu/raw/main/sisu-light.svg" alt="ProjectSpecs" width="100" /></a>
+</div>
+
+---
+
 # @sisu-ai/server
 
 Standalone HTTP/HTTPS adapter for Sisu agents. Spin up an HTTP server or attach to an existing one while keeping the small core philosophy.
@@ -104,3 +110,78 @@ Discover what you can do through examples or documentation. Check it out at http
 - [License](https://github.com/finger-gun/sisu/blob/main/LICENSE)
 - [Report a Bug](https://github.com/finger-gun/sisu/issues/new?template=bug_report.md)
 - [Request a Feature](https://github.com/finger-gun/sisu/issues/new?template=feature_request.md)
+
+---
+
+## Documentation
+
+**Core** — [Package docs](packages/core/README.md) · [Error types](packages/core/ERROR_TYPES.md)
+
+**Adapters** — [OpenAI](packages/adapters/openai/README.md) · [Anthropic](packages/adapters/anthropic/README.md) · [Ollama](packages/adapters/ollama/README.md)
+
+<details>
+<summary>All middleware packages</summary>
+
+- [@sisu-ai/mw-agent-run-api](packages/middleware/agent-run-api/README.md)
+- [@sisu-ai/mw-context-compressor](packages/middleware/context-compressor/README.md)
+- [@sisu-ai/mw-control-flow](packages/middleware/control-flow/README.md)
+- [@sisu-ai/mw-conversation-buffer](packages/middleware/conversation-buffer/README.md)
+- [@sisu-ai/mw-cors](packages/middleware/cors/README.md)
+- [@sisu-ai/mw-error-boundary](packages/middleware/error-boundary/README.md)
+- [@sisu-ai/mw-guardrails](packages/middleware/guardrails/README.md)
+- [@sisu-ai/mw-invariants](packages/middleware/invariants/README.md)
+- [@sisu-ai/mw-orchestration](packages/middleware/orchestration/README.md)
+- [@sisu-ai/mw-rag](packages/middleware/rag/README.md)
+- [@sisu-ai/mw-react-parser](packages/middleware/react-parser/README.md)
+- [@sisu-ai/mw-register-tools](packages/middleware/register-tools/README.md)
+- [@sisu-ai/mw-tool-calling](packages/middleware/tool-calling/README.md)
+- [@sisu-ai/mw-trace-viewer](packages/middleware/trace-viewer/README.md)
+- [@sisu-ai/mw-usage-tracker](packages/middleware/usage-tracker/README.md)
+</details>
+
+<details>
+<summary>All tool packages</summary>
+
+- [@sisu-ai/tool-aws-s3](packages/tools/aws-s3/README.md)
+- [@sisu-ai/tool-azure-blob](packages/tools/azure-blob/README.md)
+- [@sisu-ai/tool-extract-urls](packages/tools/extract-urls/README.md)
+- [@sisu-ai/tool-github-projects](packages/tools/github-projects/README.md)
+- [@sisu-ai/tool-summarize-text](packages/tools/summarize-text/README.md)
+- [@sisu-ai/tool-terminal](packages/tools/terminal/README.md)
+- [@sisu-ai/tool-vec-chroma](packages/tools/vec-chroma/README.md)
+- [@sisu-ai/tool-web-fetch](packages/tools/web-fetch/README.md)
+- [@sisu-ai/tool-web-search-duckduckgo](packages/tools/web-search-duckduckgo/README.md)
+- [@sisu-ai/tool-web-search-google](packages/tools/web-search-google/README.md)
+- [@sisu-ai/tool-web-search-openai](packages/tools/web-search-openai/README.md)
+- [@sisu-ai/tool-wikipedia](packages/tools/wikipedia/README.md)
+</details>
+
+<details>
+<summary>All examples</summary>
+
+**Anthropic** — [hello](examples/anthropic-hello/README.md) · [control-flow](examples/anthropic-control-flow/README.md) · [stream](examples/anthropic-stream/README.md) · [weather](examples/anthropic-weather/README.md)
+
+**Ollama** — [hello](examples/ollama-hello/README.md) · [stream](examples/ollama-stream/README.md) · [vision](examples/ollama-vision/README.md) · [weather](examples/ollama-weather/README.md) · [web-search](examples/ollama-web-search/README.md)
+
+**OpenAI** — [hello](examples/openai-hello/README.md) · [weather](examples/openai-weather/README.md) · [stream](examples/openai-stream/README.md) · [vision](examples/openai-vision/README.md) · [reasoning](examples/openai-reasoning/README.md) · [react](examples/openai-react/README.md) · [control-flow](examples/openai-control-flow/README.md) · [branch](examples/openai-branch/README.md) · [parallel](examples/openai-parallel/README.md) · [graph](examples/openai-graph/README.md) · [orchestration](examples/openai-orchestration/README.md) · [orchestration-adaptive](examples/openai-orchestration-adaptive/README.md) · [guardrails](examples/openai-guardrails/README.md) · [error-handling](examples/openai-error-handling/README.md) · [rag-chroma](examples/openai-rag-chroma/README.md) · [web-search](examples/openai-web-search/README.md) · [web-fetch](examples/openai-web-fetch/README.md) · [wikipedia](examples/openai-wikipedia/README.md) · [terminal](examples/openai-terminal/README.md) · [github-projects](examples/openai-github-projects/README.md) · [server](examples/openai-server/README.md) · [aws-s3](examples/openai-aws-s3/README.md) · [azure-blob](examples/openai-azure-blob/README.md)
+</details>
+
+---
+
+## Contributing
+
+We build Sisu in the open. Contributions welcome.
+
+[Contributing Guide](CONTRIBUTING.md) · [Report a Bug](https://github.com/finger-gun/sisu/issues/new?template=bug_report.md) · [Request a Feature](https://github.com/finger-gun/sisu/issues/new?template=feature_request.md) · [Code of Conduct](CODE_OF_CONDUCT.md)
+
+---
+
+<div align="center">
+
+**[Star on GitHub](https://github.com/finger-gun/sisu)** if Sisu helps you build better agents.
+
+*Quiet, determined, relentlessly useful.*
+
+[Apache 2.0 License](LICENSE)
+
+</div>

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import http, { type IncomingMessage, type ServerResponse } from 'http';
-import https from 'https';
-import type { Agent, Logger } from '@sisu-ai/core';
-import type { AddressInfo } from 'net';
-export { matchRoute } from './router.js';
+import http, { type IncomingMessage, type ServerResponse } from "http";
+import https from "https";
+import type { Agent, Logger, Ctx } from "@sisu-ai/core";
+import type { AddressInfo } from "net";
+export { matchRoute } from "./router.js";
 export interface ListenOptions<Ctx> {
     tls?: https.ServerOptions;
     port?: number;
@@ -15,10 +15,15 @@ export interface ListenOptions<Ctx> {
     logBanner?: boolean;
     bannerEndpoints?: string[];
     logger?: Logger;
-    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+    logLevel?: "debug" | "info" | "warn" | "error";
     redactLogKeys?: string[];
 }
-export declare class Server<Ctx = any> {
+type HttpEnvelope<CtxT extends Ctx> = {
+    req?: IncomingMessage;
+    res?: ServerResponse;
+    agent?: Agent<CtxT>;
+};
+export declare class Server<CtxT extends Ctx & HttpEnvelope<CtxT>> {
     private agent;
     private opts;
     private server?;
@@ -26,59 +31,59 @@ export declare class Server<Ctx = any> {
     private healthPath;
     private createCtx;
     private emitter;
-    constructor(agent: Agent<any>, opts?: ListenOptions<Ctx>);
+    constructor(agent: Agent<CtxT>, opts?: ListenOptions<CtxT>);
     private handle;
     listener(): (req: IncomingMessage, res: ServerResponse) => Promise<void>;
     listen(cb?: () => void): http.Server<typeof http.IncomingMessage, typeof http.ServerResponse> | https.Server<typeof http.IncomingMessage, typeof http.ServerResponse>;
     attach(server: http.Server | https.Server): void;
     close(cb?: (err?: Error) => void): void;
     address(): string | AddressInfo | null | undefined;
-    on(event: 'listening', handler: (e: {
+    on(event: "listening", handler: (e: {
         url: string;
         address: string | AddressInfo | null | undefined;
     }) => void): this;
-    on(event: 'request', handler: (e: {
+    on(event: "request", handler: (e: {
         method: string;
         url: string;
     }) => void): this;
-    on(event: 'response', handler: (e: {
+    on(event: "response", handler: (e: {
         method: string;
         url: string;
         status: number;
         duration_ms: number;
     }) => void): this;
-    on(event: 'error', handler: (err: Error) => void): this;
-    on(event: 'close', handler: () => void): this;
-    once(event: 'listening', handler: (e: {
+    on(event: "error", handler: (err: Error) => void): this;
+    on(event: "close", handler: () => void): this;
+    once(event: "listening", handler: (e: {
         url: string;
         address: string | AddressInfo | null | undefined;
     }) => void): this;
-    once(event: 'request', handler: (e: {
+    once(event: "request", handler: (e: {
         method: string;
         url: string;
     }) => void): this;
-    once(event: 'response', handler: (e: {
+    once(event: "response", handler: (e: {
         method: string;
         url: string;
         status: number;
         duration_ms: number;
     }) => void): this;
-    once(event: 'error', handler: (err: Error) => void): this;
-    once(event: 'close', handler: () => void): this;
-    off(event: 'listening', handler: (e: {
+    once(event: "error", handler: (err: Error) => void): this;
+    once(event: "close", handler: () => void): this;
+    off(event: "listening", handler: (e: {
         url: string;
         address: string | AddressInfo | null | undefined;
     }) => void): this;
-    off(event: 'request', handler: (e: {
+    off(event: "request", handler: (e: {
         method: string;
         url: string;
     }) => void): this;
-    off(event: 'response', handler: (e: {
+    off(event: "response", handler: (e: {
         method: string;
         url: string;
         status: number;
         duration_ms: number;
     }) => void): this;
-    off(event: 'error', handler: (err: Error) => void): this;
-    off(event: 'close', handler: () => void): this;
+    off(event: "error", handler: (err: Error) => void): this;
+    off(event: "close", handler: () => void): this;
 }

package/dist/index.js

@@ -1,33 +1,50 @@
-import http from 'http';
-import https from 'https';
-import { createConsoleLogger, createRedactingLogger } from '@sisu-ai/core';
-import { EventEmitter } from 'events';
-export { matchRoute } from './router.js';
+import http from "http";
+import https from "https";
+import { createConsoleLogger, createRedactingLogger } from "@sisu-ai/core";
+import { EventEmitter } from "events";
+export { matchRoute } from "./router.js";
 export class Server {
     constructor(agent, opts = {}) {
         this.agent = agent;
         this.opts = opts;
         this.emitter = new EventEmitter();
-        this.basePath = opts.basePath ?? '/api';
-        this.healthPath = opts.healthPath ?? '/health';
-        this.createCtx = opts.createCtx ?? ((req, res) => ({ req, res }));
+        this.basePath = opts.basePath ?? "/api";
+        this.healthPath = opts.healthPath ?? "/health";
+        this.createCtx =
+            opts.createCtx ?? ((req, res) => ({ req, res }));
     }
     async handle(req, res) {
         // Set up server-level request logging (independent of ctx)
-        const baseLogger = this.opts.logger ?? createConsoleLogger({ level: this.opts.logLevel, timestamps: true });
-        const srvLogger = createRedactingLogger(baseLogger, { keys: this.opts.redactLogKeys });
+        const baseLogger = this.opts.logger ??
+            createConsoleLogger({
+                level: this.opts.logLevel,
+                timestamps: true,
+            });
+        const srvLogger = createRedactingLogger(baseLogger, {
+            keys: this.opts.redactLogKeys,
+        });
         const started = Date.now();
-        const { method = 'GET', url = '' } = req;
-        srvLogger.info?.('[server] request', { method, url });
-        res.once?.('finish', () => {
+        const { method = "GET", url = "" } = req;
+        srvLogger.info?.("[server] request", { method, url });
+        res.once?.("finish", () => {
             const ms = Date.now() - started;
-            srvLogger.info?.('[server] response', { method, url, status: res.statusCode, duration_ms: ms });
-            this.emitter.emit('response', { method, url, status: res.statusCode, duration_ms: ms });
+            srvLogger.info?.("[server] response", {
+                method,
+                url,
+                status: res.statusCode,
+                duration_ms: ms,
+            });
+            this.emitter.emit("response", {
+                method,
+                url,
+                status: res.statusCode,
+                duration_ms: ms,
+            });
         });
-        this.emitter.emit('request', { method, url });
+        this.emitter.emit("request", { method, url });
         if (this.healthPath && req.url === this.healthPath) {
             res.statusCode = 200;
-            res.end('ok');
+            res.end("ok");
             return;
         }
         if (!req.url || !req.url.startsWith(this.basePath)) {
@@ -44,16 +61,24 @@ export class Server {
         // Mark this context as an HTTP transport envelope and capture minimal request meta
         const headers = req.headers || {};
         const httpMeta = {
-            method: req.method || 'GET',
-            url: req.url || '',
-            ip: (req.socket && (req.socket.remoteAddress || '')) || '',
+            method: req.method || "GET",
+            url: req.url || "",
+            ip: (req.socket && (req.socket.remoteAddress || "")) || "",
             headers: {
-                'user-agent': typeof headers['user-agent'] === 'string' ? headers['user-agent'] : undefined,
-                'accept': typeof headers['accept'] === 'string' ? headers['accept'] : undefined,
-                'content-type': typeof headers['content-type'] === 'string' ? headers['content-type'] : undefined,
+                "user-agent": typeof headers["user-agent"] === "string"
+                    ? headers["user-agent"]
+                    : undefined,
+                accept: typeof headers["accept"] === "string" ? headers["accept"] : undefined,
+                "content-type": typeof headers["content-type"] === "string"
+                    ? headers["content-type"]
+                    : undefined,
             },
         };
-        ctx.state = { ...(ctx.state ?? {}), _transport: { type: 'http' }, _http: httpMeta };
+        ctx.state = {
+            ...(ctx.state ?? {}),
+            _transport: { type: "http" },
+            _http: httpMeta,
+        };
         const handler = this.agent.handler();
         await handler(ctx);
         // Only synthesize a 404 when nothing has been written at all.
@@ -77,17 +102,19 @@ export class Server {
         else {
             this.server.listen(this.opts.port ?? 0, this.opts.host, this.opts.backlog, cb);
         }
-        this.server.on('error', (err) => this.emitter.emit('error', err));
-        this.server.on('close', () => this.emitter.emit('close'));
+        this.server.on("error", (err) => this.emitter.emit("error", err));
+        this.server.on("close", () => this.emitter.emit("close"));
         const printBanner = this.opts.logBanner !== false;
         if (printBanner) {
             const addr = this.server.address();
-            let url = '';
-            if (typeof addr === 'object' && addr && 'port' in addr) {
-                const host = this.opts.host && this.opts.host !== '0.0.0.0' ? this.opts.host : 'localhost';
+            let url = "";
+            if (typeof addr === "object" && addr && "port" in addr) {
+                const host = this.opts.host && this.opts.host !== "0.0.0.0"
+                    ? this.opts.host
+                    : "localhost";
                 url = `http://${host}:${addr.port}`;
             }
-            else if (typeof addr === 'string') {
+            else if (typeof addr === "string") {
                 url = addr;
             }
             if (url)
@@ -97,16 +124,19 @@ export class Server {
             if (this.basePath)
                 console.log(`[server] basePath: ${this.basePath}`);
             if (this.opts.bannerEndpoints?.length) {
-                console.log('[server] endpoints:');
+                console.log("[server] endpoints:");
                 for (const ep of this.opts.bannerEndpoints)
                     console.log(`  ${ep}`);
             }
-            this.emitter.emit('listening', { url, address: addr });
+            this.emitter.emit("listening", {
+                url,
+                address: addr,
+            });
         }
         return this.server;
     }
     attach(server) {
-        server.on('request', this.listener());
+        server.on("request", this.listener());
         this.server = server;
     }
     close(cb) {
@@ -115,7 +145,16 @@ export class Server {
     address() {
         return this.server?.address();
     }
-    on(event, handler) { this.emitter.on(event, handler); return this; }
-    once(event, handler) { this.emitter.once(event, handler); return this; }
-    off(event, handler) { this.emitter.off(event, handler); return this; }
+    on(event, handler) {
+        this.emitter.on(event, handler);
+        return this;
+    }
+    once(event, handler) {
+        this.emitter.once(event, handler);
+        return this;
+    }
+    off(event, handler) {
+        this.emitter.off(event, handler);
+        return this;
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sisu-ai/server",
-  "version": "7.0.1",
+  "version": "7.0.3",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/index.js",
@@ -12,7 +12,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@sisu-ai/core": "^2.3.1"
+    "@sisu-ai/core": "^2.3.2"
   },
   "repository": {
     "type": "git",