@decocms/mesh-sdk 1.2.1 → 1.2.3

package/src/hooks/use-mcp-resources.ts

@@ -1,4 +1,10 @@
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import {
+  ErrorCode,
+  McpError,
+  type ListResourcesResult,
+  type ReadResourceResult,
+} from "@modelcontextprotocol/sdk/types.js";
 import {
   useQuery,
   useSuspenseQuery,
@@ -7,10 +13,6 @@ import {
   type UseSuspenseQueryOptions,
   type UseSuspenseQueryResult,
 } from "@tanstack/react-query";
-import type {
-  ListResourcesResult,
-  ReadResourceResult,
-} from "@modelcontextprotocol/sdk/types.js";
 import { KEYS } from "../lib/query-keys";
 
 /**
@@ -24,7 +26,15 @@ export async function listResources(
   if (!capabilities?.resources) {
     return { resources: [] };
   }
-  return await client.listResources();
+
+  try {
+    return await client.listResources();
+  } catch (error) {
+    if (error instanceof McpError && error.code === ErrorCode.MethodNotFound) {
+      return { resources: [] };
+    }
+    throw error;
+  }
 }
 
 /**

package/src/hooks/use-virtual-mcp.ts

@@ -5,17 +5,28 @@
  * These hooks offer a reactive interface for accessing and manipulating virtual MCPs.
  */
 
+import { useQuery } from "@tanstack/react-query";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 import type { VirtualMCPEntity } from "../types/virtual-mcp";
 import { useProjectContext } from "../context";
 import {
+  collectionItemQueryOptions,
   useCollectionActions,
   useCollectionItem,
   useCollectionList,
   type CollectionFilter,
   type UseCollectionListOptions,
 } from "./use-collections";
+import type { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { useMCPClient } from "./use-mcp-client";
 import { SELF_MCP_ALIAS_ID } from "../lib/constants";
+import { KEYS } from "../lib/query-keys";
+
+export interface VirtualMCPLastUsed {
+  id: string;
+  last_used_at?: string;
+  last_used_by?: string;
+}
 
 /**
  * Filter definition for virtual MCPs (matches @deco/ui Filter shape)
@@ -38,6 +49,7 @@ export function useVirtualMCPs(options: UseVirtualMCPsOptions = {}) {
   const client = useMCPClient({
     connectionId: SELF_MCP_ALIAS_ID,
     orgId: org.id,
+    orgSlug: org.slug,
   });
 
   return useCollectionList<VirtualMCPEntity>(
@@ -48,6 +60,23 @@ export function useVirtualMCPs(options: UseVirtualMCPsOptions = {}) {
   );
 }
 
+/**
+ * Query options for a single virtual MCP — shared with parallel-prefetch
+ * batches so they warm the exact cache entry useVirtualMCP reads.
+ */
+export function virtualMcpItemQueryOptions(
+  orgId: string,
+  virtualMcpId: string | null | undefined,
+  client: Client,
+) {
+  return collectionItemQueryOptions<VirtualMCPEntity>(
+    orgId,
+    "VIRTUAL_MCP",
+    virtualMcpId ?? undefined,
+    client,
+  );
+}
+
 /**
  * Hook to get a single virtual MCP by ID
  *
@@ -61,6 +90,7 @@ export function useVirtualMCP(
   const client = useMCPClient({
     connectionId: SELF_MCP_ALIAS_ID,
     orgId: org.id,
+    orgSlug: org.slug,
   });
 
   // If null/undefined, return null (use default virtual MCP)
@@ -75,6 +105,39 @@ export function useVirtualMCP(
   return dbVirtualMCP;
 }
 
+/**
+ * Hook to fetch last-used info (most recent thread timestamp + user) for a set
+ * of virtual MCPs. Backed by VIRTUAL_MCP_LAST_USED_LIST so the data isn't
+ * loaded on the agent fetch hot path.
+ */
+export function useVirtualMCPsLastUsed(ids: string[]) {
+  const { org } = useProjectContext();
+  const client = useMCPClient({
+    connectionId: SELF_MCP_ALIAS_ID,
+    orgId: org.id,
+    orgSlug: org.slug,
+  });
+  const sortedIds = [...ids].sort();
+
+  return useQuery<Map<string, VirtualMCPLastUsed>>({
+    queryKey: KEYS.virtualMcpLastUsed(org.id, sortedIds),
+    enabled: sortedIds.length > 0,
+    staleTime: 30_000,
+    queryFn: async () => {
+      const result = (await client.callTool({
+        name: "VIRTUAL_MCP_LAST_USED_LIST",
+        arguments: { ids: sortedIds },
+      })) as CallToolResult;
+      const payload = (result.structuredContent ?? { items: [] }) as {
+        items: VirtualMCPLastUsed[];
+      };
+      const map = new Map<string, VirtualMCPLastUsed>();
+      for (const item of payload.items) map.set(item.id, item);
+      return map;
+    },
+  });
+}
+
 /**
  * Hook to get virtual MCP mutation actions (create, update, delete)
  *
@@ -85,6 +148,7 @@ export function useVirtualMCPActions() {
   const client = useMCPClient({
     connectionId: SELF_MCP_ALIAS_ID,
     orgId: org.id,
+    orgSlug: org.slug,
   });
 
   return useCollectionActions<VirtualMCPEntity>(org.id, "VIRTUAL_MCP", client);

package/src/index.ts

@@ -2,11 +2,15 @@
 export {
   ProjectContextProvider,
   useProjectContext,
+  useOrg,
+  useCurrentProject,
   Locator,
-  ORG_ADMIN_PROJECT_SLUG,
   type ProjectContextProviderProps,
   type ProjectLocator,
   type LocatorStructured,
+  type OrganizationData,
+  type ProjectData,
+  type ProjectUI,
 } from "./context";
 
 // Hooks
@@ -15,9 +19,14 @@ export {
   useCollectionItem,
   useCollectionList,
   useCollectionActions,
+  buildWhereExpression,
+  buildOrderByExpression,
+  buildCollectionQueryKey,
+  EMPTY_COLLECTION_LIST_RESULT,
   type CollectionEntity,
   type CollectionFilter,
   type UseCollectionListOptions,
+  type CollectionQueryKey,
   // Connection hooks
   useConnections,
   useConnection,
@@ -27,8 +36,10 @@ export {
   // MCP client hook and factory
   createMCPClient,
   useMCPClient,
+  useMCPClientOptional,
   type CreateMcpClientOptions,
   type UseMcpClientOptions,
+  type UseMcpClientOptionalOptions,
   // MCP tools hooks
   useMCPToolsList,
   useMCPToolsListQuery,
@@ -61,13 +72,27 @@ export {
   // Virtual MCP hooks
   useVirtualMCPs,
   useVirtualMCP,
+  virtualMcpItemQueryOptions,
   useVirtualMCPActions,
+  useVirtualMCPsLastUsed,
   type VirtualMCPFilter,
   type UseVirtualMCPsOptions,
+  type VirtualMCPLastUsed,
 } from "./hooks";
 
 // Types
 export {
+  // AI Provider types
+  PROVIDER_IDS,
+  MODEL_CAPABILITIES,
+  type ProviderId,
+  type ModelCapability,
+  type AiProviderModel,
+  type AiProviderModelLimits,
+  type AiProviderModelCosts,
+  type AiProviderKey,
+  type AiProviderInfo,
+  // Connection types
   ConnectionEntitySchema,
   ConnectionCreateDataSchema,
   ConnectionUpdateDataSchema,
@@ -86,24 +111,87 @@ export {
   VirtualMCPEntitySchema,
   VirtualMCPCreateDataSchema,
   VirtualMCPUpdateDataSchema,
+  VirtualMcpUILayoutSchema,
+  VirtualMcpUILayoutTabSchema,
   type VirtualMCPEntity,
   type VirtualMCPCreateData,
   type VirtualMCPUpdateData,
   type VirtualMCPConnection,
-  type ToolSelectionMode,
+  type VirtualMcpUILayout,
+  type VirtualMcpUILayoutTab,
+  type VirtualMcpHomeTile,
+  getHomeTiles,
+  SandboxMapSchema,
+  type SandboxMap,
+  SandboxRecordSchema,
+  type SandboxRecord,
+  type RuntimeMetadata,
+  type RuntimeEnvEntry,
+  ENV_VAR_KEY_RE,
+  parseSandboxRecord,
+  parseBranchMap,
+  normalizeSandboxMap,
+  type SandboxProviderKind,
+  type GithubRepo,
+  // Decopilot event types
+  THREAD_STATUSES,
+  THREAD_DISPLAY_STATUSES,
+  DECOPILOT_EVENTS,
+  ALL_DECOPILOT_EVENT_TYPES,
+  createDecopilotStepEvent,
+  createDecopilotFinishEvent,
+  createDecopilotThreadStatusEvent,
+  type ThreadStatus,
+  type ThreadDisplayStatus,
+  type DecopilotEventType,
+  type DecopilotStepEvent,
+  type DecopilotFinishEvent,
+  type DecopilotThreadStatusEvent,
+  type DecopilotSSEEvent,
+  type DecopilotEventMap,
 } from "./types";
 
 // Streamable HTTP transport
 export { StreamableHTTPClientTransport } from "./lib/streamable-http-client-transport";
 
+// Bridge transport
+export {
+  createBridgeTransportPair,
+  BridgeClientTransport,
+  BridgeServerTransport,
+  type BridgeTransportPair,
+} from "./lib/bridge-transport";
+
+// Server-client bridge
+export {
+  createServerFromClient,
+  type ServerFromClientOptions,
+} from "./lib/server-client-bridge";
+
 // Query keys
 export { KEYS } from "./lib/query-keys";
 
+// Default model selection
+export {
+  DEFAULT_MODEL_PREFERENCES,
+  FAST_MODEL_PREFERENCES,
+  SMART_MODEL_PREFERENCES,
+  THINKING_MODEL_PREFERENCES,
+  IMAGE_MODEL_PREFERENCES,
+  WEB_RESEARCH_MODEL_PREFERENCES,
+  selectDefaultModel,
+  getFastModel,
+  pickSimpleModeDefaults,
+  type SimpleModeModelSlot,
+  type SimpleModeDefaults,
+} from "./lib/default-model";
+
 // MCP OAuth utilities
 export {
   authenticateMcp,
   handleOAuthCallback,
   isConnectionAuthenticated,
+  setOAuthRedirectOrigin,
   type McpOAuthProviderOptions,
   type OAuthTokenInfo,
   type AuthenticateMcpResult,
@@ -111,18 +199,45 @@ export {
   type OAuthWindowMode,
 } from "./lib/mcp-oauth";
 
+// Usage utilities
+export {
+  getCostFromUsage,
+  emptyUsageStats,
+  addUsage,
+  calculateUsageStats,
+  sanitizeProviderMetadata,
+  type UsageData,
+  type UsageStats,
+} from "./lib/usage";
+
 // Constants and well-known MCP definitions
 export {
   // Frontend self MCP ID
   SELF_MCP_ALIAS_ID,
+  // Frontend dev-assets MCP ID
+  DEV_ASSETS_MCP_ALIAS_ID,
   // Org-scoped MCP ID generators
   WellKnownOrgMCPId,
   // Connection factory functions
   getWellKnownRegistryConnection,
   getWellKnownCommunityRegistryConnection,
   getWellKnownSelfConnection,
-  getWellKnownOpenRouterConnection,
+  getWellKnownDevAssetsConnection,
   getWellKnownMcpStudioConnection,
   // Virtual MCP factory functions
-  getWellKnownDecopilotAgent,
+  getWellKnownDecopilotVirtualMCP,
+  getWellKnownDecopilotConnection,
+  // Decopilot utilities
+  isDecopilot,
+  getDecopilotId,
+  // Site Diagnostics utilities
+  isSiteDiagnostics,
+  getSiteDiagnosticsId,
+  // Brand-Context Setup utilities
+  isBrandContextSetup,
+  getBrandContextSetupId,
+  getWellKnownBrandContextSetupVirtualMCP,
+  // Studio Pack utilities
+  StudioPackAgentId,
+  isStudioPackAgent,
 } from "./lib/constants";