noumen 0.1.0 → 0.2.0

package/dist/providers/openrouter.js

@@ -0,0 +1,23 @@
+import {
+  OpenAIProvider
+} from "../chunk-CPFHEPW4.js";
+import "../chunk-DGUM43GV.js";
+
+// src/providers/openrouter.ts
+var OpenRouterProvider = class extends OpenAIProvider {
+  constructor(opts) {
+    super({
+      apiKey: opts.apiKey,
+      baseURL: "https://openrouter.ai/api/v1",
+      model: opts.model ?? "anthropic/claude-opus-4.6",
+      defaultHeaders: {
+        ...opts.appName ? { "X-Title": opts.appName } : {},
+        ...opts.appUrl ? { "HTTP-Referer": opts.appUrl } : {}
+      }
+    });
+  }
+};
+export {
+  OpenRouterProvider
+};
+//# sourceMappingURL=openrouter.js.map

package/dist/providers/openrouter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/openrouter.ts"],"sourcesContent":["import { OpenAIProvider } from \"./openai.js\";\n\nexport interface OpenRouterProviderOptions {\n  apiKey: string;\n  model?: string;\n  /** Displayed on openrouter.ai rankings. Sent as the `X-Title` header. */\n  appName?: string;\n  /** Used for openrouter.ai rankings. Sent as the `HTTP-Referer` header. */\n  appUrl?: string;\n}\n\nexport class OpenRouterProvider extends OpenAIProvider {\n  constructor(opts: OpenRouterProviderOptions) {\n    super({\n      apiKey: opts.apiKey,\n      baseURL: \"https://openrouter.ai/api/v1\",\n      model: opts.model ?? \"anthropic/claude-opus-4.6\",\n      defaultHeaders: {\n        ...(opts.appName ? { \"X-Title\": opts.appName } : {}),\n        ...(opts.appUrl ? { \"HTTP-Referer\": opts.appUrl } : {}),\n      },\n    });\n  }\n}\n"],"mappings":";;;;;;AAWO,IAAM,qBAAN,cAAiC,eAAe;AAAA,EACrD,YAAY,MAAiC;AAC3C,UAAM;AAAA,MACJ,QAAQ,KAAK;AAAA,MACb,SAAS;AAAA,MACT,OAAO,KAAK,SAAS;AAAA,MACrB,gBAAgB;AAAA,QACd,GAAI,KAAK,UAAU,EAAE,WAAW,KAAK,QAAQ,IAAI,CAAC;AAAA,QAClD,GAAI,KAAK,SAAS,EAAE,gBAAgB,KAAK,OAAO,IAAI,CAAC;AAAA,MACvD;AAAA,IACF,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/providers/vertex.d.ts

@@ -0,0 +1,40 @@
+import { A as AIProvider, C as ChatParams, a as ChatStreamChunk } from '../types-3c88cRKH.js';
+import { C as CacheControlConfig } from '../cache-DVqaCX8v.js';
+
+interface VertexAnthropicProviderOptions {
+    /** GCP project ID. If omitted, inferred from application default credentials. */
+    projectId?: string;
+    /** GCP region (default: us-east5). */
+    region?: string;
+    /**
+     * A `GoogleAuth` instance or any object with a compatible `getClient()` method.
+     * If omitted, the provider creates one using application default credentials.
+     * Requires `google-auth-library` as a peer dependency.
+     */
+    googleAuth?: unknown;
+    /** Model ID in Vertex format (default: claude-opus-4.6). */
+    model?: string;
+    /** Cache control config (same as AnthropicProvider). */
+    cacheControl?: CacheControlConfig;
+    /**
+     * Pre-constructed AnthropicVertex client. When provided, all other
+     * connection options are ignored. Useful for testing or advanced setups.
+     */
+    client?: unknown;
+}
+/**
+ * Anthropic provider routed through Google Cloud Vertex AI.
+ *
+ * Requires `@anthropic-ai/vertex-sdk` as an optional peer dependency.
+ * If `googleAuth` is not provided, also requires `google-auth-library`.
+ * Install with: `pnpm add @anthropic-ai/vertex-sdk google-auth-library`
+ */
+declare class VertexAnthropicProvider implements AIProvider {
+    private client;
+    private defaultModel;
+    private cacheConfig;
+    constructor(opts: VertexAnthropicProviderOptions);
+    chat(params: ChatParams): AsyncIterable<ChatStreamChunk>;
+}
+
+export { VertexAnthropicProvider, type VertexAnthropicProviderOptions };

package/dist/providers/vertex.js

