mindvest-atlas 0.62.0 → 0.64.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindvest-atlas",
-  "version": "0.62.0",
+  "version": "0.64.0",
   "description": "Atlas CLI \u2014 OAuth login, tool calls, and live alert/flow streaming for the Atlas trading API",
   "type": "module",
   "bin": {

package/src/commands/computer-use.js

@@ -27,7 +27,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import {
   workspace, workspaceRoot, venvPython, ambientPython, jobEnv, ensureProjectFiles,
-  computerUseAllowed, computerClaim, releaseComputerClaim,
+  computerUseAllowed, computerClaim, releaseComputerClaim, askAddress,
 } from '../remote-control.js';
 import { color, println, eprintln } from '../util/ui.js';
 
@@ -254,6 +254,14 @@ export function runInProject(job, code, root) {
   const venv = venvPython(dir);
   const python = venv ? [String(venv)] : [...ambientPython()];
   const env = { ...process.env, ...jobEnv(dir), ATLAS_JOB: path.basename(dir) };
+  // AND HOW TO REACH THE APP, when this shell was not started by it. Without
+  // these, ask(), screenshot() and every dashboard call inside the script refuse
+  // with "this has to run from inside Atlas" while Atlas is running (owner,
+  // 2026-09-10). Only filled when absent: a run Atlas started keeps its own.
+  if (!env.ATLAS_ASK_URL || !env.ATLAS_ASK_TOKEN) {
+    const at = askAddress(root);
+    if (at) { env.ATLAS_ASK_URL = at.url; env.ATLAS_ASK_TOKEN = at.token; }
+  }
   // BEFORE ANYTHING TRIES TO IMPORT THEM. Checked every time and installed only
   // when something is missing, so the cost is one python start on a machine
   // that is already set up.

package/src/commands/run.js

@@ -24,7 +24,7 @@ import { spawnSync } from 'node:child_process';
 import fs from 'node:fs';
 import path from 'node:path';
 import {
-  workspace, venvPython, ambientPython, jobEnv, ensureProjectFiles,
+  workspace, venvPython, ambientPython, jobEnv, ensureProjectFiles, askAddress,
 } from '../remote-control.js';
 import { color, println, eprintln } from '../util/ui.js';
 import { shellSession } from './computer-use.js';
@@ -86,11 +86,18 @@ export function runCommand(args) {
   // THE BRIDGE BACK TO ATLAS is inherited, never invented. These are handed to
   // a process Atlas starts, so an agent's own shell has them and a person's
   // ordinary terminal does not. Saying so beats a snippet that half works.
+  // FILLED IN WHEN THE APP IS RUNNING. It writes its loopback address down while
+  // it listens, so a shell Atlas did not start can still reach it. The note below
+  // is now only for the case that is actually true: Atlas is not running.
+  if (!env.ATLAS_ASK_URL || !env.ATLAS_ASK_TOKEN) {
+    const at = askAddress(flags.root);
+    if (at) { env.ATLAS_ASK_URL = at.url; env.ATLAS_ASK_TOKEN = at.token; }
+  }
   if (!env.ATLAS_ASK_URL || !env.ATLAS_ASK_TOKEN) {
     println(color.dim(
-      '  Note: this shell was not started by Atlas, so ask(), dashboard and '
-      + 'screenshot() will not work in it. Everything else will. Ask in a chat '
-      + 'if you need those.'));
+      '  Note: Atlas Studio is not running, so ask(), dashboard and screenshot() '
+      + 'will not work in this shell. Everything else will. Start Atlas Studio if '
+      + 'you need those.'));
   }
   if (!env.ATLAS_JOB) env.ATLAS_JOB = path.basename(dir);
   // ONE SESSION FOR THE WHOLE SHELL, the same one `atlas computer-use` uses.

package/src/commands/screenshot.js

@@ -16,6 +16,7 @@
 // the project's own `screenshots/`, and prints the faults in words — because a
 // picture the agent cannot see is not a check.
 import { color, println, eprintln } from '../util/ui.js';
+import { askAddress } from '../remote-control.js';
 
 export async function screenshotCommand(args) {
   const flags = args.flags || {};
@@ -25,17 +26,20 @@ export async function screenshotCommand(args) {
     return 1;
   }
 
-  const url = process.env.ATLAS_ASK_URL;
-  const token = process.env.ATLAS_ASK_TOKEN;
+  // Atlas hands these to what it starts, and writes them down while it is
+  // running so a terminal it did not start can find them too.
+  const at = askAddress(flags.root);
+  const url = at?.url;
+  const token = at?.token;
   if (!url || !token) {
     // NOT a Local Mode check, whatever it used to say. These variables are
     // handed to a process Atlas starts — a script it runs, or an agent it
     // spawned. Their absence means this command is running somewhere Atlas did
     // not start it, and saying "turn Local Mode on" sent people to a switch
     // that was already on (owner, 2026-09-05).
-    eprintln(color.red('This has to run from inside Atlas. Atlas is what draws the page.'));
-    eprintln(color.dim('Ask for it in a chat, or call screenshot() from the project\'s script. '
-      + 'Run by hand in a terminal there is nothing to photograph.'));
+    eprintln(color.red('Atlas Studio is not running on this computer. Atlas is what draws the page.'));
+    eprintln(color.dim('Start Atlas Studio and try again, or ask for it in a chat. '
+      + 'With nothing running there is nothing to photograph.'));
     return 1;
   }
 

package/src/config.js

@@ -2,7 +2,7 @@
 import path from 'node:path';
 import os from 'node:os';
 
-export const VERSION = '0.62.0';
+export const VERSION = '0.64.0';
 export const DEFAULT_BASE_URL = 'https://atlasmcp.finmanagerai.com';
 export const DEFAULT_SCOPE = 'atlas broker';
 export const CLIENT_NAME = 'Atlas CLI';

package/src/helpers/atlas_env.py

@@ -2432,7 +2432,7 @@ def _sleep_or_stop(seconds, slice_s=1.0):
     return _still_mine()
 
 
-def watch(instruction, every=5, most=200, hours=8, look=True):
+def watch(instruction, every=5, most=200, hours=8, look=True, model=""):
     """Watch the screen and act when it is time. Runs until it is done.
 
     THE SHAPE OF A JOB THAT IS MOSTLY WAITING (owner, 2026-09-06: "watch this
@@ -2465,6 +2465,24 @@ def watch(instruction, every=5, most=200, hours=8, look=True):
     choosing, and why a model that says "nothing is happening, look again in an
     hour" is doing its job rather than being lazy.
 
+    A SMALL MODEL CAN DO THE WATCHING (owner, 2026-09-10: "a smaller model to
+    watch continuously, then the router is able to route to larger to call tools
+    and do other stuff"). `model=` names who is asked each round, and the round
+    is the cheap half of this: nothing has changed, look again later. It is the
+    ACTING that wants a big model, and the watcher hands that over the same way
+    anything else does, by calling ask() with one:
+
+        watch("Watch the SPY 5-minute chart. Say QUIET and nothing else while "
+              "it is quiet. When the opening range high breaks on rising "
+              "volume, call: "
+              "  ask('Break just happened, here is the screen: <path>. Decide "
+              "      the trade and place it.', model='claude-opus-5')",
+              every=2, model="claude-haiku-4-5")
+
+    Whoever is watching still has this whole computer, so a watcher that can
+    decide for itself should just act. Route when the decision is worth the
+    bigger model, not on principle. models() lists what this machine can reach.
+
     Ends when the model writes DONE on a line by itself, when `most` rounds have
     passed, or when `hours` have. Pressing Stop ends it like anything else.
     """
@@ -2534,7 +2552,7 @@ def watch(instruction, every=5, most=200, hours=8, look=True):
                    else "The screen could not be photographed this round.")
             )
             try:
