@react-grab/relay 0.1.14 → 0.1.16

package/dist/client.cjs

@@ -376,7 +376,71 @@ var getDefaultRelayClient = () => {
   }
   return defaultRelayClient;
 };
+var isReactGrabApi = (value) => typeof value === "object" && value !== null && "registerPlugin" in value;
+var createProviderClientPlugin = (config) => {
+  const createAgentProvider = (providerOptions = {}) => {
+    const relayClient = providerOptions.relayClient ?? getDefaultRelayClient();
+    if (!relayClient) {
+      throw new Error("RelayClient is required in browser environments");
+    }
+    return createRelayAgentProvider({
+      relayClient,
+      agentId: config.agentId
+    });
+  };
+  const attachAgent = async () => {
+    if (typeof window === "undefined") return;
+    const relayClient = getDefaultRelayClient();
+    if (!relayClient) return;
+    try {
+      await relayClient.connect();
+    } catch {
+      return;
+    }
+    const provider = createRelayAgentProvider({
+      relayClient,
+      agentId: config.agentId
+    });
+    const attach = (api) => {
+      const agent = { provider, storage: sessionStorage };
+      api.registerPlugin({
+        name: config.pluginName,
+        actions: [
+          {
+            id: config.actionId,
+            label: config.actionLabel,
+            shortcut: "Enter",
+            onAction: (actionContext) => {
+              actionContext.enterPromptMode?.(agent);
+            },
+            agent
+          }
+        ]
+      });
+    };
+    const existingApi = window.__REACT_GRAB__;
+    if (isReactGrabApi(existingApi)) {
+      attach(existingApi);
+      return;
+    }
+    window.addEventListener(
+      "react-grab:init",
+      (event) => {
+        if (!(event instanceof CustomEvent)) return;
+        if (!isReactGrabApi(event.detail)) return;
+        attach(event.detail);
+      },
+      { once: true }
+    );
+    const apiAfterListener = window.__REACT_GRAB__;
+    if (isReactGrabApi(apiAfterListener)) {
+      attach(apiAfterListener);
+    }
+  };
+  return { createAgentProvider, attachAgent };
+};
 
+exports.createProviderClientPlugin = createProviderClientPlugin;
 exports.createRelayAgentProvider = createRelayAgentProvider;
 exports.createRelayClient = createRelayClient;
 exports.getDefaultRelayClient = getDefaultRelayClient;

package/dist/client.d.cts

@@ -34,11 +34,27 @@ interface CreateRelayAgentProviderOptions {
     agentId: string;
 }
 declare const createRelayAgentProvider: (options: CreateRelayAgentProviderOptions) => AgentProvider;
+interface ReactGrabApi {
+    registerPlugin: (plugin: unknown) => void;
+}
 declare global {
     interface Window {
         __REACT_GRAB_RELAY__?: RelayClient;
+        __REACT_GRAB__?: ReactGrabApi;
     }
 }
 declare const getDefaultRelayClient: () => RelayClient | null;
+interface ProviderPluginConfig {
+    agentId: string;
+    pluginName: string;
+    actionId: string;
+    actionLabel: string;
+}
+declare const createProviderClientPlugin: (config: ProviderPluginConfig) => {
+    createAgentProvider: (providerOptions?: {
+        relayClient?: RelayClient;
+    }) => AgentProvider;
+    attachAgent: () => Promise<void>;
+};
 
-export { type AgentProvider, type RelayClient, createRelayAgentProvider, createRelayClient, getDefaultRelayClient };
+export { type AgentProvider, type RelayClient, createProviderClientPlugin, createRelayAgentProvider, createRelayClient, getDefaultRelayClient };

package/dist/client.d.ts

@@ -34,11 +34,27 @@ interface CreateRelayAgentProviderOptions {
     agentId: string;
 }
 declare const createRelayAgentProvider: (options: CreateRelayAgentProviderOptions) => AgentProvider;
+interface ReactGrabApi {
+    registerPlugin: (plugin: unknown) => void;
+}
 declare global {
     interface Window {
         __REACT_GRAB_RELAY__?: RelayClient;
+        __REACT_GRAB__?: ReactGrabApi;
     }
 }
 declare const getDefaultRelayClient: () => RelayClient | null;
+interface ProviderPluginConfig {
+    agentId: string;
+    pluginName: string;
+    actionId: string;
+    actionLabel: string;
+}
+declare const createProviderClientPlugin: (config: ProviderPluginConfig) => {
+    createAgentProvider: (providerOptions?: {
+        relayClient?: RelayClient;
+    }) => AgentProvider;
+    attachAgent: () => Promise<void>;
+};
 
