Method execute

src/tools/builtin/save-api-key.ts:24–48

(args: z.infer<typeof Args>, _ctx: ToolContext)

  argsSchema = Args;

  async execute(args: z.infer<typeof Args>, _ctx: ToolContext): Promise<ToolResult> {
    const envVar = args.env_var.trim().toUpperCase();
    const value = args.value.trim();
    if (!/^[A-Z][A-Z0-9_]{2,63}$/.test(envVar)) {
      return { content: `[SAVE_KEY_ERROR] "${envVar}" is not a valid environment variable name (A-Z, 0-9, _).`, isError: true };
    }
    if (!value || value.length < 8) {
      return { content: '[SAVE_KEY_ERROR] That does not look like a key (too short). Ask the user to re-paste it.', isError: true };
    }
    if (/\s/.test(value)) {
      return { content: '[SAVE_KEY_ERROR] The value contains whitespace — probably a paste accident. Ask the user to re-paste just the key.', isError: true };
    }

    const { setEnvKey } = await import('../../setup/env-writer.js');
    const file = await setEnvKey(envVar, value);
    process.env[envVar] = value;   // live for THIS session — the blocked task can retry right away

    const { findServiceKey } = await import('../../setup/key-guidance.js');
    const svc = findServiceKey(envVar);
    const unlocked = svc ? ` ${svc.service} is now available — ${svc.unlocks}.` : '';
    return {
      content: `✓ ${envVar} saved to ${file} (chmod 600) and loaded into this session.${unlocked} Retry the blocked step now.`,
      metadata: { envVar, service: svc?.service },
    };
  }
}