@@ -0,0 +1,64 @@
+import {
+  streamAnthropicChat
+} from "../chunk-2ZTGQLYK.js";
+import "../chunk-KY6ZPWHO.js";
+import {
+  __require
+} from "../chunk-DGUM43GV.js";
+
+// src/providers/vertex.ts
+var VertexAnthropicProvider = class {
+  client;
+  defaultModel;
+  cacheConfig;
+  constructor(opts) {
+    if (opts.client) {
+      this.client = opts.client;
+    } else {
+      let AnthropicVertex;
+      try {
+        AnthropicVertex = __require("@anthropic-ai/vertex-sdk").AnthropicVertex;
+      } catch {
+        throw new Error(
+          "VertexAnthropicProvider requires @anthropic-ai/vertex-sdk. Install it with: pnpm add @anthropic-ai/vertex-sdk"
+        );
+      }
+      let googleAuth = opts.googleAuth;
+      if (!googleAuth) {
+        let GoogleAuth;
+        try {
+          GoogleAuth = __require("google-auth-library").GoogleAuth;
+        } catch {
+          throw new Error(
+            "VertexAnthropicProvider requires google-auth-library when googleAuth is not provided. Install it with: pnpm add google-auth-library"
+          );
+        }
+        const authArgs = {
+          scopes: ["https://www.googleapis.com/auth/cloud-platform"]
+        };
+        if (opts.projectId) authArgs.projectId = opts.projectId;
+        googleAuth = new GoogleAuth(authArgs);
+      }
+      const args = {
+        region: opts.region ?? "us-east5",
+        googleAuth
+      };
+      if (opts.projectId) args.projectId = opts.projectId;
+      this.client = new AnthropicVertex(args);
+    }
+    this.defaultModel = opts.model ?? "claude-opus-4.6";
+    this.cacheConfig = opts.cacheControl;
+  }
+  async *chat(params) {
+    yield* streamAnthropicChat(
+      this.client,
+      params,
+      this.defaultModel,
+      this.cacheConfig
+    );
+  }
+};
+export {
+  VertexAnthropicProvider
+};
+//# sourceMappingURL=vertex.js.map