-export { type AgentProvider, type RelayClient, createRelayAgentProvider, createRelayClient, getDefaultRelayClient };
+export { type AgentProvider, type RelayClient, createProviderClientPlugin, createRelayAgentProvider, createRelayClient, getDefaultRelayClient };

package/dist/client.js

@@ -374,5 +374,68 @@ var getDefaultRelayClient = () => {
   }
   return defaultRelayClient;
 };
+var isReactGrabApi = (value) => typeof value === "object" && value !== null && "registerPlugin" in value;
+var createProviderClientPlugin = (config) => {
+  const createAgentProvider = (providerOptions = {}) => {
+    const relayClient = providerOptions.relayClient ?? getDefaultRelayClient();
+    if (!relayClient) {
+      throw new Error("RelayClient is required in browser environments");
+    }
+    return createRelayAgentProvider({
+      relayClient,
+      agentId: config.agentId
+    });
+  };
+  const attachAgent = async () => {
+    if (typeof window === "undefined") return;
+    const relayClient = getDefaultRelayClient();
+    if (!relayClient) return;
+    try {
+      await relayClient.connect();
+    } catch {
+      return;
+    }
+    const provider = createRelayAgentProvider({
+      relayClient,
+      agentId: config.agentId
+    });
+    const attach = (api) => {
+      const agent = { provider, storage: sessionStorage };
+      api.registerPlugin({
+        name: config.pluginName,
+        actions: [
+          {
+            id: config.actionId,
+            label: config.actionLabel,
+            shortcut: "Enter",
+            onAction: (actionContext) => {
+              actionContext.enterPromptMode?.(agent);
+            },
+            agent
+          }
+        ]
+      });
+    };
+    const existingApi = window.__REACT_GRAB__;
+    if (isReactGrabApi(existingApi)) {
+      attach(existingApi);
+      return;
+    }
+    window.addEventListener(
+      "react-grab:init",
+      (event) => {
+        if (!(event instanceof CustomEvent)) return;
+        if (!isReactGrabApi(event.detail)) return;
+        attach(event.detail);
+      },
+      { once: true }
+    );
+    const apiAfterListener = window.__REACT_GRAB__;
+    if (isReactGrabApi(apiAfterListener)) {
+      attach(apiAfterListener);
+    }
+  };
+  return { createAgentProvider, attachAgent };
+};
 
-export { createRelayAgentProvider, createRelayClient, getDefaultRelayClient };
+export { createProviderClientPlugin, createRelayAgentProvider, createRelayClient, getDefaultRelayClient };

package/dist/connection.cjs

@@ -8014,7 +8014,7 @@ ${context.content.join("\n\n")}`;
 var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
 // src/connection.ts
-var VERSION = "0.1.14";
+var VERSION = "0.1.16";
 var checkIfRelayServerIsRunning = async (port, token) => {
   try {
     const healthUrl = token ? `http://localhost:${port}/health?${RELAY_TOKEN_PARAM}=${encodeURIComponent(token)}` : `http://localhost:${port}/health`;
@@ -8246,5 +8246,13 @@ var printStartupMessage = (agentId, port) => {
   );
   console.log(`- Local:    ${import_picocolors.default.cyan(`ws://localhost:${port}`)}`);
 };
+var startProviderServer = (source, handler) => {
+  fetch(
+    `https://www.react-grab.com/api/version?source=${source}&t=${Date.now()}`
+  ).catch(() => {
+  });
+  connectRelay({ handler });
+};
 
 exports.connectRelay = connectRelay;
+exports.startProviderServer = startProviderServer;

package/dist/connection.d.cts

@@ -9,5 +9,6 @@ interface RelayConnection {
     disconnect: () => Promise<void>;
 }
 declare const connectRelay: (options: ConnectRelayOptions) => Promise<RelayConnection>;
+declare const startProviderServer: (source: string, handler: AgentHandler) => void;
 
-export { connectRelay };
+export { connectRelay, startProviderServer };

package/dist/connection.d.ts

@@ -9,5 +9,6 @@ interface RelayConnection {
     disconnect: () => Promise<void>;
 }
 declare const connectRelay: (options: ConnectRelayOptions) => Promise<RelayConnection>;
+declare const startProviderServer: (source: string, handler: AgentHandler) => void;
 
-export { connectRelay };
+export { connectRelay, startProviderServer };

package/dist/connection.js

