@lazyingart/agintiflow 0.16.1 → 0.16.2

package/README.md

@@ -46,7 +46,7 @@ aginti --list-profiles
 aginti --sandbox-status
 ```
 
-On first interactive use, if no main model key is detected, `aginti` opens an auth wizard. Use Up/Down to choose DeepSeek, OpenAI, or Qwen, paste the key, and press Enter to save it to the project-local ignored file `.aginti/.env` with `0600` permissions. The wizard then offers the optional auxiliary image key; press Esc to skip. You can rerun it even when keys already exist:
+On first interactive use, if no main model key is detected, `aginti` opens an auth wizard. Use Up/Down to choose DeepSeek, OpenAI, or Qwen, paste the key, and press Enter to save it to the project-local ignored file `.aginti/.env` with `0600` permissions. The wizard points to DeepSeek keys at `https://platform.deepseek.com/api_keys` and OpenAI keys at `https://platform.openai.com/api-keys`. It then offers the optional auxiliary image key; press Esc to skip. You can rerun it even when keys already exist:
 
 ```bash
 aginti auth

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lazyingart/agintiflow",
-  "version": "0.16.1",
+  "version": "0.16.2",
   "type": "module",
   "description": "AgInTiFlow is a resumable Playwright website-control agent with OpenAI-compatible tool calling.",
   "license": "Apache-2.0",

package/public/app.js

@@ -25,6 +25,9 @@ const translations = {
       "DeepSeek/OpenAI/Qwen keys are missing. Use mock mode, export an env var, or save a project-local model key.",
     setupEnvHelp:
       "Env vars: DEEPSEEK_API_KEY, OPENAI_API_KEY, QWEN_API_KEY, LLM_API_KEY, and optional GRSAI for image generation. Mock mode remains available for local tests.",
+    setupKeyLinksLabel: "Get keys:",
+    deepseekKeyLink: "DeepSeek API keys",
+    openaiKeyLink: "OpenAI API keys",
     setupProviderLabel: "Provider",
     setupKeyLabel: "API key",
     saveKeyButton: "Save local key",

package/public/index.html

@@ -50,6 +50,12 @@
             <p class="subtle" data-i18n="setupEnvHelp">
               Env vars: DEEPSEEK_API_KEY, OPENAI_API_KEY, QWEN_API_KEY, or LLM_API_KEY. Mock mode remains available for local tests.
             </p>
+            <p class="subtle key-links">
+              <span data-i18n="setupKeyLinksLabel">Get keys:</span>
+              <a href="https://platform.deepseek.com/api_keys" target="_blank" rel="noreferrer" data-i18n="deepseekKeyLink">DeepSeek API keys</a>
+              <span aria-hidden="true">·</span>
+              <a href="https://platform.openai.com/api-keys" target="_blank" rel="noreferrer" data-i18n="openaiKeyLink">OpenAI API keys</a>
+            </p>
           </div>
           <div class="grid">
             <label>

package/public/styles.css

@@ -137,6 +137,23 @@ h1 {
   overflow-wrap: anywhere;
 }
 
+.setup-card .key-links {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  align-items: center;
+}
+
+.setup-card .key-links a {
+  color: #075985;
+  font-weight: 750;
+  text-decoration: none;
+}
+
+.setup-card .key-links a:hover {
+  text-decoration: underline;
+}
+
 .setup-card[hidden] {
   display: none;
 }

package/scripts/smoke-auth.js

@@ -4,7 +4,7 @@ import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { normalizeAuthProvider } from "../src/auth-onboarding.js";
+import { authProviderKeyHelp, authProviderKeyUrl, normalizeAuthProvider } from "../src/auth-onboarding.js";
 import { getProviderDefaults } from "../src/model-routing.js";
 import { providerKeyStatus, setProviderKey } from "../src/project.js";
 
@@ -53,6 +53,8 @@ async function runCli(args, stdin = "") {
 try {
   assert(normalizeAuthProvider("auxilliary") === "grsai", "auxilliary alias did not normalize to grsai");
   assert(normalizeAuthProvider("qwen") === "qwen", "qwen provider did not normalize");
+  assert(authProviderKeyUrl("deepseek") === "https://platform.deepseek.com/api_keys", "DeepSeek key URL is missing");
+  assert(authProviderKeyHelp("openai").includes("https://platform.openai.com/api-keys"), "OpenAI key help is missing");
   const qwenDefaults = getProviderDefaults("qwen");
   assert(qwenDefaults.provider === "qwen" && qwenDefaults.model, "qwen provider defaults are not available");
 
@@ -75,7 +77,7 @@ try {
       {
         ok: true,
         projectRoot: tempRoot,
-        checks: ["normalize-auth-provider", "qwen-defaults", "qwen-key-status", "cli-key-status-redacted"],
+        checks: ["normalize-auth-provider", "provider-key-links", "qwen-defaults", "qwen-key-status", "cli-key-status-redacted"],
       },
       null,
       2

package/src/auth-onboarding.js

@@ -10,12 +10,14 @@ export const MAIN_AUTH_PROVIDERS = [
     label: "DeepSeek",
     keyName: "DEEPSEEK_API_KEY",
     description: "default fast/pro route",
+    keyUrl: "https://platform.deepseek.com/api_keys",
   },
   {
     id: "openai",
     label: "OpenAI",
     keyName: "OPENAI_API_KEY",
     description: "OpenAI-compatible fallback",
+    keyUrl: "https://platform.openai.com/api-keys",
   },
   {
     id: "qwen",
@@ -55,6 +57,19 @@ function providerLabel(provider = "") {
   return match?.label || provider;
 }
 
+export function authProviderKeyUrl(provider = "") {
+  const normalized = normalizeAuthProvider(provider, "");
+  const match = [...MAIN_AUTH_PROVIDERS, AUXILIARY_AUTH_PROVIDER].find((item) => item.id === normalized);
+  return match?.keyUrl || "";
+}
+
+export function authProviderKeyHelp(provider = "") {
+  const normalized = normalizeAuthProvider(provider, "");
+  const label = providerLabel(normalized);
+  const url = authProviderKeyUrl(normalized);
+  return url ? `Get ${label} API key: ${url}` : "";
+}
+
 class MutedWritable extends Writable {
   constructor(target) {
     super();
@@ -144,17 +159,21 @@ export async function promptHidden(promptText) {
 }
 
 function renderProviderPicker({ providers, selected, title, status }) {
+  const keyLinks = providers
+    .filter((provider) => provider.keyUrl)
+    .map((provider) => `${provider.label}: ${provider.keyUrl}`);
   const lines = [
     `\n${title}`,
     "Use Up/Down to choose, Enter to confirm, Esc to go back/skip.",
     `Current key status: ${status}`,
+    keyLinks.length ? `API key pages: ${keyLinks.join(" · ")}` : "",
     "",
     ...providers.map((provider, index) => {
       const cursor = index === selected ? ">" : " ";
       return `${cursor} ${provider.label.padEnd(10)} ${provider.keyName.padEnd(16)} ${provider.description}`;
     }),
   ];
-  return lines.join("\n");
+  return lines.filter((line, index) => line || index > 2).join("\n");
 }
 
 export async function chooseAuthProvider({
@@ -295,7 +314,8 @@ export async function runAuthWizard(projectRoot = process.cwd(), options = {}) {
 
   if (mainProvider) {
     const current = status[mainProvider] ? "currently available; paste a new key to replace, or Esc to keep existing" : "missing";
-    const prompt = `${providerLabel(mainProvider)} main API key (${current}) [hidden]: `;
+    const keyHelp = authProviderKeyHelp(mainProvider);
+    const prompt = `${keyHelp ? `${keyHelp}\n` : ""}${providerLabel(mainProvider)} main API key (${current}) [hidden]: `;
     const secret = await promptSecret(prompt, { allowEscape: true });
     if (secret.value) {
       const result = await setProviderKey(projectRoot, mainProvider, secret.value);