Method execute

src/mcp/tool-wrapper.ts:48–102

(args: Record<string, unknown>, ctx: ToolContext)

  }

  async execute(args: Record<string, unknown>, ctx: ToolContext): Promise<ToolResult> {
    if (!this.client.isReady()) {
      return {
        content: `[MCP_UNAVAILABLE] MCP server '${this.client.name}' is not ready (state: ${this.client.status.state}, error: ${this.client.status.error ?? 'none'}). The agent cannot use this tool right now.`,
        isError: true,
      };
    }

    // Permission check (MCP tools go through the same engine as builtins)
    const permReq = {
      tool: this.name,
      operation: this.name,
      description: this.description,
    };
    const decision = ctx.permissions.evaluate(permReq);
    if (decision === 'deny') {
      return { content: `[PERMISSION_DENIED] Blocked by policy: ${this.name}`, isError: true };
    }
    if (decision === 'ask') {
      const summary = this.summarizeArgs(args);
      const answer = await ctx.askUser(
        `Run MCP tool ${this.name}${summary ? `\n  args: ${summary}` : ''}?`,
        ['yes', 'no', 'always'],
      );
      if (answer === 'no') {
        return { content: `[USER_REJECTED] User declined MCP tool ${this.name}`, isError: true };
      }
      if (answer === 'always') {
        ctx.permissions.rememberDecision(permReq, 'allow', 'pattern');
      }
    }

    try {
      const result = await this.client.callTool(this.toolDef.name, args, ctx.signal);
      const text = (result.content ?? [])
        .map(b => {
          if (b.type === 'text') return b.text;
          if (b.type === 'image') return `[image ${b.mimeType}, ${b.data.length} chars base64]`;
          if (b.type === 'resource') return `[resource ${b.resource.uri}${b.resource.text ? `: ${b.resource.text.slice(0, 200)}` : ''}]`;
          return JSON.stringify(b);
        })
        .join('\n');
      return {
        content: text || '[empty result]',
        isError: result.isError === true,
        metadata: { mcpServer: this.client.name, mcpTool: this.toolDef.name },
      };
    } catch (e: any) {
      logger.warn('MCP tool call failed', { tool: this.name, err: e.message });
      return {
        content: `[MCP_ERROR] ${this.name}: ${e.message}`,
        isError: true,
      };
    }
  }

  private summarizeArgs(args: Record<string, unknown>): string {
    const keys = Object.keys(args);