@opengeni/api-router 3.3.0 → 3.4.0

package/dist/integrations/marketplace-plugin.d.ts

@@ -53,8 +53,8 @@ export declare function marketplacePlugin(url: string): {
         keywords: never[];
         author: {
             name: string;
-            email?: never;
             url?: never;
+            email?: never;
         };
         version: string;
         license: null;
@@ -349,9 +349,9 @@ export declare function marketplacePlugin(url: string): {
         installation: string;
         upstream: {
             source: {
+                url?: never;
                 source: string;
                 path: string;
-                url?: never;
             };
             policy: {
                 installation: string;
@@ -369,9 +369,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: string[];
         author: {
+            url?: never;
             name: string;
             email?: never;
-            url?: never;
         };
         version: string;
         license: string;
@@ -395,9 +395,9 @@ export declare function marketplacePlugin(url: string): {
         installation: string;
         upstream: {
             source: {
+                url?: never;
                 source: string;
                 path: string;
-                url?: never;
             };
             policy: {
                 installation: string;
@@ -415,9 +415,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: never[];
         author: {
+            url?: never;
             name: string;
             email?: never;
-            url?: never;
         };
         version: string;
         license: null;
@@ -441,9 +441,9 @@ export declare function marketplacePlugin(url: string): {
         installation: string;
         upstream: {
             source: {
+                url?: never;
                 source: string;
                 path: string;
-                url?: never;
             };
             policy: {
                 products?: never;
@@ -461,9 +461,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: string[];
         author: {
+            url?: never;
             name: string;
             email?: never;
-            url?: never;
         };
         version: string;
         license: string;
@@ -487,9 +487,9 @@ export declare function marketplacePlugin(url: string): {
         installation: string;
         upstream: {
             source: {
+                url?: never;
                 source: string;
                 path: string;
-                url?: never;
             };
             policy: {
                 products?: never;
@@ -507,9 +507,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: string[];
         author: {
+            url?: never;
             name: string;
             email: string;
-            url?: never;
         };
         version: string;
         license: string;
@@ -533,9 +533,9 @@ export declare function marketplacePlugin(url: string): {
         installation: string;
         upstream: {
             source: {
+                url?: never;
                 source: string;
                 path: string;
-                url?: never;
             };
             policy: {
                 products?: never;
@@ -553,9 +553,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: never[];
         author: {
+            url?: never;
             email?: never;
             name: string;
-            url?: never;
         };
         version: string;
         license: string;
@@ -576,9 +576,9 @@ export declare function marketplacePlugin(url: string): {
         installation: string;
         upstream: {
             source: {
+                url?: never;
                 source: string;
                 path: string;
-                url?: never;
             };
             policy: {
                 products?: never;
@@ -596,9 +596,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: never[];
         author: {
+            url?: never;
             email?: never;
             name: string;
-            url?: never;
         };
         version: string;
         license: null;
@@ -622,9 +622,9 @@ export declare function marketplacePlugin(url: string): {
         installation: string;
         upstream: {
             source: {
+                url?: never;
                 source: string;
                 path: string;
-                url?: never;
             };
             policy: {
                 products?: never;
@@ -769,9 +769,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: never[];
         author: {
+            url?: never;
             name: string;
             email: string;
-            url?: never;
         };
         version: string;
         license: string;
@@ -813,9 +813,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: never[];
         author: {
+            url?: never;
             email?: never;
             name: string;
-            url?: never;
         };
         version: null;
         license: null;
@@ -896,9 +896,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: string[];
         author: {
+            url?: never;
             name: string;
             email: string;
-            url?: never;
         };
         version: string;
         license: string;
@@ -940,9 +940,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: never[];
         author: {
+            url?: never;
             email?: never;
             name: string;
-            url?: never;
         };
         version: null;
         license: null;
@@ -984,9 +984,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: string[];
         author: {
+            url?: never;
             email?: never;
             name: string;
-            url?: never;
         };
         version: string;
         license: string;
@@ -1033,9 +1033,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: string[];
         author: {
+            url?: never;
             name: string;
             email: string;
-            url?: never;
         };
         version: string;
         license: null;
@@ -1118,9 +1118,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: string[];
         author: {
+            url?: never;
             email?: never;
             name: string;
-            url?: never;
         };
         version: string;
         license: null;
@@ -1162,9 +1162,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: string[];
         author: {
+            url?: never;
             email?: never;
             name: string;
-            url?: never;
         };
         version: string;
         license: string;
@@ -1243,9 +1243,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: never[];
         author: {
+            url?: never;
             name: string;
             email: string;
-            url?: never;
         };
         version: string;
         license: null;
@@ -1273,9 +1273,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: never[];
         author: {
+            url?: never;
             name: string;
             email: string;
-            url?: never;
         };
         version: string;
         license: null;
@@ -1306,9 +1306,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: string[];
         author: {
+            url?: never;
             name: string;
             email: string;
-            url?: never;
         };
         version: string;
         license: string;
@@ -1339,9 +1339,9 @@ export declare function marketplacePlugin(url: string): {
         category: null;
         keywords: string[];
         author: {
+            url?: never;
             name: string;
             email: string;
-            url?: never;
         };
         version: string;
         license: string;
@@ -1427,9 +1427,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: string[];
         author: {
+            url?: never;
             email?: never;
             name: string;
-            url?: never;
         };
         version: string;
         license: string;
@@ -1471,9 +1471,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: never[];
         author: {
+            url?: never;
             email?: never;
             name: string;
-            url?: never;
         };
         version: null;
         license: null;
@@ -1614,9 +1614,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: never[];
         author: {
+            url?: never;
             name: string;
             email: string;
-            url?: never;
         };
         version: string;
         license: null;
@@ -1658,9 +1658,9 @@ export declare function marketplacePlugin(url: string): {
         category: null;
         keywords: string[];
         author: {
+            url?: never;
             email?: never;
             name: string;
-            url?: never;
         };
         version: string;
         license: null;
@@ -1697,9 +1697,9 @@ export declare function marketplacePlugin(url: string): {
         category: null;
         keywords: never[];
         author: {
+            url?: never;
             email?: never;
             name: string;
-            url?: never;
         };
         version: string;
         license: string;
@@ -1741,9 +1741,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: never[];
         author: {
+            url?: never;
             email?: never;
             name: string;
-            url?: never;
         };
         version: null;
         license: null;
@@ -1776,9 +1776,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: never[];
         author: {
+            url?: never;
             name: string;
             email: string;
-            url?: never;
         };
         version: null;
         license: null;
@@ -1853,9 +1853,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: string[];
         author: {
+            url?: never;
             name: string;
             email: string;
-            url?: never;
         };
         version: string;
         license: string;
@@ -1897,9 +1897,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: string[];
         author: {
+            url?: never;
             name: string;
             email: string;
-            url?: never;
         };
         version: string;
         license: string;
@@ -1941,9 +1941,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: string[];
         author: {
+            url?: never;
             name: string;
             email: string;
-            url?: never;
         };
         version: null;
         license: string;
@@ -1985,9 +1985,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: string[];
         author: {
+            url?: never;
             email?: never;
             name: string;
-            url?: never;
         };
         version: null;
         license: string;
@@ -2024,9 +2024,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: string[];
         author: {
+            url?: never;
             email?: never;
             name: string;
-            url?: never;
         };
         version: string;
         license: null;
@@ -2235,9 +2235,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: string[];
         author: {
+            url?: never;
             email?: never;
             name: string;
-            url?: never;
         };
         version: string;
         license: null;
@@ -2279,9 +2279,9 @@ export declare function marketplacePlugin(url: string): {
         category: null;
         keywords: never[];
         author: {
+            url?: never;
             email?: never;
             name: string;
-            url?: never;
         };
         version: null;
         license: null;
@@ -2369,9 +2369,9 @@ export declare function marketplacePlugin(url: string): {
         category: null;
         keywords: string[];
         author: {
+            url?: never;
             email?: never;
             name: string;
-            url?: never;
         };
         version: string;
         license: string;
@@ -2408,9 +2408,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: string[];
         author: {
+            url?: never;
             name: string;
             email: string;
-            url?: never;
         };
         version: string;
         license: null;
@@ -2657,9 +2657,9 @@ export declare function marketplacePlugin(url: string): {
         category: string;
         keywords: string[];
         author: {
+            url?: never;
             name: string;
             email: string;
-            url?: never;
         };
         version: string;
         license: string;

package/dist/mcp/scheduled-task-view.d.ts

@@ -83,8 +83,8 @@ export declare function scheduledTaskMcpSummary(task: ScheduledTask): {
     runMode: "existing_session" | "new_session_per_run" | "reusable_session";
     overlapPolicy: "allow_concurrent" | "buffer_one" | "skip";
     action: {
+        readonly sourceId?: never;
         kind: "agent_turn";
-        sourceId?: never;
         sourceGeneration?: never;
         sourceLifecycleGeneration?: never;
         destination?: never;
@@ -221,8 +221,8 @@ export declare function boundScheduledTaskDetailMcp(task: ScheduledTask): {
     runMode: "existing_session" | "new_session_per_run" | "reusable_session";
     overlapPolicy: "allow_concurrent" | "buffer_one" | "skip";
     action: {
+        readonly sourceId?: never;
         kind: "agent_turn";
-        sourceId?: never;
         sourceGeneration?: never;
         sourceLifecycleGeneration?: never;
         destination?: never;
@@ -408,8 +408,8 @@ export declare function boundScheduledTaskDetailMcp(task: ScheduledTask): {
     runMode: "existing_session" | "new_session_per_run" | "reusable_session";
     overlapPolicy: "allow_concurrent" | "buffer_one" | "skip";
     action: {
+        readonly sourceId?: never;
         kind: "agent_turn";
-        sourceId?: never;
         sourceGeneration?: never;
         sourceLifecycleGeneration?: never;
         destination?: never;
@@ -601,8 +601,8 @@ export declare function boundScheduledTaskMcpPage(input: {
         runMode: "existing_session" | "new_session_per_run" | "reusable_session";
         overlapPolicy: "allow_concurrent" | "buffer_one" | "skip";
         action: {
+            readonly sourceId?: never;
             kind: "agent_turn";
-            sourceId?: never;
             sourceGeneration?: never;
             sourceLifecycleGeneration?: never;
             destination?: never;

package/dist/mcp/server.d.ts

@@ -50,6 +50,7 @@ export declare function orchestrationFailureEnvelope(tool: OrchestrationToolName
     };
 } | {
     error: {
+        reason?: never;
         code: "nested_agent_depth_exceeded" | "nested_agent_depth_override_forbidden";
         details: {
             readonly denial: {
@@ -70,7 +71,6 @@ export declare function orchestrationFailureEnvelope(tool: OrchestrationToolName
                 createdAt: string;
             };
         };
-        reason?: never;
         retryable?: never;
         message: string;
     };
@@ -116,6 +116,16 @@ export declare function slackBotFileContentResult(result: Awaited<ReturnType<Ope
         data: string;
     })[];
 };
+/**
+ * The first-party server as seen by MCP protocol messages that touch no tool:
+ * `initialize`, `ping` and notifications. It advertises exactly what the full
+ * server does (the same name, version and tools capability) without the
+ * workspace, catalog, Memory and admin reads that registering tools needs.
+ * Never route `tools/*` here: it lists no tools.
+ */
+export declare function buildOpenGeniMcpProtocolServer(grant: AccessGrant): McpServer;
+/** JSON-RPC methods {@link buildOpenGeniMcpProtocolServer} answers like the full server. */
+export declare function isOpenGeniMcpProtocolOnlyMessage(message: unknown): boolean;
 export declare function buildOpenGeniMcpServer(deps: ApiRouteDeps, grant: AccessGrant, options?: McpServerOptions): McpServer;
 /** Only a prompt explicitly supplied through the human/API channel may redirect a user-paused goal. */
 export declare function isHumanDirectedTurn(turn: {

package/dist/routes/browser-sessions.d.ts

@@ -1,6 +1,6 @@
-import { InteractionActor, type AccessGrant, type FileAsset, type CreateBrowserSessionRequest as CreateBrowserSessionRequestValue, type InteractionPlacement } from "@opengeni/contracts";
+import { BrowserObservation, type BrowserTarget, InteractionActor, type AccessGrant, type FileAsset, type CreateBrowserSessionRequest as CreateBrowserSessionRequestValue, type InteractionPlacement } from "@opengeni/contracts";
 import { type ApiRouteDeps, type ResolvedSessionAuthorization } from "@opengeni/core";
-import { type BrowserControlScreenshotOptions, type BrowserControlFrame } from "@opengeni/runtime/sandbox";
+import { BrowserControlClient, type BrowserControlScreenshotOptions, type BrowserControlFrame } from "@opengeni/runtime/sandbox";
 import type { Hono } from "hono";
 import { type InteractionSecretsPort } from "../interaction-secrets.js";
 export declare function registerBrowserSessionRoutes(app: Hono, deps: ApiRouteDeps, options?: {
@@ -59,6 +59,27 @@ export declare function browserNeedsStandaloneDisplayStack(input: {
     linkedComputer: boolean;
     nativeBrowserControl: boolean;
 }): boolean;
+/** Attach the controller's launch view to a create that activated exactly that
+ * launch in this request. Replays, failures and other bindings get nothing, so
+ * a caller then reads the targets and observes as before. */
+export declare function withInitialView<T extends {
+    session: {
+        id: string;
+        lifecycle: string;
+        controller: {
+            controllerGeneration: string;
+        } | null;
+    };
+    operation: {
+        state: string;
+        replayed: boolean;
+    };
+}>(response: T, launched: Awaited<ReturnType<BrowserControlClient["createSession"]>> | null): T | (T & {
+    initialView: {
+        targets: BrowserTarget[];
+        observation: BrowserObservation;
+    };
+});
 export declare function parseBrowserScreenshotOptions(query: URLSearchParams): BrowserControlScreenshotOptions;
 /** Preserve the controller's definite tab diagnosis (a tab that stopped
  * answering, or one whose renderer crashed) through the public API with its

package/dist/routes/sessions.d.ts

@@ -27,6 +27,7 @@ export declare function sessionListQuery(query: Record<string, string>, allowCur
     includeTotals: boolean;
     needsYouOnly: boolean;
     contentArchivedOnly: boolean;
+    mineOnly: boolean;
     archivedOnly: boolean;
     sortBy: "updatedAt" | "createdAt" | "name" | undefined;
     archiveStatus: "active" | "archived" | "all" | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/api-router",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "description": "Opengeni HTTP surface: the Hono adapter/router (createApp), routes, MCP HTTP transport, and HTTP access adapters over @opengeni/core. An engine-distribution surface — its runtime closure includes engine-internal packages.",
   "license": "Apache-2.0",
   "repository": {
@@ -45,29 +45,29 @@
     "@keeper-security/secrets-manager-core": "17.6.0",
     "@llamaindex/liteparse": "2.14.2",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@opengeni/agent-proto": "3.3.0",
-    "@opengeni/artifact-tool": "3.3.0",
-    "@opengeni/capabilities": "3.3.0",
-    "@opengeni/codemode": "3.3.0",
-    "@opengeni/codex": "3.3.0",
-    "@opengeni/config": "3.3.0",
-    "@opengeni/contracts": "3.3.0",
-    "@opengeni/core": "3.3.0",
-    "@opengeni/db": "3.3.0",
-    "@opengeni/documents": "3.3.0",
-    "@opengeni/events": "3.3.0",
-    "@opengeni/github": "3.3.0",
-    "@opengeni/interaction": "3.3.0",
-    "@opengeni/network": "3.3.0",
-    "@opengeni/observability": "3.3.0",
-    "@opengeni/runtime": "3.3.0",
-    "@opengeni/storage": "3.3.0",
-    "@opengeni/tool-gateway": "3.3.0",
-    "@opengeni/vaults": "3.3.0",
-    "@opengeni/vaults-keeper": "3.3.0",
-    "@opengeni/vaults-onepassword": "3.3.0",
-    "@opengeni/vaults-protonpass": "3.3.0",
-    "@opengeni/xai-subscription": "3.3.0",
+    "@opengeni/agent-proto": "3.4.0",
+    "@opengeni/artifact-tool": "3.4.0",
+    "@opengeni/capabilities": "3.4.0",
+    "@opengeni/codemode": "3.4.0",
+    "@opengeni/codex": "3.4.0",
+    "@opengeni/config": "3.4.0",
+    "@opengeni/contracts": "3.4.0",
+    "@opengeni/core": "3.4.0",
+    "@opengeni/db": "3.4.0",
+    "@opengeni/documents": "3.4.0",
+    "@opengeni/events": "3.4.0",
+    "@opengeni/github": "3.4.0",
+    "@opengeni/interaction": "3.4.0",
+    "@opengeni/network": "3.4.0",
+    "@opengeni/observability": "3.4.0",
+    "@opengeni/runtime": "3.4.0",
+    "@opengeni/storage": "3.4.0",
+    "@opengeni/tool-gateway": "3.4.0",
+    "@opengeni/vaults": "3.4.0",
+    "@opengeni/vaults-keeper": "3.4.0",
+    "@opengeni/vaults-onepassword": "3.4.0",
+    "@opengeni/vaults-protonpass": "3.4.0",
+    "@opengeni/xai-subscription": "3.4.0",
     "@temporalio/client": "^1.17.0",
     "ajv": "^8.20.0",
     "better-auth": "^1.6.14",