@opengeni/core 4.4.1 → 4.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/core",
-  "version": "4.4.1",
+  "version": "4.5.0",
   "description": "Opengeni framework-agnostic core: the domain, access, and billing layers (neutral access, off-HTTP V2 surface). Behavior-preserving extraction from apps/api — keeps Hono's HTTPException for error throwing (typed-errors cleanup deferred).",
   "license": "Apache-2.0",
   "repository": {
@@ -51,18 +51,18 @@
   "dependencies": {
     "@modelcontextprotocol/client": "2.3.1",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@opengeni/capabilities": "4.4.1",
-    "@opengeni/codex": "4.4.1",
-    "@opengeni/config": "4.4.1",
-    "@opengeni/contracts": "4.4.1",
-    "@opengeni/db": "4.4.1",
-    "@opengeni/documents": "4.4.1",
-    "@opengeni/events": "4.4.1",
-    "@opengeni/network": "4.4.1",
-    "@opengeni/observability": "4.4.1",
-    "@opengeni/runtime": "4.4.1",
-    "@opengeni/storage": "4.4.1",
-    "@opengeni/vaults": "4.4.1",
+    "@opengeni/capabilities": "4.5.0",
+    "@opengeni/codex": "4.5.0",
+    "@opengeni/config": "4.5.0",
+    "@opengeni/contracts": "4.5.0",
+    "@opengeni/db": "4.5.0",
+    "@opengeni/documents": "4.5.0",
+    "@opengeni/events": "4.5.0",
+    "@opengeni/network": "4.5.0",
+    "@opengeni/observability": "4.5.0",
+    "@opengeni/runtime": "4.5.0",
+    "@opengeni/storage": "4.5.0",
+    "@opengeni/vaults": "4.5.0",
     "hono": "^4.12.18",
     "zod": "^4.2.1"
   },

package/src/domain/capabilities.ts

@@ -1668,6 +1668,20 @@ function onePasswordCatalogItem(connections: ConnectionMetadata[]): CapabilityCa
   });
 }
 
+/** How people and agents name the deployment's Chrome extension, and where it is installed. */
+export type BrowserExtension = { name: string; installUrl: string };
+
+/** The deployment's configured Chrome extension, else Opengeni Browser. */
+export function browserExtension(settings: {
+  browserExtensionName?: string | undefined;
+  browserExtensionInstallUrl?: string | undefined;
+}): BrowserExtension {
+  return {
+    name: settings.browserExtensionName ?? "Opengeni Browser",
+    installUrl: settings.browserExtensionInstallUrl ?? OPENGENI_BROWSER_EXTENSION_URL,
+  };
+}
+
 /** The catalog id of the Excel add-in tile and its in-chat install card. */
 export const EXCEL_ADDIN_CAPABILITY_ID = "api:excel-addin";
 
@@ -1793,8 +1807,9 @@ export const CONNECTED_MACHINE_CAPABILITY_ID = "api:connected-machine";
 export { OPENGENI_BROWSER_EXTENSION_URL };
 
 export function nativeConnectionCapabilityRecommendations(
-  options: { connectedMachines?: boolean } = {},
+  options: { connectedMachines?: boolean; browserExtension?: BrowserExtension } = {},
 ): CapabilityCatalogItem[] {
+  const extensionUrl = options.browserExtension?.installUrl ?? OPENGENI_BROWSER_EXTENSION_URL;
   const items = [
     CapabilityCatalogItem.parse({
       id: "api:github-app",
@@ -1865,7 +1880,7 @@ export function nativeConnectionCapabilityRecommendations(
         tools: [{ kind: "mcp", id: "opengeni" }],
         runtime: {
           available: true,
-          notes: `The person sets up their machine from the chat card. The Chrome browser extension (${OPENGENI_BROWSER_EXTENSION_URL}) works only after the machine is connected.`,
+          notes: `The person sets up their machine from the chat card. The Chrome browser extension (${extensionUrl}) works only after the machine is connected.`,
         },
         lifecycle: {
           status: "available",
@@ -1882,7 +1897,7 @@ export function nativeConnectionCapabilityRecommendations(
             "connected_machine_enroll_token",
             "connected_machine_enable_screen_control",
           ],
-          browserExtensionUrl: OPENGENI_BROWSER_EXTENSION_URL,
+          browserExtensionUrl: extensionUrl,
           recommendationOnly: true,
         },
       }),