@nudge-ui/mcp 0.2.3 → 0.2.5

package/README.md

@@ -64,6 +64,7 @@ uses pnpm, Yarn, or Bun. The package requires Node.js 20 or later.
 | --- | --- |
 | `nudge_list_sessions` | Discover running apps in the requested workspace. |
 | `nudge_listen` | Wait for the next implementation request. `nudge_connect` is an alias. |
+| `nudge_get_request` | Recover an unacknowledged request and its sketch images by request ID. |
 | `nudge_get_status` | Read connection and request status. |
 | `nudge_report_activity` | Highlight Canvas frames associated with a file read or edit. |
 | `nudge_report_status` | Report working, completed, failed, or interrupted status. |
@@ -108,6 +109,23 @@ initializer's `--agent-only` mode to update the agent integration.
 
 The MCP adapter delivers requests through an active tool call. It cannot start
 a new agent turn after the host has ended the conversation or stopped waiting.
+If the host wraps tools in `functions.exec` and returns a running cell ID,
+keep the agent turn active and collect the result with `functions.wait`. A wrapper
+yield does not complete the listening call.
+
+A browser dispatch enters `delivered` while awaiting agent acknowledgment. The
+agent must call `nudge_report_status` with `working` before starting work. If a
+listening result was not collected, call `nudge_listen` again to recover the same
+prompt and sketch images. `nudge_get_request` also supports explicit recovery by ID. Recovery
+does not acknowledge or redispatch the request. Attachment bytes are retained in
+memory until acknowledgment or interruption; no requests survive a bridge restart.
+
+Unacknowledged deliveries expire after 60 seconds and become `interrupted`.
+Recovery does not extend this deadline. The terminal outcome remains visible until
+the agent listens again; the browser can then resend the prompt. Late
+acknowledgments cannot revive an interrupted request. Both the project bridge and
+adapter must use protocol version 3; upgrade both and restart them together.
+
 If a listening call times out, ask the agent to listen again and adjust the
 host's MCP timeout if supported.
 

package/dist/bridge.d.ts

@@ -1,17 +1,10 @@
-import { type Server } from "node:http";
-import type { AgentActivity, AgentDeliveredPrompt, AgentRequestOutcome, AgentStatusSnapshot, AgentStatusUpdate, CanvasCommandResult, PairingResponse } from "./internal/agent-protocol.js";
-/** A clock port keeps command timeout tests deterministic. */
-export interface BridgeClock {
-    now(): number;
-    setTimeout(callback: () => void, delayMs: number): unknown;
-    clearTimeout(handle: unknown): void;
-}
+import { type BridgeClock, type BridgeSessionControls } from "./bridgeSession.js";
 export interface BrowserBridgeOptions {
     /** Stable project identity used to scope every browser message. */
     readonly projectId: string;
-    /** Canonical app origin that browser routes must use. */
-    readonly origin?: string;
-    /** Explicit browser origins accepted by the loopback HTTP server. */
+    /** Canonical app origin that pairing and Canvas routes must use. */
+    readonly origin: string;
+    /** Other explicit browser origins accepted by the loopback HTTP server. */
     readonly allowedOrigins?: readonly string[];
     readonly host?: "127.0.0.1" | "::1" | "localhost";
     /** Use port 0 in tests or when several projects run concurrently. */
@@ -24,58 +17,19 @@ export interface BrowserBridgeOptions {
     readonly idFactory?: () => string;
     /** Private credential for a separately running MCP adapter. */
     readonly agentControlToken?: string;
-    /**
-     * Best-effort hook used by the CLI to reopen the last paired page when an
-     * agent rearms listening but no browser controller stream is attached.
-     */
-    readonly onControllerUnavailable?: (pageUrl: string) => Promise<void> | void;
 }
 export interface BridgeAddress {
     readonly host: string;
     readonly port: number;
     readonly url: string;
 }
-export type BridgeLifecycle = "created" | "listening" | "closed";
-export interface BrowserBridge {
-    readonly httpServer: Server;
+/** A loopback HTTP server exposing one project session to its browser and MCP adapter. */
+export interface BrowserBridge extends BridgeSessionControls {
     readonly projectId: string;
-    readonly origin: string | null;
-    /** The configured origin, or the explicitly approved browser origin. */
-    readonly effectiveOrigin: string | null;
-    readonly lifecycle: BridgeLifecycle;
     readonly address: BridgeAddress | null;
-    readonly sessionToken: string | null;
-    readonly lastPageUrl: string | null;
-    /** Current companion/browser state, safe to expose to the browser. */
-    getStatus(): AgentStatusSnapshot;
     start(): Promise<BridgeAddress>;
     close(): Promise<void>;
-    /** Blocks until a paired browser dispatches a prompt. */
-    waitForPrompt(signal?: AbortSignal, sessionId?: string, agentClientName?: string): Promise<AgentDeliveredPrompt>;
-    /** Marks the agent-side listener as stopped without ending the project. */
-    cancelListener(reason?: string): void;
-    /** Emits temporary source attribution for the currently working request. */
-    reportActivity(activity: AgentActivity): void;
-    /** Reports the terminal result for the currently running browser request. */
-    updateRequestStatus(update: AgentStatusUpdate | AgentRequestOutcome): void;
-    /** Sends a Canvas command to the browser and waits for one bounded ack. */
-    dispatchCanvasCommand(command: CanvasCommandInput): Promise<CanvasCommandResult>;
-    /** Returns the currently paired browser token to the host process only. */
-    pairBrowser(projectId: string, requestOrigin: string, pageUrl?: string): PairingResponse;
-    /** Revokes a browser pairing; no data is written to disk. */
-    disconnectBrowser(token: string): void;
 }
-export type CanvasCommandInput = Omit<import("./internal/agent-protocol.js").ReadCanvasStateCommand, "commandId"> & {
-    readonly commandId?: string;
-} | Omit<import("./internal/agent-protocol.js").PresentRoutesCommand, "commandId"> & {
-    readonly commandId?: string;
-} | Omit<import("./internal/agent-protocol.js").FocusCanvasGroupCommand, "commandId"> & {
-    readonly commandId?: string;
-} | Omit<import("./internal/agent-protocol.js").FitCanvasCommand, "commandId"> & {
-    readonly commandId?: string;
-} | Omit<import("./internal/agent-protocol.js").RemoveCanvasGroupCommand, "commandId"> & {
-    readonly commandId?: string;
-};
 /**
  * Creates the local browser bridge. It binds only to loopback and keeps every
  * pairing, prompt, command, and acknowledgement in process memory.