Skip to content

Latest commit

 

History

History
45 lines (32 loc) · 2.71 KB

how-it-works.md

File metadata and controls

45 lines (32 loc) · 2.71 KB

Everything Server - How It Works

Architecture | Project Structure | Startup Process | Server Features | Extension Points | How It Works

Conditional Tool Registration

Module: server/index.ts

  • Some tools require client support for the capability they demonstrate. These are:
    • get-roots-list
    • trigger-elicitation-request
    • trigger-sampling-request
  • Client capabilities aren't known until after initilization handshake is complete.
  • Most tools are registered immediately during the Server Factory execution, prior to client connection.
  • To defer registration of these commands until client capabilities are known, a registerConditionalTools(server) function is invoked from an onintitialized handler.

Resource Subscriptions

Module: resources/subscriptions.ts

  • Tracks subscribers per URI: Map<uri, Set<sessionId>>.
  • Installs handlers via setSubscriptionHandlers(server) to process subscribe/unsubscribe requests and keep the map updated.
  • Updates are started/stopped on demand by the toggle-subscriber-updates tool, which calls beginSimulatedResourceUpdates(server, sessionId) and stopSimulatedResourceUpdates(sessionId).
  • cleanup(sessionId?) calls stopSimulatedResourceUpdates(sessionId) to clear intervals and remove session‑scoped state.

Session‑scoped Resources

Module: resources/session.ts

  • getSessionResourceURI(name: string): Builds a session resource URI: demo://resource/session/<name>.
  • registerSessionResource(server, resource, type, payload): Registers a resource with the given uri, name, and mimeType, returning a resource_link. The content is served from memory for the life of the session only. Supports type: "text" | "blob" and returns data in the corresponding field.
  • Intended usage: tools can create and expose per-session artifacts without persisting them. For example, tools/gzip-file-as-resource.ts compresses fetched content, registers it as a session resource with mimeType: application/gzip, and returns either a resource_link or an inline resource based on outputType.

Simulated Logging

Module: server/logging.ts

  • Periodically sends randomized log messages at different levels. Messages can include the session ID for clarity during demos.
  • Started/stopped on demand via the toggle-simulated-logging tool, which calls beginSimulatedLogging(server, sessionId?) and stopSimulatedLogging(sessionId?). Note that transport disconnect triggers cleanup() which also stops any active intervals.
  • Uses server.sendLoggingMessage({ level, data }, sessionId?) so that the client’s configured minimum logging level is respected by the SDK.