package/dist/providers/vertex.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/vertex.ts"],"sourcesContent":["import type {\n  AIProvider,\n  ChatParams,\n  ChatStreamChunk,\n} from \"./types.js\";\nimport type { CacheControlConfig } from \"./cache.js\";\nimport { streamAnthropicChat, type AnthropicStreamClient } from \"./anthropic-shared.js\";\n\nexport interface VertexAnthropicProviderOptions {\n  /** GCP project ID. If omitted, inferred from application default credentials. */\n  projectId?: string;\n  /** GCP region (default: us-east5). */\n  region?: string;\n  /**\n   * A `GoogleAuth` instance or any object with a compatible `getClient()` method.\n   * If omitted, the provider creates one using application default credentials.\n   * Requires `google-auth-library` as a peer dependency.\n   */\n  googleAuth?: unknown;\n  /** Model ID in Vertex format (default: claude-opus-4.6). */\n  model?: string;\n  /** Cache control config (same as AnthropicProvider). */\n  cacheControl?: CacheControlConfig;\n  /**\n   * Pre-constructed AnthropicVertex client. When provided, all other\n   * connection options are ignored. Useful for testing or advanced setups.\n   */\n  client?: unknown;\n}\n\n/**\n * Anthropic provider routed through Google Cloud Vertex AI.\n *\n * Requires `@anthropic-ai/vertex-sdk` as an optional peer dependency.\n * If `googleAuth` is not provided, also requires `google-auth-library`.\n * Install with: `pnpm add @anthropic-ai/vertex-sdk google-auth-library`\n */\nexport class VertexAnthropicProvider implements AIProvider {\n  private client: AnthropicStreamClient;\n  private defaultModel: string;\n  private cacheConfig: CacheControlConfig | undefined;\n\n  constructor(opts: VertexAnthropicProviderOptions) {\n    if (opts.client) {\n      this.client = opts.client as AnthropicStreamClient;\n    } else {\n      let AnthropicVertex: new (args: Record<string, unknown>) => unknown;\n      try {\n        // eslint-disable-next-line @typescript-eslint/no-require-imports\n        AnthropicVertex = require(\"@anthropic-ai/vertex-sdk\").AnthropicVertex;\n      } catch {\n        throw new Error(\n          \"VertexAnthropicProvider requires @anthropic-ai/vertex-sdk. \" +\n            \"Install it with: pnpm add @anthropic-ai/vertex-sdk\",\n        );\n      }\n\n      let googleAuth = opts.googleAuth;\n      if (!googleAuth) {\n        let GoogleAuth: new (args: Record<string, unknown>) => unknown;\n        try {\n          // eslint-disable-next-line @typescript-eslint/no-require-imports\n          GoogleAuth = require(\"google-auth-library\").GoogleAuth;\n        } catch {\n          throw new Error(\n            \"VertexAnthropicProvider requires google-auth-library when googleAuth is not provided. \" +\n              \"Install it with: pnpm add google-auth-library\",\n          );\n        }\n        const authArgs: Record<string, unknown> = {\n          scopes: [\"https://www.googleapis.com/auth/cloud-platform\"],\n        };\n        if (opts.projectId) authArgs.projectId = opts.projectId;\n        googleAuth = new GoogleAuth(authArgs);\n      }\n\n      const args: Record<string, unknown> = {\n        region: opts.region ?? \"us-east5\",\n        googleAuth,\n      };\n      if (opts.projectId) args.projectId = opts.projectId;\n\n      this.client = new AnthropicVertex(args) as unknown as AnthropicStreamClient;\n    }\n\n    this.defaultModel = opts.model ?? \"claude-opus-4.6\";\n    this.cacheConfig = opts.cacheControl;\n  }\n\n  async *chat(params: ChatParams): AsyncIterable<ChatStreamChunk> {\n    yield* streamAnthropicChat(\n      this.client,\n      params,\n      this.defaultModel,\n      this.cacheConfig,\n    );\n  }\n}\n"],"mappings":";;;;;;;;;AAqCO,IAAM,0BAAN,MAAoD;AAAA,EACjD;AAAA,EACA;AAAA,EACA;AAAA,EAER,YAAY,MAAsC;AAChD,QAAI,KAAK,QAAQ;AACf,WAAK,SAAS,KAAK;AAAA,IACrB,OAAO;AACL,UAAI;AACJ,UAAI;AAEF,0BAAkB,UAAQ,0BAA0B,EAAE;AAAA,MACxD,QAAQ;AACN,cAAM,IAAI;AAAA,UACR;AAAA,QAEF;AAAA,MACF;AAEA,UAAI,aAAa,KAAK;AACtB,UAAI,CAAC,YAAY;AACf,YAAI;AACJ,YAAI;AAEF,uBAAa,UAAQ,qBAAqB,EAAE;AAAA,QAC9C,QAAQ;AACN,gBAAM,IAAI;AAAA,YACR;AAAA,UAEF;AAAA,QACF;AACA,cAAM,WAAoC;AAAA,UACxC,QAAQ,CAAC,gDAAgD;AAAA,QAC3D;AACA,YAAI,KAAK,UAAW,UAAS,YAAY,KAAK;AAC9C,qBAAa,IAAI,WAAW,QAAQ;AAAA,MACtC;AAEA,YAAM,OAAgC;AAAA,QACpC,QAAQ,KAAK,UAAU;AAAA,QACvB;AAAA,MACF;AACA,UAAI,KAAK,UAAW,MAAK,YAAY,KAAK;AAE1C,WAAK,SAAS,IAAI,gBAAgB,IAAI;AAAA,IACxC;AAEA,SAAK,eAAe,KAAK,SAAS;AAClC,SAAK,cAAc,KAAK;AAAA,EAC1B;AAAA,EAEA,OAAO,KAAK,QAAoD;AAC9D,WAAO;AAAA,MACL,KAAK;AAAA,MACL;AAAA,MACA,KAAK;AAAA,MACL,KAAK;AAAA,IACP;AAAA,EACF;AACF;","names":[]}

package/dist/render-GRN4ZSSW.js

@@ -0,0 +1,14 @@
+import {
+  createRenderState,
+  isVisibleEvent,
+  promptPermission,
+  renderEvent
+} from "./chunk-OGXNFXFA.js";
+import "./chunk-DGUM43GV.js";
+export {
+  createRenderState,
+  isVisibleEvent,
+  promptPermission,
+  renderEvent
+};
+//# sourceMappingURL=render-GRN4ZSSW.js.map

package/dist/render-GRN4ZSSW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/resolve-XM52G7YE.js

@@ -0,0 +1,14 @@
+import {
+  DEFAULT_MODELS,
+  SUPPORTED_PROVIDERS,
+  detectProvider,
+  resolveProvider
+} from "./chunk-7ZMN7XJE.js";
+import "./chunk-DGUM43GV.js";
+export {
+  DEFAULT_MODELS,
+  SUPPORTED_PROVIDERS,
+  detectProvider,
+  resolveProvider
+};
+//# sourceMappingURL=resolve-XM52G7YE.js.map

package/dist/resolve-XM52G7YE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/server/index.d.ts

