@ractive-ch/tab-mcp 0.6.0 → 0.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ractive-ch/tab-mcp",
-	"version": "0.6.0",
+	"version": "0.6.1",
 	"description": "Relay that lets AI agents call the MCP tools of a web page open in a browser tab",
 	"type": "module",
 	"bin": {

package/relay.d.ts

@@ -13,6 +13,12 @@ export interface CreateRelayOptions extends Omit<Partial<RelayConfig>, "store">
     /** Logger; defaults to JSON lines on stdout at `logLevel`. */
     logger?: Logger;
 }
+/**
+ * The public URL in development without `publicUrl`: the loopback address the
+ * relay listens on, so the addresses match the URL the page was given;
+ * `localhost` for any other host (`0.0.0.0`, `::`, a name).
+ */
+export declare function developmentUrl(host: string, port: number): string;
 export interface Relay {
     /** The external origin (issuer and address base). */
     readonly url: string;

package/testing.d.ts

@@ -1,5 +1,36 @@
 /**
- * `@ractive-ch/tab-mcp/testing`: the `TokenStore` conformance suite for
- * `bun test` (DEC-041).
+ * `@ractive-ch/tab-mcp/testing`: helpers for `bun test`. The `TokenStore`
+ * conformance suite (DEC-041), and an in-process relay with a token helper
+ * for end-to-end tests of a page's tools without pairing by hand.
  */
+import { type CreateRelayOptions, type Relay } from "./relay.js";
+import type { TokenStore } from "./store/types.js";
 export { tokenStoreConformance } from "./store/conformance.js";
+/** A relay started by `startTestRelay`. */
+export interface TestRelay {
+    relay: Relay;
+    /** The relay's token store, for `tokenFor`. */
+    store: TokenStore;
+    /** The relay's URL, for the page's `relay` option: `http://127.0.0.1:<port>`. */
+    url: string;
+    stop(): Promise<void>;
+}
+/**
+ * Start a relay in this process on a free port of 127.0.0.1, in development
+ * mode, open to every page origin, with a memory store and no log output
+ * (unless `logger` or `logLevel` is given). `options` override any of that.
+ * For tests only: it accepts any origin.
+ */
+export declare function startTestRelay(options?: Omit<CreateRelayOptions, "store"> & {
+    store?: TokenStore;
+}): TestRelay;
+/**
+ * An access token for a page's MCP address, written straight into the relay's
+ * token store, as if an AI app had paired. Use it as `Authorization: Bearer
+ * <token>` with an MCP client. It lasts an hour unless `ttlMs` says otherwise.
+ */
+export declare function tokenFor(store: TokenStore, address: string, options?: {
+    clientId?: string;
+    clientName?: string;
+    ttlMs?: number;
+}): Promise<string>;