@opengeni/runtime 4.0.0 → 4.0.1

package/dist/{chunk-5HJEVOMJ.js → chunk-J6J3VYFW.js}

@@ -26,7 +26,7 @@ import {
   withRunCredentialsClient,
   withRunCredentialsSession,
   wrapCapabilityToolsForTurnCancellation
-} from "./chunk-WIHICNWS.js";
+} from "./chunk-J5AR5XAJ.js";
 import {
   MemorySession,
   connectMcpServers
@@ -10316,6 +10316,8 @@ Display images with ![descriptive alt text](artifact:<artifactId>). Use the exac
 
 Publish files you deliberately deliver so they are retained and discoverable in Artifacts; do not publish every temporary file. Reuse retained references for unchanged outputs. Source-code navigation may still use workspace file links. Inline HTML stays in chat unless explicitly saved as a Site.
 
+For published files, [Open file](artifact:<artifactId>) opens the retained file in Artifacts. ![Preview](artifact:<artifactId>) displays images, video, audio, or PDFs inline in the OpenGeni console, with an Artifact link for other formats. Replace <artifactId> with the exact artifact.artifactId from the publication receipt and use a descriptive label. Sites and native documents keep their tool-returned canonical links. Never substitute a storage URL or a sandbox path for a published artifact reference.
+
 # Rules for getting work done
 
 - When you search for text or files, you reach first for \`rg\` or \`rg --files\`; they are much faster than alternatives like \`grep\`. If \`rg\` is unavailable, you use the next best tool without fuss.
@@ -10353,6 +10355,8 @@ When presented with clarifying questions or objections from the user, lead with
 
 If completion requires new authority, external coordination, or a meaningful expansion beyond the user\u2019s implied intent and task scope (e.g. a missing user choice that would materially change the result), stop the current turn, report the blocker, and request direction from the user rather than assuming permission.
 
+Decide the design before building it. First check whether OpenGeni already provides the capability natively (for example, a Site reaches the model and workspace tools through the host bridge and needs no server of its own). If a native path fits, use it. Follow the project's established architecture and choices the user has already authorized or delegated; the user need not name each host, provider, or credential. Ask before making a new external commitment or materially departing from the established architecture beyond the authorized scope: name the candidate designs, and do not start parallel work that assumes the unresolved choice. The absence of a native path alone does not require a question; continue with routine implementation choices within scope.
+
 # Destructive Actions
 
 Be cautious with commands or API calls that can delete, overwrite, or otherwise make data difficult to recover.
@@ -10385,7 +10389,7 @@ Skills are reusable instructions supplied dynamically for the current session. W
 
 # Integration setup
 
-Use available integration tools directly. If the task needs an integration you cannot access, discover it with \`capability_catalog_search\` before declaring a setup blocker. For a suitable match with \`setup.nextAction\`, call \`capability_authorization_request\` with the returned capability ID and a brief task-specific rationale to show its Connect card in chat. Requesting the card does not need integration-management permission; the authenticated human must authorize setup. After setup, rediscover the tools and continue the task, verifying the access it needs. If access remains blocked, explain the specific blocker from the returned facts. If either setup tool is unavailable, report the missing setup path.
+Use available integration tools directly. If the task needs an integration you cannot access, discover it with \`capability_catalog_search\` before declaring a setup blocker. For a suitable match with \`setup.nextAction\`, call \`capability_authorization_request\` with the returned capability ID and a brief task-specific rationale to show its Connect card in chat. Requesting the card does not need integration-management permission; the authenticated human must authorize setup. A card is for an integration required by the authorized design, including established or delegated choices. Resolve out-of-scope architecture choices before requesting setup. After setup, rediscover the tools and continue the task, verifying the access it needs. If access remains blocked, explain the specific blocker from the returned facts. If either setup tool is unavailable, report the missing setup path.
 
 # Session coordination
 
@@ -12344,7 +12348,7 @@ import { existsSync, readdirSync } from "fs";
 // ../sdk/package.json
 var package_default = {
   name: "@opengeni/sdk",
-  version: "7.0.0",
+  version: "7.1.0",
   description: "Framework-agnostic TypeScript SDK for the OpenGeni API: typed client, session lifecycle, SSE event streaming with reconnect + replay-by-sequence, and proxy re-streaming helpers.",
   license: "Apache-2.0",
   repository: {
@@ -12496,7 +12500,7 @@ var package_default = {
 // ../react/package.json
 var package_default2 = {
   name: "@opengeni/react",
-  version: "7.0.0",
+  version: "7.1.0",
   description: "React hooks and styled components for OpenGeni: live session streaming, chat composer, message timeline, session status, and fleet views \u2014 token-themed (CSS variables), dark-first, built on Tailwind v4 + Radix + Motion.",
   license: "Apache-2.0",
   repository: {
@@ -12749,7 +12753,7 @@ var package_default2 = {
 // ../codemode/package.json
 var package_default3 = {
   name: "@opengeni/codemode",
-  version: "0.6.0",
+  version: "0.6.1",
   description: "Attempt-frozen programmatic tool catalog and execution authority for OpenGeni.",
   license: "Apache-2.0",
   repository: {
@@ -12799,7 +12803,7 @@ var package_default3 = {
 // ../ogtool/package.json
 var package_default4 = {
   name: "@opengeni/ogtool",
-  version: "0.3.42",
+  version: "0.3.43",
   description: "Codemode CLI and typed client entrypoint for an OpenGeni execution attempt.",
   license: "Apache-2.0",
   repository: {
@@ -18430,6 +18434,7 @@ var DeferredPreparedMcpServer = class {
   deferredPreparation = true;
   name;
   listedModelNames = /* @__PURE__ */ new Set();
+  preparedTarget = null;
   toolMetaResolver = async (context) => {
     const target = await this.resolveTarget();
     return await target?.toolMetaResolver?.(context);
@@ -18446,6 +18451,7 @@ var DeferredPreparedMcpServer = class {
     if (!this.isPrepared()) return [];
     const target = await this.resolveTarget();
     const tools = target ? await target.listTools() : [];
+    this.preparedTarget = target instanceof PrefixedMcpServer ? target : null;
     this.listedModelNames.clear();
     for (const tool2 of tools) this.listedModelNames.add(tool2.name);
     return tools;
@@ -18453,6 +18459,9 @@ var DeferredPreparedMcpServer = class {
   modelToolNames() {
     return this.listedModelNames.values();
   }
+  toolDisplayMetadata(name) {
+    return this.preparedTarget?.toolDisplayMetadata(name);
+  }
   async unprefixedToolName(name) {
     const target = await this.requiredTarget();
     if (!(target instanceof PrefixedMcpServer)) throw new Error("Unknown prepared MCP identity");
@@ -20201,7 +20210,31 @@ function normalizeUrl(raw) {
 }
 function prefixedMcpToolName(registryId, toolName) {
   const name = sharedPrefixedMcpToolName(registryId, toolName);
-  return name.length <= 64 && /^[A-Za-z0-9_]+$/.test(name) ? name : createHash5("sha256").update(JSON.stringify([registryId, toolName])).digest("hex");
+  if (name.length <= 64 && /^[A-Za-z0-9_]+$/.test(name)) return name;
+  const digest = legacyMcpToolDigest(registryId, toolName).slice(0, 24);
+  const leaf = toolName.replace(/[^A-Za-z0-9_]/g, "_").slice(0, 34) || "tool";
+  return `mcp_${digest}__${leaf}`;
+}
+function legacyMcpToolDigest(registryId, toolName) {
+  return createHash5("sha256").update(JSON.stringify([registryId, toolName])).digest("hex");
+}
+function mcpToolDisplayMetadata(servers, name) {
+  for (const server of servers) {
+    if (server instanceof PrefixedMcpServer || server instanceof DeferredPreparedMcpServer) {
+      const display = server.toolDisplayMetadata(name);
+      if (display) return display;
+    }
+  }
+  return void 0;
+}
+function withMcpToolDisplayMetadata(servers, payload) {
+  if (!payload || typeof payload !== "object" || Array.isArray(payload)) return payload;
+  const item = payload;
+  const raw = item.rawItem && typeof item.rawItem === "object" ? item.rawItem : {};
+  const name = item.name ?? item.toolName ?? raw.name;
+  if (typeof name !== "string") return payload;
+  const display = mcpToolDisplayMetadata(servers, name);
+  return display ? { ...item, display } : payload;
 }
 var MCP_SDK_LIFECYCLE_NAME = "opengeni-mcp-lifecycle";
 function publicMcpLifecycleError(error, phase, serverId, options = {}) {
@@ -20364,6 +20397,10 @@ var PrefixedMcpServer = class _PrefixedMcpServer {
   listedToolSchemaTokens = 0;
   frozenTools = null;
   originalToolNames = /* @__PURE__ */ new Map();
+  displayMetadata = /* @__PURE__ */ new Map();
+  toolDisplayMetadata(name) {
+    return this.displayMetadata.get(name);
+  }
   /** Exact attempt-local classification, including names too long for a prefix. */
   modelToolNames() {
     return this.originalToolNames.keys();
@@ -20509,6 +20546,13 @@ var PrefixedMcpServer = class _PrefixedMcpServer {
         if (prior !== void 0 && prior !== tool2.name)
           throw new Error("MCP model tool identity collision");
         this.originalToolNames.set(name, tool2.name);
+        const display = {
+          toolName: tool2.name,
+          ...tool2.title ? { title: tool2.title } : {},
+          ...this.accountLabel ? { accountLabel: this.accountLabel } : {}
+        };
+        this.displayMetadata.set(name, display);
+        this.displayMetadata.set(legacyMcpToolDigest(this.registryId, tool2.name), display);
         return {
           ...tool2,
           name,
@@ -20748,9 +20792,7 @@ async function restoreInterruptedRunState(agent, serializedRunState) {
   }
   return await RunState.fromString(agent, serializedRunState, {
     clientToolSearchRehydration: "preserve_history",
-    ...lazyRuntime ? {
-      resolveMissingFunctionTool: createResolveMissingFunctionTool(lazyRuntime)
-    } : {}
+    resolveMissingFunctionTool: mcpToolResolverForAgent(agent)
   });
 }
 var TURN_OPERATIONAL_NOTICE_PREFIX = "[OpenGeni turn-scoped operational notice]\n";
@@ -21276,10 +21318,35 @@ function appendSandboxFileDownloadFailureNote(input, failures) {
 }
 function lazyToolRunBindings(agent) {
   const runtime = lazyToolRuntimeForAgent(agent);
-  if (!runtime) return {};
   return {
-    toolNotFoundBehavior: "return_error_to_model",
-    resolveMissingFunctionTool: createResolveMissingFunctionTool(runtime)
+    ...runtime ? { toolNotFoundBehavior: "return_error_to_model" } : {},
+    resolveMissingFunctionTool: mcpToolResolverForAgent(agent)
+  };
+}
+function mcpToolResolverForAgent(agent) {
+  const lazyRuntime = lazyToolRuntimeForAgent(agent);
+  const resolveCurrent = lazyRuntime ? createResolveMissingFunctionTool(lazyRuntime) : null;
+  return async (input) => {
+    const current = await resolveCurrent?.(input);
+    if (current) return current;
+    if (!/^[a-f0-9]{64}$/.test(input.name)) return null;
+    const tools = await agent.getMcpTools(new RunContext());
+    let resolvedName;
+    for (const server of agent.mcpServers) {
+      if (!(server instanceof PrefixedMcpServer || server instanceof DeferredPreparedMcpServer))
+        continue;
+      for (const descriptor of await server.listTools()) {
+        const rawName = await server.unprefixedToolName(descriptor.name);
+        if (legacyMcpToolDigest(server.registryId, rawName) !== input.name) continue;
+        if (resolvedName !== void 0 && resolvedName !== descriptor.name)
+          throw new Error("MCP legacy model tool identity collision");
+        resolvedName = descriptor.name;
+      }
+    }
+    const tool2 = tools.find(
+      (candidate) => candidate.type === "function" && candidate.name === resolvedName
+    );
+    return tool2?.type === "function" ? { ...tool2, name: input.name } : null;
   };
 }
 function runScopedRunner(settings, agent, inputWaitYield) {
@@ -23828,6 +23895,8 @@ export {
   mcpTransportErrorWithRetryMetadata,
   safeMcpTransportError,
   prefixedMcpToolName,
+  mcpToolDisplayMetadata,
+  withMcpToolDisplayMetadata,
   PrefixedMcpServer,
   restoreInterruptedRunState,
   TURN_OPERATIONAL_NOTICE_PREFIX,
@@ -23872,4 +23941,4 @@ export {
   runAzureCliLoginHook,
   renderSessionGoalContext2 as renderSessionGoalContext
 };
-//# sourceMappingURL=chunk-5HJEVOMJ.js.map
+//# sourceMappingURL=chunk-J6J3VYFW.js.map