somamcp 1.5.0 → 2.0.0

package/dist/{index-C2wa9nmp.d.ts → index-ololl9dI.d.ts}

@@ -1,6 +1,6 @@
 import { Transport } from "@modelcontextprotocol/server";
+import { Option } from "functype";
 import { Hono } from "hono";
-//#region src/types/core.d.ts
 type SessionAuth = Record<string, unknown> | undefined;
 /**
  * Structural type compatible with StandardSchemaV1 (zod, valibot, etc.)
@@ -170,8 +170,6 @@ type ServerStatus = "error" | "running" | "stopped";
 declare class UserError extends Error {
   constructor(message: string);
 }
-//#endregion
-//#region src/types/server.d.ts
 type Logger = {
   debug: (...args: unknown[]) => void;
   error: (...args: unknown[]) => void;
@@ -180,7 +178,17 @@ type Logger = {
   warn: (...args: unknown[]) => void;
 };
 type ServerConfig<T extends SessionAuth = SessionAuth> = {
-  authenticate?: (request: unknown) => Promise<T>;
+  /**
+   * Authenticate a request; resolve to the session that tools see as `context.session`.
+   * Rejecting, throwing, or resolving to `undefined`/`null` fails it with a 401. On the
+   * MCP endpoint, reject with a `Response` to send that instead; protected artifacts and
+   * routes answer with their `onUnauthorized`, or 401.
+   *
+   * Receives the web `Request` for MCP calls and for protected artifacts and routes, on
+   * every runtime. On stdio there is no request: it is called once with `undefined`, and
+   * a failure serves without a session. Read headers with `getRequestHeader`.
+   */
+  authenticate?: (request: Request | undefined) => Promise<T>;
   instructions?: string;
   logger?: Logger;
   name: string;
@@ -189,44 +197,35 @@ type ServerConfig<T extends SessionAuth = SessionAuth> = {
    * balancer does not close the connection as idle while a long-running tool produces no
    * output — a large document read, say.
    *
-   * This is the only keepalive that survives `httpStream.stateless`. A transport-level ping
-   * needs the standing server-to-client stream, and stateless has none; these travel on the
-   * request's own stream instead. If you set `stateless` and have anything with an idle
-   * timeout in front of you, you want this too.
+   * They are SSE comment frames on the request's own stream, so they work although the
+   * server keeps no sessions. With this on, every response streams as SSE, because a JSON
+   * response cannot carry them.
    *
-   * Set at construction rather than on `httpStream`, because the backend builds its server
+   * Set at construction rather than on `httpStream`, because the backend builds its handler
    * before `start()` ever sees the transport config.
-   *
-   * Honoured by the fastmcp backend. The edge backend ignores it — Workers and Deno Deploy
-   * terminate the connection themselves, so there is nothing for somamcp to keep alive.
    */
   streamKeepalive?: {
     /** Whether to write keepalives. Opt-in. */
     enabled?: boolean;
     /**
      * Gap between keepalives. Keep it comfortably under the shortest idle timeout on the
-     * path — an AWS ALB defaults to 60s. Defaults to 20s in the fastmcp backend.
+     * path — an AWS ALB defaults to 60s. Defaults to 20s.
      */
     intervalMs?: number;
-    /**
-     * Level reported on the keepalive notification. Defaults to `debug` in the fastmcp
-     * backend, which is usually what you want — these fire every interval, for the whole
-     * length of every long call.
-     */
-    logLevel?: "alert" | "critical" | "debug" | "emergency" | "error" | "info" | "notice" | "warning";
   };
   version: `${number}.${number}.${number}`;
 };
 /**
- * httpStream transport options. All fields are passed through to the underlying
- * MCP backend unchanged; `port` is the only one required.
+ * Options for listening on a port, which needs `somamcp/node`. `port` is the only
+ * required field.
  *
- * - `cors` — `true` for permissive defaults, or a config object forwarded to the
- *   backend's CORS implementation. Only relevant for browser-facing servers.
- * - `stateless` — treat each request independently (no session state). Useful
- *   for horizontally-scaled or Lambda-style deployments.
- * - `eventStore` — pluggable store enabling resumable event streams; the
- *   backend's `EventStore` interface, opaque to somamcp.
+ * - `cors` — `true` for permissive defaults, or options for Hono's `cors()`. Only
+ *   relevant for browser-facing servers.
+ * - `enableJsonResponse` — answer `2026-07-28` requests with JSON instead of SSE.
+ *   It turns `streamKeepalive` off, since JSON cannot carry keepalive frames.
+ * - `endpoint` — the MCP path. Defaults to `/mcp`.
+ * - `host` — the address to bind. Defaults to `localhost`; set `0.0.0.0` in a container.
+ * - `stateless` — serving is always stateless; `false` logs a warning and is ignored.
  * - `sslCert` / `sslKey` / `sslCa` — inline PEM strings enabling TLS termination
  *   at the server. Omit for plain HTTP behind a proxy.
  */
