Method executeRegisteredTool

src/main/api/plugin/tools.ts:197–221

* 在插件上下文中执行已注册的工具处理器。

(
    webContents: WebContents,
    toolName: string,
    input: unknown
  )

   * 在插件上下文中执行已注册的工具处理器。
   */
  public async executeRegisteredTool(
    webContents: WebContents,
    toolName: string,
    input: unknown
  ): Promise<unknown> {
    const declaredTools = this.getDeclaredToolsByWebContents(webContents)
    if (!declaredTools?.[toolName]) {
      throw new Error(`工具 "${toolName}" 未在 plugin.json 中声明`)
    }
    if (!this.isToolRegistered(webContents, toolName)) {
      throw new Error(`工具 "${toolName}" 尚未通过 ztools.registerTool 注册`)
    }

    return await webContents.executeJavaScript(`
      (async () => {
        if (!window.ztools || typeof window.ztools.__invokeRegisteredTool !== 'function') {
          throw new Error('插件运行时缺少工具调用入口')
        }
        return await window.ztools.__invokeRegisteredTool(
          ${JSON.stringify(toolName)},
          ${JSON.stringify(input ?? {})}
        )
      })()
    `)
  }

  /**
   * 记录插件工具注册结果，并唤醒等待该工具可用的调用方。