@@ -0,0 +1,128 @@
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { A as Agent } from '../agent-BrkbZyOT.js';
+import '../types-3c88cRKH.js';
+import '../types-CwKKucOF.js';
+import '../types-DwdzmXfs.js';
+import '../cache-DVqaCX8v.js';
+import '../types-2kTLUCnD.js';
+import '@modelcontextprotocol/sdk/client/index.js';
+import '@modelcontextprotocol/sdk/client/auth.js';
+import '@modelcontextprotocol/sdk/shared/auth.js';
+
+type MaybePromise<T> = T | Promise<T>;
+interface ServerOptions {
+    port: number;
+    host?: string;
+    /** Enable WebSocket transport (default true). Requires `ws` peer dependency. */
+    ws?: boolean;
+    auth?: AuthConfig;
+    /** Maximum number of concurrent sessions (default unlimited). */
+    maxSessions?: number;
+    /** Automatically clean up sessions idle longer than this (ms). No timeout by default. */
+    idleTimeoutMs?: number;
+    /** Called on every new connection; return overrides for the session. */
+    onConnection?: (info: ConnectionInfo) => MaybePromise<ConnectionOverrides>;
+    onError?: (err: Error) => void;
+    /** Enable CORS for browser clients (default true). */
+    cors?: boolean;
+    /** Timeout for pending permission/input responses before rejecting (ms). Default 120000. */
+    pendingTimeoutMs?: number;
+}
+/**
+ * Options for `createRequestHandler()` — same as `ServerOptions` but without
+ * `port` / `host` / `ws` since the caller owns the HTTP server.
+ */
+interface RequestHandlerOptions {
+    auth?: AuthConfig;
+    maxSessions?: number;
+    idleTimeoutMs?: number;
+    onConnection?: (info: ConnectionInfo) => MaybePromise<ConnectionOverrides>;
+    onError?: (err: Error) => void;
+    cors?: boolean;
+    pendingTimeoutMs?: number;
+}
+type AuthConfig = {
+    type: "bearer";
+    token: string;
+} | {
+    type: "custom";
+    verify: (req: IncomingMessage) => MaybePromise<AuthResult | null>;
+};
+interface AuthResult {
+    [key: string]: unknown;
+}
+interface ConnectionInfo {
+    auth: AuthResult;
+    remoteAddress?: string;
+}
+interface ConnectionOverrides {
+    cwd?: string;
+}
+declare class NoumenServer {
+    private code;
+    private options;
+    private httpServer;
+    private wss;
+    private sessions;
+    private idleTimer;
+    constructor(code: Agent, options: ServerOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getActiveSessions(): Map<string, {
+        id: string;
+        lastActivity: number;
+        done: boolean;
+    }>;
+    private initWebSocket;
+    /**
+     * Handle an HTTP request. Used internally by `start()` and exposed for
+     * `createRequestHandler()` so the same logic can be mounted on an
+     * external Express / Fastify / Hono server.
+     */
+    handleRequest(req: IncomingMessage, res: ServerResponse): Promise<void>;
+    private idleReaperStarted;
+    private ensureIdleReaper;
+    private handleHttp;
+    private authenticate;
+    private handleCreateSession;
+    private handleListSessions;
+    private handleSseStream;
+    private handlePermissionResponse;
+    private handleInputResponse;
+    private handleSendMessage;
+    private handleDeleteSession;
+    private handleWsConnection;
+    private handleWsMessage;
+    private createSessionState;
+    private makeThread;
+    private runAgentSse;
+    private runAgentWs;
+    private emitSseEvent;
+    private bridgePermission;
+    private bridgeUserInput;
+    private startSseKeepalive;
+    private clearSseKeepalive;
+    private clearPendingPermissionTimer;
+    private clearPendingInputTimer;
+    private destroySession;
+    private reapIdleSessions;
+    private resolveConnectionOverrides;
+}
+declare function createServer(code: Agent, options: ServerOptions): NoumenServer;
+/**
+ * Create a `(req, res)` handler that can be mounted on any Node HTTP
+ * framework (Express, Fastify, Hono, bare `http.createServer`, etc.).
+ *
+ * ```ts
+ * import express from "express";
+ * import { createRequestHandler } from "noumen/server";
+ *
+ * const app = express();
+ * app.use("/agent", createRequestHandler(code, { auth: { type: "bearer", token: "..." } }));
+ * ```
+ *
+ * WebSocket is not supported in middleware mode — use `createServer()` for WS.
+ */
+declare function createRequestHandler(code: Agent, options?: RequestHandlerOptions): (req: IncomingMessage, res: ServerResponse) => void;
+
+export { type AuthConfig, type AuthResult, type ConnectionInfo, type ConnectionOverrides, NoumenServer, type RequestHandlerOptions, type ServerOptions, createRequestHandler, createServer };