-                answer = ask(asked)
+                answer = ask(asked, model=model)
             except Exception as err:
                 answer = ""
                 seen.append({"round": rounds, "error": str(err)})

package/src/remote-control.js

@@ -39,6 +39,34 @@ export const ENTRIES = ['main.py', 'main.js', 'main.mjs'];
  */
 export const DEFAULT_TIMEOUT_MS = 1_800_000;
 
+/**
+ * HOW TO REACH A RUNNING ATLAS, from a shell it did not start.
+ *
+ * ATLAS_ASK_URL / ATLAS_ASK_TOKEN are handed to processes Atlas spawns. Anything
+ * else on the same machine had no way in at all: `atlas screenshot`, `atlas
+ * dashboard` and `atlas run --code` all refused with "this has to run from
+ * inside Atlas", with the app running the whole time and nothing the person
+ * could do about it (owner, 2026-09-10).
+ *
+ * The app writes its loopback address down while it is listening, so this is
+ * the same server those variables point at, on the same machine, for the same
+ * user. The environment still wins when it is set: a run Atlas started should
+ * talk to the Atlas that started it.
+ */
+export function askAddress(root) {
+  const url = process.env.ATLAS_ASK_URL;
+  const token = process.env.ATLAS_ASK_TOKEN;
+  if (url && token) return { url, token };
+  try {
+    const file = path.join(workspaceRoot(root), '.studio', 'ask-server.json');
+    const saved = JSON.parse(fs.readFileSync(file, 'utf8'));
+    if (saved?.url && saved?.token) return { url: String(saved.url), token: String(saved.token) };
+  } catch {
+    // Not running, or a different machine's home. The caller says so in words.
+  }
+  return null;
+}
+
 export function workspaceRoot(override) {
   const raw = override || process.env.ATLAS_LOCAL_DIR
     || process.env.ATLAS_LIBRARY_DIR   // what Studio sets

package/src/sharing.js

@@ -435,6 +435,12 @@ export async function publish(job, root, {
     // button has a LINK to offer, not a line of hex.
     share_url: data.share_url,
     name: fields.name,
+    // WHAT THE PROJECT IS, KEPT (owner, 2026-09-09: "when publishing changes,
+    // it always ask what the project is for — if the user has added this just
+    // recall it"). It was sent to the server and forgotten locally, so the
+    // publish dialog opened with an empty box on every single release and the
+    // author retyped the same sentence or, more often, shipped without one.
+    description: fields.description,
     author: true,
     // Where it started, kept for as long as the copy exists. Provenance, not a
     // subscription: the update check follows `package_id`, which is now this
@@ -525,6 +531,9 @@ export function shareState(job, root) {
     mine: Boolean(pin.author),
     author_name: pin.author_name,
     forked_from: pin.forked_from,
+    // What this project IS, as last published. The publish dialog seeds its
+    // box from here, so a re-release starts with the sentence already in it.
+    description: pin.description,
   };
 }