Function buildToolCatalogFromManifest

src/runtime/tool-catalog.ts:111–185

(opts: {
  runtime: RuntimeKind;
  ctx: PredicateContext;
  enabledWorkflows?: string[];
  excludeWorkflows?: string[];
})

 * Build a tool catalog from the YAML manifest system.
 */
export async function buildToolCatalogFromManifest(opts: {
  runtime: RuntimeKind;
  ctx: PredicateContext;
  enabledWorkflows?: string[];
  excludeWorkflows?: string[];
}): Promise<ToolCatalog> {
  const manifest = loadManifest();
  const excludeSet = new Set(opts.excludeWorkflows?.map((w) => w.toLowerCase()) ?? []);

  // Get workflows to include
  let workflowsToInclude: WorkflowManifestEntry[];
  if (opts.enabledWorkflows && opts.enabledWorkflows.length > 0) {
    // Use specified workflows
    workflowsToInclude = opts.enabledWorkflows
      .map((id) => manifest.workflows.get(id))
      .filter((wf): wf is WorkflowManifestEntry => wf !== undefined);
  } else {
    // Use all workflows available for the runtime
    workflowsToInclude = Array.from(manifest.workflows.values());
  }

  const filteredWorkflows = workflowsToInclude.filter(
    (wf) =>
      !excludeSet.has(wf.id.toLowerCase()) &&
      isWorkflowAvailableForRuntime(wf, opts.runtime) &&
      isWorkflowEnabledForRuntime(wf, opts.ctx),
  );

  // Cache imported modules to avoid re-importing the same tool
  const moduleCache = new Map<string, Awaited<ReturnType<typeof importToolModule>>>();
  const tools: ToolDefinition[] = [];

  for (const workflow of filteredWorkflows) {
    for (const toolId of workflow.tools) {
      const toolManifest = manifest.tools.get(toolId);
      if (!toolManifest) continue;

      // Check tool availability for runtime
      if (!isToolAvailableForRuntime(toolManifest, opts.runtime)) continue;

      // Check tool predicates
      if (!isToolExposedForRuntime(toolManifest, opts.ctx)) continue;

      // Import the tool module (cached)
      let toolModule = moduleCache.get(toolId);
      if (!toolModule) {
        try {
          toolModule = await importToolModule(toolManifest.module);
          moduleCache.set(toolId, toolModule);
        } catch (err) {
          log('warn', `Failed to import tool module ${toolManifest.module}: ${err}`);
          continue;
        }
      }

      const cliName = getEffectiveCliName(toolManifest);
      tools.push({
        id: toolManifest.id,