@ractive-ch/tab-mcp 0.1.0-alpha.1 → 0.2.0

package/notopen.d.ts

@@ -0,0 +1,24 @@
+import { type RpcId } from "./exchange.js";
+/**
+ * The relay's answers when the page is not open (DEC-074): HTTP 200 with a
+ * JSON-RPC message the AI app's model can act on, instead of an HTTP error
+ * status that makes MCP clients re-probe the server's protocol era.
+ */
+/** Why the page is not there: never came, or went away mid-request. */
+export type NotOpenPhase = "not_open" | "gone";
+/** What the relay says about itself in a stand-in `server/discover` result. */
+export interface RelayInfo {
+    name: string;
+    version: string;
+}
+export declare function isRetryable(method: unknown): boolean;
+/** The text for "the page is not open" (tool results and JSON-RPC errors). */
+export declare function notOpenText(appName: string | undefined): string;
+/** The text for a tool call whose page went away while it ran. */
+export declare function goneDuringCallText(appName: string | undefined): string;
+/**
+ * The JSON-RPC message the relay answers with (at HTTP 200) when the page is
+ * not open, or `undefined` for a notification (that keeps an HTTP error
+ * status: the spec requires one for a notification the server cannot accept).
+ */
+export declare function notOpenAnswer(body: Record<string, unknown>, rpcId: RpcId | undefined, appName: string | undefined, phase: NotOpenPhase, relay: RelayInfo): string | undefined;

package/package.json

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

package/session.d.ts

@@ -1,5 +1,5 @@
 import type { RelayConfig, Site, SiteLimits } from "./config.js";
-import { Exchange, type RpcId } from "./exchange.js";
+import { Exchange, type PageGoneReply, type RpcId } from "./exchange.js";
 import type { Logger } from "./log.js";
 import { PairingCodes } from "./oauth/pairing.js";
 import { type ByeReason, type GrantRef, type Limits, type RelayMessage } from "./protocol.js";
@@ -21,6 +21,8 @@ export interface SessionHost {
     claimAddress(session: TabSession): TabSession | undefined;
     /** Called once when a session is over. */
     released(session: TabSession): void;
+    /** Called once when a session is ready for MCP requests (DEC-074). */
+    ready?(session: TabSession): void;
     /** The tab pressed Disconnect for one app; false if the grant is not this address's. */
     revokeGrant(session: TabSession, grantId: string): Promise<boolean>;
     /** The tab revokes every grant of its address ("New address"). */
@@ -38,6 +40,8 @@ export interface ForwardInput {
     extraHeaders: Record<string, string>;
     /** Called once with the finished exchange (for the request log line). */
     onDone: (exchange: Exchange) => void;
+    /** The answer when the page goes away mid-request (DEC-074). */
+    pageGone?: (waiting: boolean) => PageGoneReply;
 }
 /** The limits announced to the tab (protocol: `session.limits`). */
 export declare function limitsOf(limits: SiteLimits | RelayConfig): Limits;