@larkup/cli 0.2.28 → 0.2.30

package/dist/chunk-YUC4VMEE.js

@@ -0,0 +1,776 @@
+// ../../packages/marketplace/src/tool-registry.ts
+import { promises as fs } from "fs";
+import path from "path";
+
+// ../../packages/marketplace/src/types.ts
+var DEFAULT_HUB_URL = process.env.LARKUP_HUB_URL ?? "https://hub.larkup.de";
+var STORAGE_WARNING_THRESHOLDS = [
+  1 * 1024 * 1024 * 1024,
+  // 1 GB
+  5 * 1024 * 1024 * 1024,
+  // 5 GB
+  10 * 1024 * 1024 * 1024
+  // 10 GB
+];
+
+// ../../packages/marketplace/src/db/builtin-tools.ts
+var BUILTIN_TOOLS = [
+  {
+    manifestVersion: "3.0",
+    kind: "tool",
+    id: "video-intelligence",
+    name: "Video Intelligence",
+    description: "Help your AI understand your videos, so you can ask questions and get answers from the right moments.",
+    longDescription: "Turn videos into knowledge your AI can understand. It listens to what is said, reads what appears on screen, and helps you find the moments that matter.",
+    category: "media",
+    version: "0.2.2",
+    pricing: "free",
+    emoji: "\u{1F3AC}",
+    icon: "Film",
+    packageName: "@larkup/tool-video-intelligence",
+    installSize: "~120 KB",
+    requiresSandbox: false,
+    author: "Larkup",
+    capabilities: [
+      "video-indexing",
+      "video-indexing-brief",
+      "agentic-video-indexing",
+      "cloud-video-runtime",
+      "timestamped-transcription",
+      "ocr",
+      "object-detection",
+      "anonymous-object-tracking",
+      "usage-metering"
+    ],
+    entrypoints: { server: ".", agent: ".", ui: "./ui" },
+    runtime: {
+      protocolVersion: "1",
+      defaultMode: "managed-cloud",
+      healthPath: "/v1/health",
+      modes: [
+        {
+          id: "managed-cloud",
+          label: "Larkup Cloud",
+          description: "Index with managed private GPU capacity and your Larkup Cloud allowance.",
+          requiresGpu: true
+        },
+        {
+          id: "local",
+          label: "Local runtime",
+          icon: "/docker.png",
+          description: "Run the application locally on your computer.",
+          endpointConfigKey: "localRuntimeUrl",
+          credentialConfigKey: "localRuntimeApiKey",
+          image: "ghcr.io/larkup-ai/video-intelligence:0.1.0",
+          composeFile: "compose.yaml",
+          setupNotice: "The local application and its models download to this computer. The initial download can be large."
+        },
+        {
+          id: "custom-remote",
+          label: "Custom runtime",
+          description: "Connect a compatible Video Intelligence deployment you operate.",
+          endpointConfigKey: "customRuntimeUrl",
+          credentialConfigKey: "customRuntimeApiKey",
+          requiresGpu: true
+        }
+      ]
+    },
+    billing: {
+      model: "hybrid",
+      entitlementVersion: "1",
+      meters: [
+        { id: "source-minute", unit: "minute", description: "Minutes of source video." },
+        {
+          id: "thorough-inspection-minute",
+          unit: "minute",
+          description: "Minutes inspected with Thorough agent coverage."
+        },
+        { id: "gpu-second", unit: "second", description: "GPU worker seconds." },
+        { id: "ocr-frame", unit: "frame", description: "Frames processed by OCR." }
+      ]
+    },
+    usage: {
+      label: "Usage this month",
+      visibleWhenRuntimeMode: ["managed-cloud"],
+      visualization: { usedKey: "sourceMinutesUsed", limitKey: "sourceMinutesLimit" },
+      support: {
+        contactLabel: "Request more usage",
+        description: "Each installation receives Cloud access automatically. Request more video-processing usage when your allowance is low.",
+        userIdConfigKey: "cloudInstallationId"
+      },
+      fields: [
+        { key: "sourceMinutesUsed", label: "Used", format: "minutes" },
+        { key: "sourceMinutesLimit", label: "Included", format: "minutes" },
+        { key: "activeJobs", label: "Active jobs", format: "number" }
+      ]
+    },
+    ui: {
+      isolation: "sandboxed-iframe",
+      surfaces: [
+        {
+          id: "video-indexing-brief",
+          slot: "data-indexing",
+          title: "Let your AI understand this video",
+          entrypoint: "./ui",
+          appliesTo: ["video"],
+          description: "Choose how deeply to analyze it and optionally point it to what matters most.",
+          estimate: {
+            modeField: "indexingMode",
+            variants: [
+              {
+                value: "fast",
+                analyzedFramesPerSourceMinute: 5,
+                ocrFramesPerSourceMinute: 3,
+                processingSecondsPerSourceMinute: 8,
+                maxProcessingSecondsPerSourceMinute: 15,
+                fixedOverheadSeconds: 90,
+                maxFixedOverheadSeconds: 180,
+                creditsPerSourceMinute: 1
+              },
+              {
+                value: "balanced",
+                analyzedFramesPerSourceMinute: 12,
+                ocrFramesPerSourceMinute: 8,
+                processingSecondsPerSourceMinute: 16,
+                maxProcessingSecondsPerSourceMinute: 30,
+                fixedOverheadSeconds: 120,
+                maxFixedOverheadSeconds: 240,
+                creditsPerSourceMinute: 2
+              },
+              {
+                value: "thorough",
+                analyzedFramesPerSourceMinute: 30,
+                ocrFramesPerSourceMinute: 20,
+                processingSecondsPerSourceMinute: 32,
+                maxProcessingSecondsPerSourceMinute: 60,
+                fixedOverheadSeconds: 180,
+                maxFixedOverheadSeconds: 360,
+                creditsPerSourceMinute: 4
+              }
+            ]
+          },
+          form: {
+            submitLabel: "Start indexing",
+            fields: [
+              {
+                key: "goal",
+                type: "textarea",
+                label: "What should your AI look for? (optional)",
+                placeholder: "For example: find the final score, the moment the package is dropped, or every mention of pricing."
+              },
+              {
+                key: "indexingMode",
+                type: "select",
+                label: "Coverage",
+                defaultValue: "balanced",
+                options: [
+                  {
+                    label: "Fast",
+                    value: "fast",
+                    description: "Sample key frames for a quick overview.",
+                    setValues: { processingAuthorityConfirmed: false }
+                  },
+                  {
+                    label: "Balanced",
+                    value: "balanced",
+                    description: "Sample visual and OCR evidence across the video.",
+                    setValues: { processingAuthorityConfirmed: false }
+                  },
+                  {
+                    label: "Thorough",
+                    value: "thorough",
+                    description: "Let the agent inspect denser evidence around subtle or infrequent details.",
+                    setValues: { processingAuthorityConfirmed: false }
+                  }
+                ]
+              }
+            ]
+          }
+        },
+        {
+          id: "video-evidence-result",
+          slot: "chat-result",
+          title: "Video evidence",
+          entrypoint: "./ui"
+        }
+      ]
+    },
+    tags: ["video", "ocr", "tracking", "local", "gpu", "private", "gdpr"],
+    downloads: 0,
+    repositoryUrl: "https://github.com/Larkup-AI/larkup",
+    license: "Apache-2.0",
+    updatedAt: "2026-08-20",
+    trustLevel: "elevated",
+    permissions: {
+      fsRead: true,
+      fsWrite: true,
+      exec: true,
+      httpAllow: ["127.0.0.1", "localhost", "video.larkup.de"]
+    },
+    configSchema: [
+      {
+        key: "runtimeMode",
+        label: "Runtime",
+        type: "select",
+        group: "Runtime",
+        defaultValue: "managed-cloud",
+        help: "Choose managed Larkup Cloud, a local runtime that auto-selects Docker or native, or your compatible deployment.",
+        options: [
+          {
+            label: "Larkup Cloud",
+            value: "managed-cloud",
+            icon: "/logo.png",
+            description: "Managed GPU capacity and automatic device access."
+          },
+          {
+            label: "Local runtime",
+            value: "local",
+            icon: "/docker.png",
+            description: "Run the application locally on your computer."
+          },
+          {
+            label: "Custom runtime",
+            value: "custom-remote",
+            icon: "/icons/cloudflare.png",
+            description: "Use your deployment URL and key."
+          }
+        ]
+      },
+      {
+        key: "localRuntimeUrl",
+        label: "Local runtime URL",
+        type: "text",
+        group: "Local runtime",
+        defaultValue: "http://127.0.0.1:8787",
+        help: "Use a LAN address to share the runtime with trusted users.",
+        verification: {
+          endpoint: "/api/tools/video-intelligence/verify",
+          method: "POST",
+          fields: {
+            localRuntimeUrl: "localRuntimeUrl",
+            localRuntimeApiKey: "localRuntimeApiKey",
+            runtimeMode: "runtimeMode"
+          }
+        },
+        visibleWhen: { field: "runtimeMode", equals: "local" }
+      },
+      {
+        key: "localRuntimeApiKey",
+        label: "Shared local API key",
+        type: "password",
+        group: "Local runtime",
+        help: "Optional bearer key when local runtime authentication is enabled.",
+        visibleWhen: { field: "runtimeMode", equals: "local" }
+      },
+      {
+        key: "videoVisionProvider",
+        label: "Vision provider",
+        type: "select",
+        group: "Video understanding",
+        defaultValue: "vercel_ai_gateway",
+        defaultFromGlobalConfigKey: "visionProvider",
+        help: "Defaults to your saved AI Models vision provider. Choose another provider here only for this tool.",
+        options: [
+          {
+            label: "Use AI Models",
+            value: "auto",
+            description: "Follow the workspace Vision Model setting."
+          },
+          { label: "Google Gemini", value: "google", icon: "/icons/gemini.svg" },
+          {
+            label: "Vercel AI Gateway",
+            value: "vercel_ai_gateway",
+            icon: "/icons/vercel.svg"
+          },
+          { label: "OpenAI", value: "openai", icon: "/icons/openai.svg" }
+        ]
+      },
+      {
+        key: "videoVisionApiKey",
+        label: "Vision provider API key",
+        type: "password",
+        group: "Video understanding",
+        help: "Optional tool override. Leave empty to use the matching provider key from AI Models; it is forwarded only for the active job."
+      },
+      {
+        key: "semanticVisionModel",
+        label: "Video vision model",
+        type: "select",
+        group: "Video understanding",
+        defaultValue: "google/gemini-3.6-flash",
+        defaultFromGlobalConfigKey: "visionModelId",
+        providerField: "videoVisionProvider",
+        defaultValueByProvider: {
+          auto: "auto",
+          google: "google/gemini-3.6-flash",
+          vercel_ai_gateway: "google/gemini-3.6-flash",
+          openai: "openai/gpt-4o-mini"
+        },
+        help: "Defaults to the Vision Model in AI Models. Choose another video-capable model to override it only for this tool.",
+        verification: {
+          endpoint: "/api/tools/video-intelligence/verify",
+          method: "POST",
+          fields: {
+            videoVisionProvider: "videoVisionProvider",
+            videoVisionApiKey: "videoVisionApiKey",
+            semanticVisionModel: "semanticVisionModel"
+          }
+        },
+        options: [
+          {
+            label: "Use AI Models",
+            value: "auto",
+            description: "Follow the workspace Vision Model setting."
+          },
+          {
+            label: "Gemini 3.6 Flash",
+            value: "google/gemini-3.6-flash",
+            icon: "/icons/gemini.svg"
+          },
+          {
+            label: "Gemini 3.5 Flash",
+            value: "google/gemini-3.5-flash",
+            icon: "/icons/gemini.svg"
+          },
+          {
+            label: "GPT-4o mini",
+            value: "openai/gpt-4o-mini",
+            icon: "/icons/openai.svg"
+          }
+        ]
+      },
+      {
+        key: "videoAgentProvider",
+        label: "Agent provider",
+        type: "select",
+        group: "Agent planning",
+        defaultValue: "vercel_ai_gateway",
+        defaultFromGlobalConfigKey: "chatProvider",
+        help: "Defaults to your saved AI Models chat provider. Choose another provider here only for this tool.",
+        options: [
+          {
+            label: "Use AI Models",
+            value: "auto",
+            description: "Follow the workspace Chat Model setting."
+          },
+          { label: "Google Gemini", value: "google", icon: "/icons/gemini.svg" },
+          {
+            label: "Vercel AI Gateway",
+            value: "vercel_ai_gateway",
+            icon: "/icons/vercel.svg"
+          },
+          { label: "OpenAI", value: "openai", icon: "/icons/openai.svg" },
+          {
+            label: "DeepSeek",
+            value: "deepseek",
+            icon: "https://models.dev/logos/deepseek.svg"
+          },
+          {
+            label: "Anthropic",
+            value: "anthropic",
+            icon: "https://models.dev/logos/anthropic.svg"
+          },
+          {
+            label: "Mistral",
+            value: "mistral",
+            icon: "https://models.dev/logos/mistral.svg"
+          },
+          {
+            label: "Cohere",
+            value: "cohere",
+            icon: "https://models.dev/logos/cohere.svg"
+          }
+        ]
+      },
+      {
+        key: "videoAgentApiKey",
+        label: "Agent provider API key",
+        type: "password",
+        group: "Agent planning",
+        help: "Optional tool override. Leave empty to use the matching chat-provider key from AI Models; it is forwarded only for the active job."
+      },
+      {
+        key: "agentModel",
+        label: "Agent / tool-brain model",
+        type: "select",
+        group: "Agent planning",
+        defaultValue: "openai/gpt-5-mini",
+        defaultFromGlobalConfigKey: "chatModelId",
+        providerField: "videoAgentProvider",
+        defaultValueByProvider: {
+          auto: "auto",
+          google: "google/gemini-3.5-flash-lite",
+          vercel_ai_gateway: "openai/gpt-5-mini",
+          openai: "openai/gpt-5-mini",
+          deepseek: "deepseek/deepseek-v3.2",
+          anthropic: "anthropic/claude-sonnet-4",
+          mistral: "mistral/mistral-large-3",
+          cohere: "cohere/command-a"
+        },
+        help: "Defaults to the Chat Model in AI Models. Choose another model to override it only for video planning and synthesis.",
+        verification: {
+          endpoint: "/api/tools/video-intelligence/verify",
+          method: "POST",
+          fields: {
+            videoAgentProvider: "videoAgentProvider",
+            videoAgentApiKey: "videoAgentApiKey",
+            agentModel: "agentModel"
+          }
+        },
+        options: [
+          {
+            label: "Use AI Models",
+            value: "auto",
+            description: "Follow the workspace Chat Model setting."
+          },
+          {
+            label: "Gemini 3.5 Flash Lite",
+            value: "google/gemini-3.5-flash-lite",
+            icon: "/icons/gemini.svg"
+          },
+          {
+            label: "Gemini 3.6 Flash",
+            value: "google/gemini-3.6-flash",
+            icon: "/icons/gemini.svg"
+          },
+          { label: "GPT-5 mini", value: "openai/gpt-5-mini", icon: "/icons/openai.svg" },
+          { label: "GPT-5.2", value: "openai/gpt-5.2", icon: "/icons/openai.svg" },
+          {
+            label: "DeepSeek V3.2",
+            value: "deepseek/deepseek-v3.2",
+            icon: "https://models.dev/logos/deepseek.svg"
+          },
+          {
+            label: "DeepSeek V4 Pro",
+            value: "deepseek/deepseek-v4-pro",
+            icon: "https://models.dev/logos/deepseek.svg"
+          },
+          {
+            label: "Claude Sonnet 4",
+            value: "anthropic/claude-sonnet-4",
+            icon: "https://models.dev/logos/anthropic.svg"
+          },
+          {
+            label: "Mistral Large 3",
+            value: "mistral/mistral-large-3",
+            icon: "https://models.dev/logos/mistral.svg"
+          },
+          {
+            label: "Command A",
+            value: "cohere/command-a",
+            icon: "https://models.dev/logos/cohere.svg"
+          }
+        ]
+      },
+      {
+        key: "customRuntimeUrl",
+        label: "Custom runtime URL",
+        type: "text",
+        group: "Custom runtime",
+        required: true,
+        verification: {
+          endpoint: "/api/tools/video-intelligence/verify",
+          method: "POST",
+          fields: {
+            customRuntimeUrl: "customRuntimeUrl",
+            customRuntimeApiKey: "customRuntimeApiKey",
+            runtimeMode: "runtimeMode"
+          }
+        },
+        visibleWhen: { field: "runtimeMode", equals: "custom-remote" }
+      },
+      {
+        key: "customRuntimeApiKey",
+        label: "Custom runtime API key",
+        type: "password",
+        group: "Custom runtime",
+        required: true,
+        visibleWhen: { field: "runtimeMode", equals: "custom-remote" }
+      },
+      {
+        key: "audioProvider",
+        label: "Audio provider",
+        type: "select",
+        group: "Audio",
+        defaultValue: "deepgram",
+        help: "Required for every runtime. Transcription is billed directly to your selected provider; Larkup Cloud does not supply audio-model credits.",
+        options: [
+          {
+            label: "OpenAI",
+            value: "openai",
+            icon: "/icons/openai.svg",
+            description: "Use your OpenAI transcription allowance."
+          },
+          {
+            label: "Groq",
+            value: "groq",
+            icon: "https://models.dev/logos/groq.svg",
+            description: "Fast hosted Whisper inference."
+          },
+          {
+            label: "Deepgram",
+            value: "deepgram",
+            icon: "/icons/deepgram.png",
+            description: "Speech-to-text with language features."
+          },
+          {
+            label: "ElevenLabs",
+            value: "elevenlabs",
+            icon: "/icons/elevenlabs.png",
+            description: "Use your ElevenLabs speech-to-text account."
+          }
+        ]
+      },
+      {
+        key: "audioApiKey",
+        label: "Audio provider API key",
+        type: "password",
+        group: "Audio",
+        help: "Required. It stays in this installation and is forwarded only for the active video job.",
+        verification: {
+          endpoint: "/api/tools/video-intelligence/verify",
+          method: "POST",
+          fields: {
+            audioProvider: "audioProvider",
+            audioApiKey: "audioApiKey"
+          }
+        },
+        visibleWhen: {
+          field: "audioProvider",
+          equals: ["openai", "groq", "deepgram", "elevenlabs"]
+        }
+      },
+      {
+        key: "cloudAccessKey",
+        label: "Larkup Cloud API key",
+        type: "password",
+        group: "Managed cloud connection",
+        help: "Paste the key Larkup provides for managed cloud access. Leave this empty only when automatic project provisioning is enabled.",
+        visibleWhen: { field: "runtimeMode", equals: "managed-cloud" }
+      },
+      {
+        key: "defaultIndexingMode",
+        label: "Default indexing mode",
+        type: "select",
+        group: "Indexing",
+        defaultValue: "balanced",
+        options: [
+          { label: "Fast", value: "fast" },
+          { label: "Balanced", value: "balanced" },
+          { label: "Thorough", value: "thorough" }
+        ]
+      },
+      {
+        key: "cloudInstallationId",
+        label: "Managed cloud installation ID",
+        type: "text",
+        group: "Managed cloud connection",
+        help: "Provisioned automatically for this project.",
+        serverManaged: true
+      }
+    ]
+  },
+  {
+    id: "clip-embeddings",
+    name: "CLIP Image Search",
+    description: "Direct image-to-image similarity search using CLIP/SigLIP embeddings.",
+    longDescription: "Enable native visual similarity search by embedding images with CLIP or SigLIP models. Search your image library by uploading a query image or describing what you're looking for. Requires downloading a ~200MB model on first use.",
+    category: "embedding",
+    version: "0.1.0",
+    pricing: "free",
+    emoji: "\u{1F50D}",
+    icon: "ScanEye",
+    packageName: "@larkup/tool-clip-embeddings",
+    installSize: "~200 MB",
+    author: "Larkup",
+    capabilities: ["clip-embeddings", "image-similarity"],
+    tags: ["clip", "siglip", "image-search", "visual-similarity"],
+    repositoryUrl: "https://github.com/Larkup-AI/larkup",
+    license: "Apache-2.0",
+    updatedAt: "2026-07-20",
+    comingSoon: true
+  },
+  {
+    id: "doc-editor",
+    name: "Document Editor",
+    description: "AI-powered form filling and document editing with Canvas-style live preview.",
+    longDescription: "Open PDF, Word, PowerPoint, and text files in a split-view Canvas. AI fills forms using your knowledge base, edits content on request, and previews changes live. Supports PDF form fields (AcroForm), DOCX paragraphs/tables, PPTX slide text, and plain text editing. Uses pdf-lib (native) for PDF and the Docker sandbox for DOCX/PPTX via python-docx/python-pptx.",
+    category: "utility",
+    version: "0.2.3",
+    pricing: "free",
+    emoji: "\u{1F4DD}",
+    icon: "FileEdit",
+    packageName: "@larkup/tool-doc-editor",
+    installSize: "~5 MB",
+    systemDeps: ["docker"],
+    requiresSandbox: true,
+    author: "Larkup",
+    capabilities: ["document-editing", "form-filling", "document-preview"],
+    tags: ["pdf", "docx", "pptx", "form", "canvas", "editor", "fill"],
+    repositoryUrl: "https://github.com/Larkup-AI/larkup",
+    license: "Apache-2.0",
+    updatedAt: "2026-07-20"
+  }
+];
+
+// ../../packages/marketplace/src/tool-registry.ts
+var cachedRegistry = null;
+var RETIRED_CATALOG_TOOL_IDS = /* @__PURE__ */ new Set(["video-audio"]);
+function normalizeToolDescriptor(descriptor) {
+  return { ...descriptor, requiresSandbox: descriptor.requiresSandbox !== false };
+}
+function compareToolVersions(left, right) {
+  const parse = (version) => {
+    const [core, suffix = ""] = version.split("-", 2);
+    const parts = core.split(".").map((part) => Number.parseInt(part, 10) || 0);
+    return { parts, stable: suffix.length === 0 };
+  };
+  const a = parse(left);
+  const b = parse(right);
+  const length = Math.max(a.parts.length, b.parts.length);
+  for (let index = 0; index < length; index += 1) {
+    const difference = (a.parts[index] ?? 0) - (b.parts[index] ?? 0);
+    if (difference !== 0) return difference;
+  }
+  if (a.stable === b.stable) return 0;
+  return a.stable ? 1 : -1;
+}
+function mergeToolDescriptors(current, incoming) {
+  const merged = { ...current };
+  for (const [id, descriptor] of Object.entries(incoming)) {
+    const existing = merged[id];
+    if (!existing || compareToolVersions(descriptor.version, existing.version) >= 0) {
+      merged[id] = descriptor;
+    }
+  }
+  return merged;
+}
+async function discoverLocalManifests() {
+  const registry = {};
+  const persistentDataDir = process.env.LARKUP_DATA_DIR?.trim();
+  const searchPaths = [
+    // Monorepo development: packages/marketplace-tools/*
+    path.resolve(process.cwd(), "packages", "marketplace-tools"),
+    // Next.js dev server runs in apps/web
+    path.resolve(process.cwd(), "..", "..", "packages", "marketplace-tools"),
+    // Installed tools: .larkup/tools/node_modules/@larkup
+    ...persistentDataDir ? [path.resolve(persistentDataDir, "tools", "node_modules", "@larkup")] : [],
+    path.resolve(process.cwd(), ".larkup", "tools", "node_modules", "@larkup"),
+    path.resolve(process.cwd(), "..", "..", ".larkup", "tools", "node_modules", "@larkup")
+  ];
+  for (const searchPath of searchPaths) {
+    try {
+      const entries = await fs.readdir(searchPath, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+        const manifestPath = path.join(searchPath, entry.name, "tool.manifest.json");
+        try {
+          const raw = await fs.readFile(manifestPath, "utf8");
+          const manifest = normalizeToolDescriptor(JSON.parse(raw));
+          if (manifest.id && !RETIRED_CATALOG_TOOL_IDS.has(manifest.id)) {
+            registry[manifest.id] = manifest;
+          }
+        } catch {
+        }
+      }
+    } catch {
+    }
+  }
+  return registry;
+}
+async function fetchHubCatalog(hubUrl) {
+  const baseUrl = hubUrl ?? DEFAULT_HUB_URL;
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5e3);
+    const res = await fetch(`${baseUrl}/v1/tools`, {
+      signal: controller.signal,
+      headers: { Accept: "application/json" }
+    });
+    clearTimeout(timeout);
+    if (!res.ok) return {};
+    const data = await res.json();
+    const registry = {};
+    for (const tool of data.tools ?? []) {
+      if (tool.id && !RETIRED_CATALOG_TOOL_IDS.has(tool.id)) {
+        registry[tool.id] = normalizeToolDescriptor(tool);
+      }
+    }
+    return registry;
+  } catch {
+    return {};
+  }
+}
+async function fetchToolFromHub(toolId, hubUrl) {
+  if (RETIRED_CATALOG_TOOL_IDS.has(toolId)) return null;
+  const baseUrl = hubUrl ?? DEFAULT_HUB_URL;
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5e3);
+    const res = await fetch(`${baseUrl}/v1/tools/${toolId}`, {
+      signal: controller.signal,
+      headers: { Accept: "application/json" }
+    });
+    clearTimeout(timeout);
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data.tool ?? null;
+  } catch {
+    return null;
+  }
+}
+var FALLBACK_REGISTRY = Object.fromEntries(
+  BUILTIN_TOOLS.map((tool) => {
+    const descriptor = normalizeToolDescriptor(tool);
+    return [descriptor.id, descriptor];
+  })
+);
+async function buildRegistry(opts) {
+  if (cachedRegistry) return cachedRegistry;
+  let registry = { ...FALLBACK_REGISTRY };
+  let hubAvailable = false;
+  if (!opts?.skipHub) {
+    const hubCatalog = await fetchHubCatalog(opts?.hubUrl);
+    if (Object.keys(hubCatalog).length > 0) {
+      registry = mergeToolDescriptors(registry, hubCatalog);
+      hubAvailable = true;
+    }
+  }
+  if (!hubAvailable || opts?.preferLocal) {
+    const localManifests = await discoverLocalManifests();
+    registry = mergeToolDescriptors(registry, localManifests);
+  }
+  cachedRegistry = registry;
+  return registry;
+}
+function invalidateRegistryCache() {
+  cachedRegistry = null;
+}
+async function getAllTools() {
+  const registry = await buildRegistry();
+  return Object.values(registry).sort((a, b) => a.name.localeCompare(b.name));
+}
+async function getToolById(id) {
+  const registry = await buildRegistry();
+  return registry[id];
+}
+async function getToolsWithCapability(capability) {
+  const all = await getAllTools();
+  return all.filter((t) => t.capabilities.includes(capability));
+}
+async function getAllCategories() {
+  const all = await getAllTools();
+  const cats = new Set(all.map((t) => t.category));
+  return Array.from(cats).sort();
+}
+
+export {
+  mergeToolDescriptors,
+  fetchToolFromHub,
+  buildRegistry,
+  invalidateRegistryCache,
+  getAllTools,
+  getToolById,
+  getToolsWithCapability,
+  getAllCategories
+};