@@ -8004,7 +8004,7 @@ ${context.content.join("\n\n")}`;
 var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
 // src/connection.ts
-var VERSION = "0.1.14";
+var VERSION = "0.1.16";
 var checkIfRelayServerIsRunning = async (port, token) => {
   try {
     const healthUrl = token ? `http://localhost:${port}/health?${RELAY_TOKEN_PARAM}=${encodeURIComponent(token)}` : `http://localhost:${port}/health`;
@@ -8236,5 +8236,12 @@ var printStartupMessage = (agentId, port) => {
   );
   console.log(`- Local:    ${import_picocolors.default.cyan(`ws://localhost:${port}`)}`);
 };
+var startProviderServer = (source, handler) => {
+  fetch(
+    `https://www.react-grab.com/api/version?source=${source}&t=${Date.now()}`
+  ).catch(() => {
+  });
+  connectRelay({ handler });
+};
 
-export { connectRelay };
+export { connectRelay, startProviderServer };

package/dist/index.cjs

@@ -8016,7 +8016,7 @@ async function fkill(inputs, options = {}) {
 var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
 // src/connection.ts
-var VERSION = "0.1.14";
+var VERSION = "0.1.16";
 var checkIfRelayServerIsRunning = async (port, token) => {
   try {
     const healthUrl = token ? `http://localhost:${port}/health?${RELAY_TOKEN_PARAM}=${encodeURIComponent(token)}` : `http://localhost:${port}/health`;
@@ -8248,6 +8248,13 @@ var printStartupMessage = (agentId, port) => {
   );
   console.log(`- Local:    ${import_picocolors.default.cyan(`ws://localhost:${port}`)}`);
 };
+var startProviderServer = (source, handler) => {
+  fetch(
+    `https://www.react-grab.com/api/version?source=${source}&t=${Date.now()}`
+  ).catch(() => {
+  });
+  connectRelay({ handler });
+};
 
 // src/client.ts
 var createRelayClient = (options = {}) => {
@@ -8620,6 +8627,69 @@ var getDefaultRelayClient = () => {
   }
   return defaultRelayClient;
 };
+var isReactGrabApi = (value) => typeof value === "object" && value !== null && "registerPlugin" in value;
+var createProviderClientPlugin = (config) => {
+  const createAgentProvider = (providerOptions = {}) => {
+    const relayClient = providerOptions.relayClient ?? getDefaultRelayClient();
+    if (!relayClient) {
+      throw new Error("RelayClient is required in browser environments");
+    }
+    return createRelayAgentProvider({
+      relayClient,
+      agentId: config.agentId
+    });
+  };
+  const attachAgent = async () => {
+    if (typeof window === "undefined") return;
+    const relayClient = getDefaultRelayClient();
+    if (!relayClient) return;
+    try {
+      await relayClient.connect();
+    } catch {
+      return;
+    }
+    const provider = createRelayAgentProvider({
+      relayClient,
+      agentId: config.agentId
+    });
+    const attach = (api) => {
+      const agent = { provider, storage: sessionStorage };
+      api.registerPlugin({
+        name: config.pluginName,
+        actions: [
+          {
+            id: config.actionId,
+            label: config.actionLabel,
+            shortcut: "Enter",
+            onAction: (actionContext) => {
+              actionContext.enterPromptMode?.(agent);
+            },
+            agent
+          }
+        ]
+      });
+    };
+    const existingApi = window.__REACT_GRAB__;
+    if (isReactGrabApi(existingApi)) {
+      attach(existingApi);
+      return;
+    }
+    window.addEventListener(
+      "react-grab:init",
+      (event) => {
+        if (!(event instanceof CustomEvent)) return;
+        if (!isReactGrabApi(event.detail)) return;
+        attach(event.detail);
+      },
+      { once: true }
+    );
+    const apiAfterListener = window.__REACT_GRAB__;
+    if (isReactGrabApi(apiAfterListener)) {
+      attach(apiAfterListener);
+    }
+  };
+  return { createAgentProvider, attachAgent };
+};
 
 exports.COMPLETED_STATUS = COMPLETED_STATUS;
 exports.DEFAULT_RECONNECT_INTERVAL_MS = DEFAULT_RECONNECT_INTERVAL_MS;
@@ -8628,7 +8698,9 @@ exports.HEALTH_CHECK_TIMEOUT_MS = HEALTH_CHECK_TIMEOUT_MS;
 exports.POST_KILL_DELAY_MS = POST_KILL_DELAY_MS;
 exports.RELAY_TOKEN_PARAM = RELAY_TOKEN_PARAM;
 exports.connectRelay = connectRelay;
+exports.createProviderClientPlugin = createProviderClientPlugin;
 exports.createRelayAgentProvider = createRelayAgentProvider;
 exports.createRelayClient = createRelayClient;
 exports.createRelayServer = createRelayServer;
 exports.getDefaultRelayClient = getDefaultRelayClient;
+exports.startProviderServer = startProviderServer;

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { AgentContext, RelayToBrowserMessage } from './protocol.cjs';
 export { AgentHandler, AgentMessage, AgentRunOptions, BrowserToRelayMessage, COMPLETED_STATUS, DEFAULT_RECONNECT_INTERVAL_MS, DEFAULT_RELAY_PORT, HEALTH_CHECK_TIMEOUT_MS, HandlerRegistrationMessage, HandlerToRelayMessage, HandlerUnregisterMessage, POST_KILL_DELAY_MS, RELAY_TOKEN_PARAM, RelayToHandlerMessage } from './protocol.cjs';
 export { RelayServer, createRelayServer } from './server.cjs';
-export { connectRelay } from './connection.cjs';
+export { connectRelay, startProviderServer } from './connection.cjs';
 
 interface RelayClient {
     connect: () => Promise<void>;
@@ -37,11 +37,27 @@ interface CreateRelayAgentProviderOptions {
     agentId: string;
 }
 declare const createRelayAgentProvider: (options: CreateRelayAgentProviderOptions) => AgentProvider;
+interface ReactGrabApi {
+    registerPlugin: (plugin: unknown) => void;
+}
 declare global {
     interface Window {
         __REACT_GRAB_RELAY__?: RelayClient;
+        __REACT_GRAB__?: ReactGrabApi;
     }
 }
 declare const getDefaultRelayClient: () => RelayClient | null;
+interface ProviderPluginConfig {
+    agentId: string;
+    pluginName: string;
+    actionId: string;
+    actionLabel: string;
+}
+declare const createProviderClientPlugin: (config: ProviderPluginConfig) => {
+    createAgentProvider: (providerOptions?: {
+        relayClient?: RelayClient;
+    }) => AgentProvider;
+    attachAgent: () => Promise<void>;
+};
 
-export { AgentContext, type AgentProvider, type RelayClient, RelayToBrowserMessage, createRelayAgentProvider, createRelayClient, getDefaultRelayClient };
+export { AgentContext, type AgentProvider, type RelayClient, RelayToBrowserMessage, createProviderClientPlugin, createRelayAgentProvider, createRelayClient, getDefaultRelayClient };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { AgentContext, RelayToBrowserMessage } from './protocol.js';
 export { AgentHandler, AgentMessage, AgentRunOptions, BrowserToRelayMessage, COMPLETED_STATUS, DEFAULT_RECONNECT_INTERVAL_MS, DEFAULT_RELAY_PORT, HEALTH_CHECK_TIMEOUT_MS, HandlerRegistrationMessage, HandlerToRelayMessage, HandlerUnregisterMessage, POST_KILL_DELAY_MS, RELAY_TOKEN_PARAM, RelayToHandlerMessage } from './protocol.js';
 export { RelayServer, createRelayServer } from './server.js';
-export { connectRelay } from './connection.js';
+export { connectRelay, startProviderServer } from './connection.js';
 
 interface RelayClient {
     connect: () => Promise<void>;
@@ -37,11 +37,27 @@ interface CreateRelayAgentProviderOptions {
     agentId: string;
 }
 declare const createRelayAgentProvider: (options: CreateRelayAgentProviderOptions) => AgentProvider;
+interface ReactGrabApi {
+    registerPlugin: (plugin: unknown) => void;
+}
 declare global {
     interface Window {
         __REACT_GRAB_RELAY__?: RelayClient;
+        __REACT_GRAB__?: ReactGrabApi;
     }
 }
 declare const getDefaultRelayClient: () => RelayClient | null;
+interface ProviderPluginConfig {
+    agentId: string;
+    pluginName: string;
+    actionId: string;
+    actionLabel: string;
+}
+declare const createProviderClientPlugin: (config: ProviderPluginConfig) => {
+    createAgentProvider: (providerOptions?: {
+        relayClient?: RelayClient;
+    }) => AgentProvider;
+    attachAgent: () => Promise<void>;
+};
 
-export { AgentContext, type AgentProvider, type RelayClient, RelayToBrowserMessage, createRelayAgentProvider, createRelayClient, getDefaultRelayClient };
+export { AgentContext, type AgentProvider, type RelayClient, RelayToBrowserMessage, createProviderClientPlugin, createRelayAgentProvider, createRelayClient, getDefaultRelayClient };

package/dist/index.js

@@ -8006,7 +8006,7 @@ async function fkill(inputs, options = {}) {
 var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
 // src/connection.ts
-var VERSION = "0.1.14";
+var VERSION = "0.1.16";
 var checkIfRelayServerIsRunning = async (port, token) => {
   try {
     const healthUrl = token ? `http://localhost:${port}/health?${RELAY_TOKEN_PARAM}=${encodeURIComponent(token)}` : `http://localhost:${port}/health`;
@@ -8238,6 +8238,13 @@ var printStartupMessage = (agentId, port) => {
   );
   console.log(`- Local:    ${import_picocolors.default.cyan(`ws://localhost:${port}`)}`);
 };
+var startProviderServer = (source, handler) => {
+  fetch(
+    `https://www.react-grab.com/api/version?source=${source}&t=${Date.now()}`
+  ).catch(() => {
+  });
+  connectRelay({ handler });
+};
 
 // src/client.ts
 var createRelayClient = (options = {}) => {
@@ -8610,5 +8617,68 @@ var getDefaultRelayClient = () => {
   }
   return defaultRelayClient;
 };
+var isReactGrabApi = (value) => typeof value === "object" && value !== null && "registerPlugin" in value;
+var createProviderClientPlugin = (config) => {
+  const createAgentProvider = (providerOptions = {}) => {
+    const relayClient = providerOptions.relayClient ?? getDefaultRelayClient();
+    if (!relayClient) {
+      throw new Error("RelayClient is required in browser environments");
+    }
+    return createRelayAgentProvider({
+      relayClient,
+      agentId: config.agentId
+    });
+  };
+  const attachAgent = async () => {
+    if (typeof window === "undefined") return;
+    const relayClient = getDefaultRelayClient();
+    if (!relayClient) return;
+    try {
+      await relayClient.connect();
+    } catch {
+      return;
+    }
+    const provider = createRelayAgentProvider({
+      relayClient,
+      agentId: config.agentId
+    });
+    const attach = (api) => {
+      const agent = { provider, storage: sessionStorage };
+      api.registerPlugin({
+        name: config.pluginName,
+        actions: [
+          {
+            id: config.actionId,
+            label: config.actionLabel,
+            shortcut: "Enter",
+            onAction: (actionContext) => {
+              actionContext.enterPromptMode?.(agent);
+            },
+            agent
+          }
+        ]
+      });
+    };
+    const existingApi = window.__REACT_GRAB__;
+    if (isReactGrabApi(existingApi)) {
+      attach(existingApi);
+      return;
+    }
+    window.addEventListener(
+      "react-grab:init",
+      (event) => {
+        if (!(event instanceof CustomEvent)) return;
+        if (!isReactGrabApi(event.detail)) return;
+        attach(event.detail);
+      },
+      { once: true }
+    );
+    const apiAfterListener = window.__REACT_GRAB__;
+    if (isReactGrabApi(apiAfterListener)) {
+      attach(apiAfterListener);
+    }
+  };
+  return { createAgentProvider, attachAgent };
+};
 
-export { COMPLETED_STATUS, DEFAULT_RECONNECT_INTERVAL_MS, DEFAULT_RELAY_PORT, HEALTH_CHECK_TIMEOUT_MS, POST_KILL_DELAY_MS, RELAY_TOKEN_PARAM, connectRelay, createRelayAgentProvider, createRelayClient, createRelayServer, getDefaultRelayClient };
+export { COMPLETED_STATUS, DEFAULT_RECONNECT_INTERVAL_MS, DEFAULT_RELAY_PORT, HEALTH_CHECK_TIMEOUT_MS, POST_KILL_DELAY_MS, RELAY_TOKEN_PARAM, connectRelay, createProviderClientPlugin, createRelayAgentProvider, createRelayClient, createRelayServer, getDefaultRelayClient, startProviderServer };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-grab/relay",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "files": [
     "dist"
   ],
@@ -31,7 +31,7 @@
     "fkill": "^9.0.0",
     "picocolors": "^1.1.1",
     "ws": "^8.18.0",
-    "@react-grab/utils": "0.1.14"
+    "@react-grab/utils": "0.1.16"
   },
   "devDependencies": {
     "@types/node": "^22.10.7",