@@ -234,7 +233,6 @@ type HttpStreamConfig = {
   cors?: boolean | Record<string, unknown>;
   enableJsonResponse?: boolean;
   endpoint?: `/${string}`;
-  eventStore?: unknown;
   host?: string;
   port: number;
   sslCa?: string;
@@ -248,8 +246,6 @@ type TransportConfig = {
   httpStream: HttpStreamConfig;
   transportType: "httpStream";
 };
-//#endregion
-//#region src/backend/adapter.d.ts
 type BackendSession<T extends SessionAuth = SessionAuth> = {
   sessionId?: string;
   auth?: T;
@@ -267,12 +263,11 @@ type BackendAdapter<T extends SessionAuth = SessionAuth> = {
   readonly sessions: ReadonlyArray<BackendSession<T>>;
   addPrompt: <Args extends PromptArgument<T>[]>(prompt: Prompt<T, Args>) => void;
   addResource: (resource: Resource<T>) => void;
-  addResourceTemplate: (...args: ReadonlyArray<unknown>) => void;
+  addResourceTemplate: (template: ResourceTemplate<T>) => void;
   addTool: <P extends SchemaParams>(tool: Tool<T, P>) => void;
   /**
    * Handle a web-standard Request. Optional: when absent, callers fall back to
-   * `getApp().fetch`. Edge backends implement this as their primary entry point;
-   * Node backends provide it for parity so `SomaServerInstance.fetch` always works.
+   * `getApp().fetch`. The SDK backend implements it as its primary entry point.
    */
   fetch?: (request: Request) => Promise<Response>;
   getApp: () => Hono;
@@ -281,9 +276,8 @@ type BackendAdapter<T extends SessionAuth = SessionAuth> = {
    * Whether `removeTool` / `removeResource` / `removePrompt` actually take
    * effect. Defaults to true when absent.
    *
-   * The edge backend sets this false: EdgeFastMCP exposes no removal API, so its
-   * `remove*` calls only warn. Capability counts must not shrink for a tool that
-   * is still being served.
+   * A backend that cannot remove sets this false, so capability counts do not
+   * shrink for a tool that is still being served.
    */
   readonly supportsRemoval?: boolean;
   removePrompt: (name: string) => void;
@@ -293,16 +287,11 @@ type BackendAdapter<T extends SessionAuth = SessionAuth> = {
   stop: () => Promise<void>;
 };
 type BackendFactory<T extends SessionAuth = SessionAuth> = (config: ServerConfig<T>, backendOptions?: Record<string, unknown>) => BackendAdapter<T>;
-//#endregion
-//#region src/backend/fastmcp.d.ts
-declare const createFastMCPBackend: <T extends SessionAuth = SessionAuth>(config: ServerConfig<T>, backendOptions?: Record<string, unknown>) => BackendAdapter<T>;
-//#endregion
-//#region src/backend/sdk/index.d.ts
 type SdkBackendOptions = {
   /** MCP endpoint path when serving through `fetch`. `start({ httpStream: { endpoint } })` overrides it. Defaults to "/mcp". */
   mcpPath?: string;
   /**
-   * Transport for `start({ transportType: "stdio" })` in place of the process's
+   * Node only (`somamcp/node`): transport for `start({ transportType: "stdio" })` in place of the process's
    * stdin/stdout, e.g. a `StdioServerTransport` over a Unix socket.
    */
   stdioTransport?: Transport;
@@ -316,9 +305,9 @@ type SdkBackendOptions = {
  * so there are no sessions, `connect`/`disconnect` never fire, and a 2025 client's
  * GET or DELETE is answered `405`.
  *
- * `start()` serves a port (`httpStream`) or stdio on Node; `fetch()` serves any
- * runtime with web-standard `Request`/`Response`.
+ * This is the WinterTC build: it serves through `fetch()` on any runtime with
+ * web-standard `Request`/`Response`, and `start()` with a transport rejects. For a
+ * port or stdio, use `createNodeBackend` from `somamcp/node`.
  */
 declare const createSdkBackend: <T extends SessionAuth = SessionAuth>(config: ServerConfig<T>, backendOptions?: Record<string, unknown>) => BackendAdapter<T>;
-//#endregion
-export { ServerStatus as A, Resource as C, ResourceTemplate as D, ResourceResult as E, UserError as F, TextContent as M, Tool as N, ResourceTemplateArgument as O, ToolAnnotations as P, PromptResult as S, ResourceLink as T, ImageContent as _, BackendEvents as a, Prompt as b, HttpStreamConfig as c, TransportConfig as d, AudioContent as f, Context$1 as g, ContentResult as h, BackendAdapter as i, SessionAuth as j, SchemaParams as k, Logger as l, Content as m, createSdkBackend as n, BackendFactory as o, Completion as p, createFastMCPBackend as r, BackendSession as s, SdkBackendOptions as t, ServerConfig as u, InferSchemaOutput as v, ResourceContent as w, PromptArgument as x, Progress as y };
+export { SessionAuth as A, ResourceContent as C, ResourceTemplateArgument as D, ResourceTemplate as E, Tool as M, ToolAnnotations as N, SchemaParams as O, UserError as P, Resource as S, ResourceResult as T, InferSchemaOutput as _, BackendFactory as a, PromptArgument as b, Logger as c, AudioContent as d, Completion as f, ImageContent as g, Context$1 as h, BackendEvents as i, TextContent as j, ServerStatus as k, ServerConfig as l, ContentResult as m, createSdkBackend as n, BackendSession as o, Content as p, BackendAdapter as r, HttpStreamConfig as s, SdkBackendOptions as t, TransportConfig as u, Progress as v, ResourceLink as w, PromptResult as x, Prompt as y };

package/dist/index.d.ts

@@ -1,474 +1,3 @@
-import { A as ServerStatus, C as Resource, D as ResourceTemplate, E as ResourceResult, F as UserError, M as TextContent, N as Tool, O as ResourceTemplateArgument, P as ToolAnnotations, S as PromptResult, T as ResourceLink, _ as ImageContent, b as Prompt, c as HttpStreamConfig, d as TransportConfig, f as AudioContent, g as Context, h as ContentResult, i as BackendAdapter, j as SessionAuth, k as SchemaParams, l as Logger, m as Content, o as BackendFactory, p as Completion, r as createFastMCPBackend, s as BackendSession, u as ServerConfig, v as InferSchemaOutput, w as ResourceContent, x as PromptArgument, y as Progress } from "./index-C2wa9nmp.js";
-import { Option } from "functype";
-import { Context as Context$1, Hono, MiddlewareHandler } from "hono";
-import { DirectLogger, DirectLogger as DirectLogger$1 } from "functype-log";
-import { z } from "zod";
-import { Tool as Tool$1 } from "@modelcontextprotocol/sdk/types.js";
-//#region src/artifacts/types.d.ts
-type ArtifactCommon = {
-  protected?: boolean;
-};
-type StaticArtifact = ArtifactCommon & {
-  contentType: string;
-  content: string;
-  path: string;
-  type: "static";
-};
-type DynamicArtifact = ArtifactCommon & {
-  handler: (c: Context$1) => Response | Promise<Response>;
-  path: string;
-  type: "dynamic";
-};
-type DirectoryArtifact = ArtifactCommon & {
-  directory: string;
-  path: string;
-  type: "directory";
-};
-type ArtifactConfig = DirectoryArtifact | DynamicArtifact | StaticArtifact;
-type ArtifactAuthenticate = (request: unknown) => Promise<unknown>;
-//#endregion
-//#region src/buildInfo.d.ts
-type BuildInfo = {
-  branch?: string;
-  commit?: string;
-  date?: string;
-  environment?: string;
-};
-type RuntimeInfo = {
-  arch: string;
-  nodeVersion: string;
-  platform: string;
-  /** Which runtime family reported the fields above. Absent on pre-1.2 builds. */
-  runtime?: "edge" | "node";
-};
-declare const readBuildInfoFromEnv: () => BuildInfo;
-declare const resolveBuildInfo: (override?: BuildInfo) => BuildInfo;
-declare const getRuntimeInfo: () => RuntimeInfo;
-//#endregion
-//#region src/gateway/types.d.ts
-type GatewayConfig = {
-  id: string;
-  name?: string;
-  proxyTools?: boolean;
-  reconnect?: boolean;
-  reconnectIntervalMs?: number;
-  toolPrefix?: string;
-  url: string;
-};
-type GatewayStatus = "connected" | "connecting" | "disconnected" | "error";
-type GatewayInfo = {
-  id: string;
-  name: string;
-  remoteTools: ReadonlyArray<{
-    description?: string;
-    name: string;
-  }>;
-  status: GatewayStatus;
-  url: string;
-};
-type GatewayInstance = {
-  readonly config: GatewayConfig;
-  readonly info: GatewayInfo;
-  readonly name: string;
-  readonly status: GatewayStatus;
-  readonly tools: ReadonlyArray<Tool$1>;
-  callTool: (name: string, args?: Record<string, unknown>) => Promise<unknown>;
-  connect: () => Promise<void>;
-  disconnect: () => Promise<void>;
-};
-type GatewayManagerInstance = {
-  readonly connectedCount: number;
-  readonly totalCount: number;
-  add: (config: GatewayConfig) => GatewayInstance;
-  connectAll: () => Promise<void>;
-  disconnectAll: () => Promise<void>;
-  get: (id: string) => Option<GatewayInstance>;
-  getAll: () => ReadonlyArray<GatewayInstance>;
-  getInfoAll: () => ReadonlyArray<GatewayInfo>;
-};
-//#endregion
-//#region src/telemetry/TelemetryCollector.d.ts
-type TelemetryEventType = "server.start" | "server.stop" | "tool.execute" | "tool.error" | "resource.load" | "resource.error" | "prompt.load" | "prompt.error" | "gateway.connect" | "gateway.disconnect" | "gateway.error" | "session.connect" | "session.disconnect";
-type ErrorCategory = "validation" | "timeout" | "gateway" | "internal" | "auth" | "not_found";
-type CaptureLevel = "full" | "metadata" | "none";
-type ToolCaptureConfig = {
-  captureLevel?: CaptureLevel;
-  maxOutputSize?: number;
-  redactInputFields?: ReadonlyArray<string>;
-};
-type TelemetryEvent = {
-  data?: Record<string, unknown>;
-  durationMs?: number;
-  error?: string;
-  errorCategory?: ErrorCategory;
-  errorStack?: string;
-  input?: Record<string, unknown>;
-  name: string;
-  output?: unknown;
-  requestId?: string;
-  sessionId?: string;
-  timestamp: number;
-  type: TelemetryEventType;
-};
-type TelemetryCollector = {
-  flush?: () => Promise<void>;
-  recordEvent: (event: TelemetryEvent) => void;
-};
-//#endregion
-//#region src/auth/middleware.d.ts
-/**
- * Callback invoked to authenticate an incoming request. Receives either a Hono
- * `Request` (custom routes / protected artifacts) or an `http.IncomingMessage`
- * (MCP transport). Use `getRequestHeader` to hide the shape difference.
- */
-type Authenticate = (request: unknown) => Promise<unknown>;
-/** Response builder invoked when auth is missing or fails. Defaults to `401 { error: "Unauthorized" }`. */
-type OnUnauthorized = (c: Context$1) => Response | Promise<Response>;
-type AuthMiddlewareConfig = {
-  authenticate?: Authenticate;
-  onUnauthorized?: OnUnauthorized;
-};
-declare const createAuthMiddleware: ({ authenticate, onUnauthorized }: AuthMiddlewareConfig) => MiddlewareHandler;
-//#endregion
-//#region src/auth/request.d.ts
-/**
- * Extract a header from either shape somamcp's `authenticate` callback may receive:
- *
- * - **Hono `Request`** (`c.req.raw`) — used on protected artifact and custom routes.
- *   Headers implement the WHATWG `Headers` interface (`.get(name)`).
- * - **`http.IncomingMessage`** — used on the MCP transport path (FastMCP).
- *   Headers are a plain lowercased object; values may be `string | string[]`.
- *
- * Case-insensitive on the header name. Returns `undefined` when the header is
- * absent or the request shape is not recognized — matches the `Headers.get`
- * shape callers already write against.
- */
-declare const getRequestHeader: (request: unknown, name: string) => string | undefined;
-//#endregion
-//#region src/types/routes.d.ts
-type RouteMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-/**
- * Config for a custom HTTP route registered on the server's Hono app via
- * `SomaServerInstance.addRoute`.
- *
- * When `protected: true`, the server's `authenticate` callback runs first — a
- * throw or rejection short-circuits to `onUnauthorized` (default `401`).
- *
- * ### Route ordering
- *
- * Hono dispatches by registration order. `addRoute` registers immediately, so
- * routes added **before** `start()` land alongside artifacts and introspection
- * routes in call order. For concrete non-overlapping paths this doesn't matter;
- * for wildcards or overlapping prefixes, register earlier to take precedence.
- */
-type RouteConfig = {
-  method: RouteMethod | ReadonlyArray<RouteMethod>;
-  path: `/${string}`;
-  protected?: boolean;
-  handler: (c: Context$1) => Response | Promise<Response>;
-  onUnauthorized?: OnUnauthorized;
-};
-//#endregion
-//#region src/types.d.ts
-type SomaServerOptions<T extends SessionAuth = SessionAuth> = ServerConfig<T> & {
-  artifacts?: ArtifactConfig[];
-  /**
-   * Backend implementation. Defaults to `createFastMCPBackend` (Node).
-   * Pass `createEdgeBackend` from `somamcp/edge` to target Cloudflare Workers,
-   * Deno Deploy, or Bun.
-   */
-  backend?: BackendFactory<T>;
-  backendOptions?: Record<string, unknown>;
-  build?: BuildInfo;
-  enableDashboard?: boolean;
-  enableHealthEndpoint?: boolean;
-  enableInfoEndpoint?: boolean;
-  enableIntrospection?: boolean;
-  gateways?: GatewayConfig[];
-  healthDetailPath?: string;
-  healthPath?: string;
-  infoPath?: string;
-  introspectionPrefix?: string;
-  logLayer?: DirectLogger$1;
-  telemetry?: TelemetryCollector;
-};
-type ServerHealth = {
-  activeSessions: number;
-  gateways: {
-    connected: number;
-    total: number;
-  };
-  name: string;
-  startedAt: number;
-  status: ServerStatus;
-  uptime: number;
-};
-type ServerCapabilities = {
-  prompts: ReadonlyArray<{
-    description?: string;
-    name: string;
-  }>;
-  resources: ReadonlyArray<{
-    description?: string;
-    name: string;
-    uri: string;
-  }>;
-  tools: ReadonlyArray<{
-    description?: string;
-    name: string;
-  }>;
-};
-type CapabilitiesSummary = {
-  prompts: number;
-  resources: number;
-  tools: number;
-};
-type ServerInfo = {
-  build: BuildInfo;
-  capabilities: CapabilitiesSummary;
-  name: string;
-  runtime: RuntimeInfo;
-  version: string;
-};
-type ToolOptions<T extends SessionAuth = SessionAuth, P extends SchemaParams = SchemaParams> = Tool<T, P> & {
-  captureConfig?: ToolCaptureConfig;
-};
-type SomaServerInstance<T extends SessionAuth = SessionAuth> = {
-  readonly name: string;
-  readonly serverState: ServerStatus;
-  readonly sessions: ReadonlyArray<BackendSession<T>>;
-  addPrompt: <Args extends PromptArgument<T>[]>(prompt: Prompt<T, Args>) => void;
-  addPrompts: <Args extends PromptArgument<T>[]>(prompts: Prompt<T, Args>[]) => void;
-  addResource: (resource: Resource<T>) => void;
-  addResources: (resources: Resource<T>[]) => void;
-  addResourceTemplate: (...args: ReadonlyArray<unknown>) => void;
-  addRoute: (route: RouteConfig) => void;
-  addTool: <P extends SchemaParams>(tool: Tool<T, P>) => void;
-  addTools: <P extends SchemaParams>(tools: Tool<T, P>[]) => void;
-  /**
-   * Web-standard request handler covering both MCP calls and registered
-   * artifacts/routes. This is the entry point for edge runtimes:
-   * `export default { fetch: (req) => server.fetch(req) }`.
-   */
-  fetch: (request: Request) => Promise<Response>;
-  getApp: () => Hono;
-  getCapabilities: () => ServerCapabilities;
-  getGatewayManager: () => GatewayManagerInstance;
-  getHealth: () => ServerHealth;
-  getInfo: () => ServerInfo;
-  removePrompt: (name: string) => void;
-  removeResource: (name: string) => void;
-  removeTool: (name: string) => void;
-  start: (options?: TransportConfig) => Promise<void>;
-  stop: () => Promise<void>;
-};
-//#endregion
-//#region src/Server.d.ts
-/**
- * Backend-agnostic server core.
- *
- * `backend` is required here on purpose. Defaulting it would mean a static import
- * of the Node FastMCP backend, which lands in every bundle that reaches this
- * module — including `somamcp/edge`. The entry barrels supply the default instead:
- * `somamcp` binds createFastMCPBackend, `somamcp/edge` binds createEdgeBackend.
- */
-declare const createServerCore: <T extends SessionAuth = SessionAuth>(options: SomaServerOptions<T> & {
-  backend: BackendFactory<T>;
-}) => SomaServerInstance<T>;
-//#endregion
-//#region src/content/helpers.d.ts
-type ContentInput = {
-  buffer: Buffer;
-} | {
-  path: string;
-} | {
-  url: string;
-};
-declare const imageContent: (input: ContentInput) => Promise<ImageContent>;
-declare const audioContent: (input: ContentInput) => Promise<AudioContent>;
-//#endregion
-//#region src/telemetry/CompositeTelemetry.d.ts
-declare const createCompositeTelemetry: (collectors: ReadonlyArray<TelemetryCollector>) => TelemetryCollector;
-//#endregion
-//#region src/telemetry/ConsoleTelemetry.d.ts
-declare const createConsoleTelemetry: (prefix?: string) => TelemetryCollector;
-//#endregion
-//#region src/telemetry/EnrichedError.d.ts
-type EnrichedErrorResponse = {
-  errorCategory: ErrorCategory;
-  message: string;
-  relatedState?: Record<string, unknown>;
-  suggestions?: ReadonlyArray<string>;
-};
-declare const classifyError: (error: unknown) => ErrorCategory;
-declare const createEnrichedError: (error: unknown, context?: {
-  gatewayStatus?: string;
-  toolName?: string;
-}) => EnrichedErrorResponse;
-//#endregion
-//#region src/telemetry/JsonFileTelemetry.d.ts
-type JsonFileTelemetryOptions = {
-  filePath: string;
-  flushIntervalMs?: number;
-};
-declare const createJsonFileTelemetry: (options: JsonFileTelemetryOptions) => TelemetryCollector;
-//#endregion
-//#region src/telemetry/LogLayerTelemetry.d.ts
-declare const createLogLayerTelemetry: (logger: DirectLogger$1) => TelemetryCollector;
-//#endregion
-//#region src/telemetry/NoopTelemetry.d.ts
-declare const NoopTelemetry: TelemetryCollector;
-//#endregion
-//#region src/telemetry/telemetryWrapper.d.ts
-/**
- * Wrap a tool's `execute` in telemetry + error enrichment.
- *
- * The success path returns the tool's return value **unchanged**, so any of the
- * supported shapes reach the backend intact: a plain string, a `ContentResult`
- * (`{ content: [...], isError? }`), or a content-array with multimodal parts
- * (`{ type: "image", data, mimeType }`, `audio`, `resource`, etc.). Use the
- * exported `imageContent` / `audioContent` helpers to build parts without
- * reaching into the backend.
- *
- * The failure path converts an error to a `ContentResult` with `isError: true`
- * and the enriched error payload as the text content.
- */
-declare const wrapTool: <T extends SessionAuth, P extends SchemaParams>(tool: Tool<T, P>, telemetry: TelemetryCollector, captureConfig?: ToolCaptureConfig) => Tool<T, P>;
-declare const wrapResource: <T extends SessionAuth>(resource: Resource<T>, telemetry: TelemetryCollector) => Resource<T>;
-declare const wrapPrompt: <T extends SessionAuth, Args extends PromptArgument<T>[] = PromptArgument<T>[]>(prompt: Prompt<T, Args>, telemetry: TelemetryCollector) => Prompt<T, Args>;
-//#endregion
-//#region src/logging.d.ts
-declare const createDefaultLogger: (name: string) => DirectLogger$1;
-//#endregion
-//#region src/artifacts/ArtifactManager.d.ts
-declare const registerArtifacts: (app: Hono, artifacts: ReadonlyArray<ArtifactConfig>, authenticate?: ArtifactAuthenticate) => void;
-//#endregion
-//#region src/artifacts/DashboardArtifact.d.ts
-declare const createDashboardArtifact: (getHealth: () => ServerHealth, getCapabilities: () => ServerCapabilities, getConnections: () => ReadonlyArray<GatewayInfo>) => ArtifactConfig;
-//#endregion
-//#region src/artifacts/HealthArtifact.d.ts
-declare const DEFAULT_HEALTH_PATH = "/health";
-declare const DEFAULT_HEALTH_DETAIL_PATH = "/health/detail";
-declare const createHealthArtifact: (getHealth: () => ServerHealth, path?: string) => ArtifactConfig;
-declare const createHealthDetailArtifact: (getHealth: () => ServerHealth, path?: string) => ArtifactConfig;
-//#endregion
-//#region src/artifacts/InfoArtifact.d.ts
-declare const DEFAULT_INFO_PATH = "/info";
-declare const createInfoArtifact: (getInfo: () => ServerInfo, path?: string) => ArtifactConfig;
-//#endregion
-//#region src/introspection/capabilitiesTool.d.ts
-declare const createCapabilitiesTool: <T extends SessionAuth>(getCapabilities: () => ServerCapabilities) => Tool<T>;
-//#endregion
-//#region src/introspection/connectionsTool.d.ts
-declare const createConnectionsTool: <T extends SessionAuth>(getConnections: () => ReadonlyArray<GatewayInfo>) => Tool<T>;
-//#endregion
-//#region src/introspection/healthTool.d.ts
-declare const createHealthTool: <T extends SessionAuth>(getHealth: () => ServerHealth) => Tool<T>;
-//#endregion
-//#region src/introspection/infoTool.d.ts
-declare const createInfoTool: <T extends SessionAuth>(getInfo: () => ServerInfo, name?: string) => Tool<T>;
-//#endregion
-//#region src/feedback/redaction.d.ts
-type RedactionPattern = {
-  description: string;
-  name: string;
-  pattern: RegExp;
-  replacement?: string;
-};
-type RedactionResult = {
-  matches: ReadonlyArray<{
-    name: string;
-    count: number;
-  }>;
-  redacted: boolean;
-  text: string;
-};
-declare const DEFAULT_REDACTION_PATTERNS: ReadonlyArray<RedactionPattern>;
-declare const redact: (input: string, patterns?: ReadonlyArray<RedactionPattern>) => RedactionResult;
-//#endregion
-//#region src/feedback/types.d.ts
-type FeedbackType = "bug" | "feature" | "feedback" | "question";
-type FeedbackSeverity = "high" | "low" | "medium";
-type NormalizedFeedback = {
-  body: string;
-  labels: ReadonlyArray<string>;
-  title: string;
-};
-type FeedbackSubmitSuccess = {
-  id?: string;
-  success: true;
-  url?: string;
-};
-type FeedbackSubmitFailure = {
-  error: string;
-  success: false;
-};
-type FeedbackSubmitResult = FeedbackSubmitFailure | FeedbackSubmitSuccess;
-type FeedbackProvider = {
-  readonly name: string;
-  submit: (payload: NormalizedFeedback) => Promise<FeedbackSubmitResult>;
-};
-//#endregion
-//#region src/feedback/feedbackTool.d.ts
-type FeedbackEnrichmentContext = {
-  type: FeedbackType;
-  severity?: FeedbackSeverity;
-};
-type FeedbackToolOptions = {
-  description?: string;
-  enrichment?: (ctx: FeedbackEnrichmentContext) => Promise<Record<string, unknown>> | Record<string, unknown>;
-  extraLabels?: ReadonlyArray<string>;
-  name?: string;
-  provider: FeedbackProvider;
-  redactionPatterns?: ReadonlyArray<RedactionPattern>;
-};
-declare const PARAMETERS: z.ZodObject<{
-  description: z.ZodString;
-  severity: z.ZodOptional<z.ZodEnum<{
-    low: "low";
-    medium: "medium";
-    high: "high";
-  }>>;
-  title: z.ZodString;
-  type: z.ZodDefault<z.ZodEnum<{
-    bug: "bug";
-    feature: "feature";
-    feedback: "feedback";
-    question: "question";
-  }>>;
-}, z.core.$strip>;
-declare const createFeedbackTool: <T extends SessionAuth>(options: FeedbackToolOptions) => Tool<T, typeof PARAMETERS>;
-//#endregion
-//#region src/feedback/providers/github.d.ts
-type GithubFeedbackOptions = {
-  baseUrl?: string;
-  defaultLabels?: ReadonlyArray<string>;
-  fetchImpl?: typeof fetch;
-  getToken: () => Option<string>;
-  repo: `${string}/${string}`;
-};
-declare const createGithubFeedback: (options: GithubFeedbackOptions) => FeedbackProvider;
-//#endregion
-//#region src/feedback/providers/webhook.d.ts
-type WebhookFeedbackOptions = {
-  fetchImpl?: typeof fetch;
-  headers?: Record<string, string>;
-  transform?: (payload: NormalizedFeedback) => unknown;
-  url: string;
-};
-declare const createWebhookFeedback: (options: WebhookFeedbackOptions) => FeedbackProvider;
-//#endregion
-//#region src/gateway/Gateway.d.ts
-declare const createGateway: (config: GatewayConfig, telemetry: TelemetryCollector) => GatewayInstance;
-//#endregion
-//#region src/gateway/GatewayManager.d.ts
-declare const createGatewayManager: (telemetry: TelemetryCollector) => GatewayManagerInstance;
-//#endregion
-//#region src/gateway/toolProxy.d.ts
-declare const createProxiedTools: <T extends SessionAuth>(gateway: GatewayInstance, telemetry?: TelemetryCollector) => ReadonlyArray<Tool<T>>;
-//#endregion
-//#region src/index.d.ts
-/** Create a server backed by FastMCP (Node). For edge runtimes, use `somamcp/edge`. */
-declare const createServer: <T extends SessionAuth = SessionAuth>(options: SomaServerOptions<T>) => SomaServerInstance<T>;
-//#endregion
-export { type ArtifactAuthenticate, type ArtifactConfig, type AudioContent, type AuthMiddlewareConfig, type Authenticate, type BackendAdapter, type BackendFactory, type BackendSession, type BuildInfo, type CapabilitiesSummary, type CaptureLevel, type Completion, type Content, type ContentResult, type Context, DEFAULT_HEALTH_DETAIL_PATH, DEFAULT_HEALTH_PATH, DEFAULT_INFO_PATH, DEFAULT_REDACTION_PATTERNS, type DirectLogger, type DirectoryArtifact, type DynamicArtifact, type EnrichedErrorResponse, type ErrorCategory, type FeedbackEnrichmentContext, type FeedbackProvider, type FeedbackSeverity, type FeedbackSubmitFailure, type FeedbackSubmitResult, type FeedbackSubmitSuccess, type FeedbackToolOptions, type FeedbackType, type GatewayConfig, type GatewayInfo, type GatewayInstance, type GatewayManagerInstance, type GatewayStatus, type GithubFeedbackOptions, type HttpStreamConfig, type ImageContent, type InferSchemaOutput, type JsonFileTelemetryOptions, type Logger, NoopTelemetry, type NormalizedFeedback, type OnUnauthorized, type Progress, type Prompt, type PromptArgument, type PromptResult, type RedactionPattern, type RedactionResult, type Resource, type ResourceContent, type ResourceLink, type ResourceResult, type ResourceTemplate, type ResourceTemplateArgument, type RouteConfig, type RouteMethod, type RuntimeInfo, type SchemaParams, type ServerCapabilities, type ServerConfig, type ServerHealth, type ServerInfo, type ServerStatus, type SessionAuth, type SomaServerInstance, type SomaServerOptions, type StaticArtifact, type TelemetryCollector, type TelemetryEvent, type TelemetryEventType, type TextContent, type Tool, type ToolAnnotations, type ToolCaptureConfig, type ToolOptions, type TransportConfig, UserError, type WebhookFeedbackOptions, audioContent, classifyError, createAuthMiddleware, createCapabilitiesTool, createCompositeTelemetry, createConnectionsTool, createConsoleTelemetry, createDashboardArtifact, createDefaultLogger, createEnrichedError, createFastMCPBackend, createFeedbackTool, createGateway, createGatewayManager, createGithubFeedback, createHealthArtifact, createHealthDetailArtifact, createHealthTool, createInfoArtifact, createInfoTool, createJsonFileTelemetry, createLogLayerTelemetry, createProxiedTools, createServer, createServerCore, createWebhookFeedback, getRequestHeader, getRuntimeInfo, imageContent, readBuildInfoFromEnv, redact, registerArtifacts, resolveBuildInfo, wrapPrompt, wrapResource, wrapTool };
+import { A as SessionAuth, C as ResourceContent, D as ResourceTemplateArgument, E as ResourceTemplate, M as Tool, N as ToolAnnotations, O as SchemaParams, P as UserError, S as Resource, T as ResourceResult, _ as InferSchemaOutput, a as BackendFactory, b as PromptArgument, c as Logger, d as AudioContent, f as Completion, g as ImageContent, h as Context, j as TextContent, k as ServerStatus, l as ServerConfig, m as ContentResult, n as createSdkBackend, o as BackendSession, p as Content, r as BackendAdapter, s as HttpStreamConfig, t as SdkBackendOptions, u as TransportConfig, v as Progress, w as ResourceLink, x as PromptResult, y as Prompt } from "./index-ololl9dI.js";
+import { $ as ServerHealth, A as DEFAULT_HEALTH_DETAIL_PATH, At as DynamicArtifact, B as NoopTelemetry, C as redact, Ct as RuntimeInfo, D as createCapabilitiesTool, Dt as ArtifactAuthenticate, E as createConnectionsTool, Et as resolveBuildInfo, F as registerArtifacts, G as createConsoleTelemetry, H as EnrichedErrorResponse, I as createDefaultLogger, J as audioContent, K as createCompositeTelemetry, L as wrapPrompt, M as createHealthArtifact, N as createHealthDetailArtifact, O as DEFAULT_INFO_PATH, Ot as ArtifactConfig, P as createDashboardArtifact, Q as ServerCapabilities, R as wrapResource, S as RedactionResult, St as BuildInfo, T as createHealthTool, Tt as readBuildInfoFromEnv, U as classifyError, V as createLogLayerTelemetry, W as createEnrichedError, X as createServerCore, Y as imageContent, Z as CapabilitiesSummary, _ as FeedbackSubmitSuccess, _t as GatewayConfig, a as createGateway, at as RouteMethod, b as DEFAULT_REDACTION_PATTERNS, bt as GatewayManagerInstance, c as GithubFeedbackOptions, ct as Authenticate, d as FeedbackToolOptions, dt as CaptureLevel, et as ServerInfo, f as createFeedbackTool, ft as ErrorCategory, g as FeedbackSubmitResult, gt as ToolCaptureConfig, h as FeedbackSubmitFailure, ht as TelemetryEventType, i as createGatewayManager, it as RouteConfig, j as DEFAULT_HEALTH_PATH, jt as StaticArtifact, k as createInfoArtifact, kt as DirectoryArtifact, l as createGithubFeedback, lt as OnUnauthorized, m as FeedbackSeverity, mt as TelemetryEvent, n as createServer, nt as SomaServerOptions, o as WebhookFeedbackOptions, ot as getRequestHeader, p as FeedbackProvider, pt as TelemetryCollector, q as ContentInput, r as createProxiedTools, rt as ToolOptions, s as createWebhookFeedback, st as AuthMiddlewareConfig, t as DirectLogger, tt as SomaServerInstance, u as FeedbackEnrichmentContext, ut as createAuthMiddleware, v as FeedbackType, vt as GatewayInfo, w as createInfoTool, wt as getRuntimeInfo, x as RedactionPattern, xt as GatewayStatus, y as NormalizedFeedback, yt as GatewayInstance, z as wrapTool } from "./index-aVpYZPUq.js";
+export { type ArtifactAuthenticate, type ArtifactConfig, type AudioContent, type AuthMiddlewareConfig, type Authenticate, type BackendAdapter, type BackendFactory, type BackendSession, type BuildInfo, type CapabilitiesSummary, type CaptureLevel, type Completion, type Content, type ContentInput, type ContentResult, type Context, DEFAULT_HEALTH_DETAIL_PATH, DEFAULT_HEALTH_PATH, DEFAULT_INFO_PATH, DEFAULT_REDACTION_PATTERNS, type DirectLogger, type DirectoryArtifact, type DynamicArtifact, type EnrichedErrorResponse, type ErrorCategory, type FeedbackEnrichmentContext, type FeedbackProvider, type FeedbackSeverity, type FeedbackSubmitFailure, type FeedbackSubmitResult, type FeedbackSubmitSuccess, type FeedbackToolOptions, type FeedbackType, type GatewayConfig, type GatewayInfo, type GatewayInstance, type GatewayManagerInstance, type GatewayStatus, type GithubFeedbackOptions, type HttpStreamConfig, type ImageContent, type InferSchemaOutput, type Logger, NoopTelemetry, type NormalizedFeedback, type OnUnauthorized, type Progress, type Prompt, type PromptArgument, type PromptResult, type RedactionPattern, type RedactionResult, type Resource, type ResourceContent, type ResourceLink, type ResourceResult, type ResourceTemplate, type ResourceTemplateArgument, type RouteConfig, type RouteMethod, type RuntimeInfo, type SchemaParams, type SdkBackendOptions, type ServerCapabilities, type ServerConfig, type ServerHealth, type ServerInfo, type ServerStatus, type SessionAuth, type SomaServerInstance, type SomaServerOptions, type StaticArtifact, type TelemetryCollector, type TelemetryEvent, type TelemetryEventType, type TextContent, type Tool, type ToolAnnotations, type ToolCaptureConfig, type ToolOptions, type TransportConfig, UserError, type WebhookFeedbackOptions, audioContent, classifyError, createAuthMiddleware, createCapabilitiesTool, createCompositeTelemetry, createConnectionsTool, createConsoleTelemetry, createDashboardArtifact, createDefaultLogger, createEnrichedError, createFeedbackTool, createGateway, createGatewayManager, createGithubFeedback, createHealthArtifact, createHealthDetailArtifact, createHealthTool, createInfoArtifact, createInfoTool, createLogLayerTelemetry, createProxiedTools, createSdkBackend, createServer, createServerCore, createWebhookFeedback, getRequestHeader, getRuntimeInfo, imageContent, readBuildInfoFromEnv, redact, registerArtifacts, resolveBuildInfo, wrapPrompt, wrapResource, wrapTool };