myaiforone 1.1.35 → 1.1.37

package/bin/cli.js

@@ -199,12 +199,27 @@ async function runClaudeAuth(version) {
   console.log('');
   console.log('  This will either:');
   console.log('    A) Open a browser window automatically — just sign in and come back');
-  console.log('    B) Show a URL + ask for a code (common on Windows):');
-  console.log('       1. Copy the URL and open it in your browser');
-  console.log('       2. Sign in and approve access');
-  console.log('       3. Copy the short code shown and paste it back here');
+  console.log('    B) Show a URL + code — copy the URL, open it, sign in, paste the code back');
   console.log('');
 
+  if (IS_WINDOWS) {
+    // On Windows, the code-paste prompt can get stuck. Give it 60 seconds —
+    // enough for the browser auto-open flow to complete. If stuck, times out
+    // and setup continues. User can run "claude auth login" later in a fresh terminal.
+    console.log('  (Windows: 60 second time limit — setup will continue automatically if not done)');
+    console.log('');
+    try {
+      execSync('claude auth login', { stdio: 'inherit', timeout: 60_000 });
+      stepDone(`Claude Code CLI ${version} (authenticated)`);
+    } catch {
+      console.log('');
+      console.log('  Authentication did not complete. You can run "claude auth login" in a new terminal later.');
+      console.log('');
+      stepDone('Claude Code CLI (skipped auth — run "claude auth login" later)');
+    }
+    return;
+  }
+
   let authenticated = false;
   while (!authenticated) {
     try {

package/docs/user-guide.md

@@ -241,7 +241,7 @@ Opened by **+ New Agent** button or clicking an agent's Config button. Has 6 sta
 | **Description** | Short description of the agent's purpose. |
 | **Instructions (CLAUDE.md)** | System prompt written to the agent's CLAUDE.md file. Multi-line textarea. |
 | **Agent Class** | Dropdown: Standard, Builder, Platform, Gym. |
-| **Executor** | Dropdown: Platform Default, Claude, Ollama models, or cloud providers — OpenAI, Grok (xAI), Gemini, Groq, Together, Mistral (when multi-model is enabled). Format: `provider:model` (e.g., `openai:gpt-4o`, `gemini:gemini-2.5-flash`, `grok:grok-3`). Overrides the service-level default executor for this agent. |
+| **Executor** | Dropdown: Platform Default, Claude, Ollama models, or cloud providers — OpenAI, Grok (xAI), Gemini, Groq, Together, Mistral, Venice (when multi-model is enabled). Format: `provider:model` (e.g., `openai:gpt-4o`, `gemini:gemini-2.5-flash`, `grok:grok-3`, `venice:llama-3.3-70b`). Overrides the service-level default executor for this agent. |
 
 #### Organization Entries
 Each agent can belong to multiple organizations. Per entry:
@@ -1181,6 +1181,8 @@ One card per messaging channel (Telegram, Slack, iMessage, WhatsApp, Discord). E
 | | **Body:** `{ agentId, chatId?, requireMention? }` | **Params:** `channelName`, `body` (object) |
 | Remove agent route | `DELETE /api/channels/:channelName/agents/:agentId` | `remove_agent_route` |
 | | | **Params:** `channelName`, `agentId` |
+| Set channel credentials | `POST /api/channels/:channelName/credentials` | `set_channel_credentials` |
+| | **Body:** `{ token?, apiKey?, ... }` | **Params:** `channelName`, credential fields |
 | Get sticky routing | `GET /api/sticky-routing` | `get_sticky_routing` |
 | | | *(no params)* |
 
@@ -1318,6 +1320,7 @@ Each account row shows:
 | **Groq** | `groq:<model>` | `groq` | `groq:llama-3.3-70b-versatile` |
 | **Together** | `together:<model>` | `together` | `together:meta-llama/Llama-3.3-70B-Instruct` |
 | **Mistral** | `mistral:<model>` | `mistral` | `mistral:mistral-large-latest` |
+| **Venice** | `venice:<model>` | `venice` | `venice:llama-3.3-70b`, `venice:mistral-31-24b` |
 
 API keys are stored in `config.json` under `service.providerKeys` (e.g., `{ "openai": "sk-...", "xai": "xai-...", "google": "AIza..." }`). Set them in Admin → Settings → Provider Keys.
 
@@ -1334,7 +1337,7 @@ API keys are stored in `config.json` under `service.providerKeys` (e.g., `{ "ope
 | Set provider API keys | `PUT /api/config/service` | `update_service_config` |
 | | **Body:** `{ providerKeys: { openai: "sk-...", xai: "xai-..." } }` | **Params:** `{ providerKeys: { ... } }` |
 | Test provider API key | `POST /api/config/provider-test` | `test_provider` |
-| | **Body:** `{ provider: "openai" }` — tests the configured key for that provider | **Params:** `provider` (string: openai, grok, gemini, groq, together, mistral) |
+| | **Body:** `{ provider: "openai" }` — tests the configured key for that provider | **Params:** `provider` (string: openai, grok, gemini, groq, together, mistral, venice) |
 | Proxy Ollama tag list | `GET /api/ollama-proxy?url=<ollamaUrl>/api/tags` | — (internal) |
 | | **Query:** `url` — only `/api/tags` proxy is allowed | N/A — used by the Settings UI to list local Ollama models |
 
@@ -1379,7 +1382,7 @@ API keys are stored in `config.json` under `service.providerKeys` (e.g., `{ "ope
 - **Save & Verify button** — saves the key to `config.json` and verifies against the licensing server immediately. Agents unblock without restart.
 - **Verify Only button** — checks current license status without saving
 
-**License popup:** If no valid license is configured, a full-screen modal appears on page load (all pages except Admin) prompting the user to enter their license key. The key is saved and verified inline — no restart needed.
+**License popup:** If no valid license is configured, a full-screen modal appears on page load (all pages except Admin) prompting the user to enter their license key. The key is saved and verified inline — no restart needed. The modal also shows a **"Don't have a key? Generate one here"** link pointing to the AI Gym download page (skip to Step 4) for users who haven't yet obtained a license.
 
 **Behavior:**
 
@@ -1418,6 +1421,19 @@ API keys are stored in `config.json` under `service.providerKeys` (e.g., `{ "ope
 | Test SaaS connection | `POST /api/saas/test` | `test_saas_connection` |
 | | **Body:** `{ baseUrl?, apiKey? }` | **Params:** `baseUrl?`, `apiKey?` |
 
+### Desktop Shortcut
+
+During first-time setup (`/setup`), MyAIforOne automatically creates a branded desktop shortcut with the MyAIforOne `A` logomark icon:
+
+| Platform | File | What it does |
+|----------|------|--------------|
+| **macOS** | `~/Desktop/MyAIforOne.app` | Opens `http://localhost:4888` in your browser |
+| **Windows** | `~/Desktop/MyAIforOne.lnk` | Opens `http://localhost:4888` in your browser |
+
+The shortcut is created silently — no confirmation required. It assumes the service is already running (via launchd on macOS or Task Scheduler on Windows). Double-clicking while the service is stopped will open the browser to a "connection refused" page until the service starts.
+
+> The shortcut is created once during setup and is not recreated on updates. If deleted, re-run `/setup` or create it manually.
+
 ### Status Indicator Section
 - **Description:** "Show a live status dot in your menu bar (Mac) or system tray (Windows)"
 - **Install xbar Plugin button** (macOS only) — installs the status bar indicator
@@ -1456,6 +1472,39 @@ Documentation cards:
 | Get changelog | `GET /api/changelog` | `get_changelog` |
 | | | *(no params)* |
 
+## 7.5 Platform Updates
+
+**Tab:** Updates
+
+Check the installed version of MyAIforOne and update to the latest release with one click.
+
+### Version Status Card
+
+| Field | Description |
+|-------|-------------|
+| **Installed version** | The currently running `myaiforone` npm package version (e.g., `1.1.34`) |
+| **Latest version** | The latest published version from the npm registry |
+| **Status badge** | **Up to date** (green) or **Update available** (cyan) |
+
+- Version comparison uses semver — a dev build (`1.1.34-dev`) will not falsely show as outdated.
+- Latest version is fetched from the npm registry with a 5-second timeout; if unreachable, the card shows "Unable to check".
+
+### Update Button
+
+- **Label:** "Update to vX.X.X"
+- **Visible:** Only when an update is available
+- **Confirmation dialog:** Shown before update begins — "This will update MyAIforOne to vX.X.X and restart the service. Continue?"
+- **What it does:** Runs `npx myaiforone@latest --yes` in the background, then restarts the service. The page reloads automatically after restart.
+
+> **Note:** The update runs as the same user that started the service. Ensure the user has npm write permissions.
+
+| Action | API | MCP |
+|--------|-----|-----|
+| Check version | `GET /api/version` | — |
+| | Returns `{ current, latest, updateAvailable }` | |
+| Run update | `POST /api/update` | — |
+| | Triggers `npx myaiforone@latest` + service restart | |
+
 ---
 
 # 8. Monitor
@@ -1846,6 +1895,16 @@ Guides have two forms: human-readable (browsable in gym) and agent-executable (a
 | | Returns array of programs with source=coach | *(no params)* |
 | Create coach guide | `POST /api/gym/guides` | `create_gym_guide` |
 | | **Body:** `{ title, description?, difficulty?, dimensions?, estimatedTime?, modules?, content? }` | **Params:** `title`, `description?`, `difficulty?`, `dimensions?`, `estimatedTime?`, `modules?`, `content?` |
+| Get AI insights | `GET /api/gym/insights` | `get_gym_insights` |
+| | Returns pre-computed AI insights generated by the weekly-insight goal | *(no params)* |
+| Save AI insights | `POST /api/gym/insights` | `save_gym_insights` |
+| | **Body:** `{ insights, topRecommendation?, summary? }` | **Params:** `insights` (array), `topRecommendation?`, `summary?` |
+| Dismiss an insight | `POST /api/gym/insights/:id/dismiss` | — |
+| | | **Params:** `id` (insight ID) |
+| Reset dismissed insights | `POST /api/gym/insights/reset-dismissed` | — |
+| | Restores all dismissed insights to visible | *(no params)* |
+| Generate insights on-demand | `POST /api/gym/insights/generate` | — |
+| | Triggers AI analysis and produces fresh insights immediately | *(no params)* |
 
 ---
 
@@ -2018,6 +2077,7 @@ Quick reference — all MCP tools alphabetically:
 | -- | `snapshot_dimensions` | AI Gym |
 | 84 | `send_webhook` | Webhook |
 | 85 | `set_model` | Model |
+| -- | `set_channel_credentials` | Channels |
 | 86 | `set_platform_default` | Marketplace |
 | 87 | `set_prompt_trigger` | Marketplace |
 | 88 | `start_account_login` | Accounts |
@@ -2048,3 +2108,5 @@ Quick reference — all MCP tools alphabetically:
 | 105 | `update_task` | Tasks |
 | 106 | `upload_file` | Files |
 | 107 | `whoami` | Accounts |
+| -- | `get_gym_insights` | AI Gym |
+| -- | `save_gym_insights` | AI Gym |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myaiforone",
-  "version": "1.1.35",
+  "version": "1.1.37",
   "type": "module",
   "description": "Routes messages from phone channels to project-specific Claude Code agents",
   "bin": {

package/public/api-docs.html

@@ -334,6 +334,7 @@ const CATALOG = [
   { cat: "Channels", method: "DELETE", path: "/api/channels/:channelName/agents/:agentId", summary: "Remove agent route from channel", params: [{ name: "channelName", in: "path", type: "string", required: true }, { name: "agentId", in: "path", type: "string", required: true }] },
   { cat: "Channels", method: "POST", path: "/api/channels/:channelName/monitored", summary: "Add monitored chat to channel", params: [{ name: "channelName", in: "path", type: "string", required: true }], body: { chatId: { type: "string", required: true } } },
   { cat: "Channels", method: "DELETE", path: "/api/channels/:channelName/monitored", summary: "Remove monitored chat", params: [{ name: "channelName", in: "path", type: "string", required: true }], body: { chatId: { type: "string", required: true } } },
+  { cat: "Channels", method: "POST", path: "/api/channels/:channelName/credentials", summary: "Set channel authentication credentials (tokens, keys). Auto-enables the channel.", params: [{ name: "channelName", in: "path", type: "string", required: true }], body: { token: { type: "string", desc: "Bot token (Telegram, Slack, Discord)" }, apiKey: { type: "string", desc: "API key if applicable" } } },
   { cat: "Channels", method: "GET", path: "/api/sticky-routing", summary: "Get sticky routing config for all channels" },
 
   // -- Marketplace / Registry --
@@ -428,6 +429,10 @@ const CATALOG = [
   { cat: "AI Gym", method: "POST", path: "/api/gym/guides", summary: "Create a coach-generated guide from a training session", body: { title: { type: "string", required: true }, description: { type: "string" }, difficulty: { type: "string" }, dimensions: { type: "array" }, estimatedTime: { type: "string" }, modules: { type: "array" }, content: { type: "string" } } },
   { cat: "AI Gym", method: "GET", path: "/api/gym/insights", summary: "Get pre-computed AI insights (generated weekly by the gym goal). Used by 'You tell me' mode." },
   { cat: "AI Gym", method: "POST", path: "/api/gym/insights", summary: "Save AI-generated insights from weekly analysis", body: { insights: { type: "array", required: true, desc: "Array of { title, description, dimension?, agentId? }" }, topRecommendation: { type: "string", desc: "Single best recommendation" }, summary: { type: "string", desc: "Brief summary of observations" } } },
+  { cat: "AI Gym", method: "POST", path: "/api/gym/insights/:id/dismiss", summary: "Dismiss a specific AI insight by ID", params: [{ name: "id", in: "path", type: "string", required: true }] },
+  { cat: "AI Gym", method: "POST", path: "/api/gym/insights/reset-dismissed", summary: "Reset all dismissed insights (make them visible again)" },
+  { cat: "AI Gym", method: "POST", path: "/api/gym/insights/generate", summary: "Trigger on-demand AI insights generation (analyzes agent activity and produces insights)" },
+  { cat: "AI Gym", method: "POST", path: "/api/gym/cards/:id/dismiss", summary: "Dismiss a gym card by ID (alias for DELETE /api/gym/cards/:id)", params: [{ name: "id", in: "path", type: "string", required: true }] },
 
   // -- Session Tabs --
   { cat: "Sessions", method: "GET", path: "/api/agents/:agentId/session-tabs", summary: "List all named session tabs (includes closed, with last message preview)", params: [{ name: "agentId", in: "path", type: "string", required: true }] },
@@ -456,6 +461,11 @@ const CATALOG = [
   // -- Config (continued) --
   { cat: "Config", method: "POST", path: "/api/config/provider-test", summary: "Test an API key for a cloud provider", body: { provider: { type: "string", required: true, desc: "openai | grok | gemini | groq | together | mistral" } } },
   { cat: "Config", method: "POST", path: "/api/restart", summary: "Restart the MyAgent gateway service" },
+  { cat: "Config", method: "POST", path: "/api/shutdown", summary: "Shut down the MyAgent gateway service" },
+  { cat: "Config", method: "GET", path: "/api/version", summary: "Get current platform version and check if an update is available", response: "{ version, latestVersion, updateAvailable }" },
+  { cat: "Config", method: "POST", path: "/api/update", summary: "Pull and apply the latest platform update (runs git pull + npm install + rebuild)" },
+  { cat: "Config", method: "GET", path: "/api/license", summary: "Get current license status (key, org, expiry, valid flag)", response: "{ valid, key, org, expiry }" },
+  { cat: "Config", method: "POST", path: "/api/license/check", summary: "Verify a license key against the licensing server", body: { licenseKey: { type: "string", required: true, desc: "License key in format MA1-xxxxxxxx-..." } } },
 
   // -- Utility --
   { cat: "Utility", method: "POST", path: "/api/open-folder", summary: "Open a folder in Finder (macOS), Explorer (Windows), or xdg-open (Linux)", body: { path: { type: "string", required: true, desc: "Absolute or ~ path to open" } } },
@@ -543,6 +553,7 @@ const TOOLS = [
   // Channels
   {cat:"Channels",name:"list_channels",desc:"List all messaging channels with config and routes",params:[]},
   {cat:"Channels",name:"update_channel",desc:"Update channel settings (sticky routing, enabled)",params:[{n:"channelName",t:"string",r:true},{n:"enabled",t:"boolean",r:false},{n:"stickyRouting",t:"enum",r:false,d:"none | sticky | prefix"},{n:"stickyPrefix",t:"string",r:false},{n:"stickyTimeoutMs",t:"number",r:false}]},
+  {cat:"Channels",name:"set_channel_credentials",desc:"Set channel authentication credentials (tokens, keys). Auto-enables the channel. After calling, tell the user to go to Admin → Settings and click Restart.",params:[{n:"channelName",t:"string",r:true,d:"Channel name (telegram, slack, discord, whatsapp, imessage)"},{n:"token",t:"string",r:false,d:"Bot token (Telegram, Slack, Discord)"},{n:"apiKey",t:"string",r:false,d:"API key if applicable"}]},
   {cat:"Channels",name:"add_agent_route",desc:"Add an agent route to a channel",params:[{n:"channelName",t:"string",r:true},{n:"agentId",t:"string",r:true},{n:"chatId",t:"string",r:true},{n:"requireMention",t:"boolean",r:false},{n:"allowFrom",t:"string[]",r:false}]},
   {cat:"Channels",name:"remove_agent_route",desc:"Remove an agent's route from a channel",params:[{n:"channelName",t:"string",r:true},{n:"agentId",t:"string",r:true}]},
   {cat:"Channels",name:"add_monitored_chat",desc:"Add a monitored chat ID",params:[{n:"channelName",t:"string",r:true},{n:"chatId",t:"string",r:true}]},
@@ -706,6 +717,10 @@ const TOOLS = [
   // AI Gym — Digest
   {cat:"AI Gym",name:"run_gym_digest",desc:"Manually trigger the activity digest (analyzes all activity, scores dimensions, generates cards)",params:[]},
 
+  // AI Gym — Insights
+  {cat:"AI Gym",name:"get_gym_insights",desc:"Get pre-computed AI insights (generated weekly by the gym goal). Used by 'You tell me' mode.",params:[]},
+  {cat:"AI Gym",name:"save_gym_insights",desc:"Save AI-generated insights from weekly analysis. Called by the weekly-insight goal after analyzing activity.",params:[{n:"insights",t:"array",r:true,d:"Array of { title, description, dimension?, agentId? }"},{n:"topRecommendation",t:"string",r:false,d:"Single best recommendation"},{n:"summary",t:"string",r:false,d:"Brief summary of observations"}]},
+
   // Computer Use (aiforone_computeruse MCP)
   {cat:"Computer",name:"computer_screenshot",desc:"Capture the screen and return a base64 PNG image the agent can see inline. Use this to orient before clicking.",params:[]},
   {cat:"Computer",name:"computer_get_info",desc:"Get screen width, height, and platform. Call before clicking to understand coordinate space.",params:[]},

package/public/mcp-docs.html

@@ -194,6 +194,7 @@ const TOOLS = [
   // Channels
   {cat:"Channels",name:"list_channels",desc:"List all messaging channels with config and routes",params:[]},
   {cat:"Channels",name:"update_channel",desc:"Update channel settings (sticky routing, enabled)",params:[{n:"channelName",t:"string",r:true},{n:"enabled",t:"boolean",r:false},{n:"stickyRouting",t:"enum",r:false,d:"none | sticky | prefix"},{n:"stickyPrefix",t:"string",r:false},{n:"stickyTimeoutMs",t:"number",r:false}]},
+  {cat:"Channels",name:"set_channel_credentials",desc:"Set channel authentication credentials (tokens, keys). Auto-enables the channel. After calling, tell the user to go to Admin → Settings and click Restart.",params:[{n:"channelName",t:"string",r:true,d:"Channel name (telegram, slack, discord, whatsapp, imessage)"},{n:"token",t:"string",r:false,d:"Bot token (Telegram, Slack, Discord)"},{n:"apiKey",t:"string",r:false,d:"API key if applicable"}]},
   {cat:"Channels",name:"add_agent_route",desc:"Add an agent route to a channel",params:[{n:"channelName",t:"string",r:true},{n:"agentId",t:"string",r:true},{n:"chatId",t:"string",r:true},{n:"requireMention",t:"boolean",r:false},{n:"allowFrom",t:"string[]",r:false}]},
   {cat:"Channels",name:"remove_agent_route",desc:"Remove an agent's route from a channel",params:[{n:"channelName",t:"string",r:true},{n:"agentId",t:"string",r:true}]},
   {cat:"Channels",name:"add_monitored_chat",desc:"Add a monitored chat ID",params:[{n:"channelName",t:"string",r:true},{n:"chatId",t:"string",r:true}]},
@@ -327,6 +328,10 @@ const TOOLS = [
   // AI Gym — Digest
   {cat:"AI Gym",name:"run_gym_digest",desc:"Manually trigger the activity digest (analyzes all activity, scores dimensions, generates cards)",params:[]},
 
+  // AI Gym — Insights
+  {cat:"AI Gym",name:"get_gym_insights",desc:"Get pre-computed AI insights (generated weekly by the gym goal). Used by 'You tell me' mode.",params:[]},
+  {cat:"AI Gym",name:"save_gym_insights",desc:"Save AI-generated insights from weekly analysis. Called by the weekly-insight goal after analyzing activity.",params:[{n:"insights",t:"array",r:true,d:"Array of { title, description, dimension?, agentId? }"},{n:"topRecommendation",t:"string",r:false,d:"Single best recommendation"},{n:"summary",t:"string",r:false,d:"Brief summary of observations"}]},
+
   // AI Gym — Feed & Config
   {cat:"AI Gym",name:"get_gym_feed",desc:"Get the aggregated gym feed — tips/nudges from gym cards, platform updates from changelog, and AI briefing",params:[]},
   {cat:"AI Gym",name:"get_gym_config",desc:"Get public gym configuration flags (gymEnabled, gymOnlyMode, aibriefingEnabled)",params:[]},