mindvest-atlas 0.53.0 → 0.55.0

package/package.json

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

package/src/config.js

@@ -2,7 +2,7 @@
 import path from 'node:path';
 import os from 'node:os';
 
-export const VERSION = '0.53.0';
+export const VERSION = '0.55.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.js

@@ -57,8 +57,21 @@ export async function atlas(tool, params = {}) {
  * for pure text. fresh:false keeps ONE conversation for this job (the model
  * starts up once, later questions can refer to earlier ones); fresh:true is for
  * independent questions that should not pile into one context.
+ *
+ * model:"" uses whichever model is connected, which is the usual case. Name one
+ * to send THIS question somewhere else - a cheap fast one for twenty
+ * classifications and a strong one for the judgement call at the end, in the
+ * same script:
+ *
+ *     const kind = await ask(`Sector or company?\n${line}`, { model: "claude-haiku-4-5" });
+ *     const call = await ask("Given all of the above, do we buy?", { model: "claude-opus-4-8" });
+ *
+ * models() lists what this computer can reach, with their ids and the effort
+ * words each one takes. A name it does not have is refused BY NAME rather than
+ * quietly answered by the default, because a script that asked for a specific
+ * model and silently got another one is worse than one that stops.
  */
-export async function ask(prompt, { tools = true, fresh = false, timeoutMs = 600000 } = {}) {
+export async function ask(prompt, { tools = true, fresh = false, timeoutMs = 600000, model = "" } = {}) {
   const url = process.env.ATLAS_ASK_URL;
   const token = process.env.ATLAS_ASK_TOKEN;
   if (!url || !token) {
@@ -67,10 +80,14 @@ export async function ask(prompt, { tools = true, fresh = false, timeoutMs = 600
       "Connect a model in Atlas Studio, or do this step in code."
     );
   }
+  const body = { job: process.env.ATLAS_JOB || "", prompt: String(prompt), tools, fresh };
+  // Sent only when named, so a script that does not care keeps whatever is
+  // connected rather than pinning itself to today's default.
+  if (String(model || "").trim()) body.model = String(model).trim();
   const res = await fetch(url, {
     method: "POST",
     headers: { "Content-Type": "application/json", "X-Atlas-Token": token },
-    body: JSON.stringify({ job: process.env.ATLAS_JOB || "", prompt: String(prompt), tools, fresh }),
+    body: JSON.stringify(body),
     signal: AbortSignal.timeout(timeoutMs),
   });
   const out = await res.json().catch(() => ({}));
@@ -78,6 +95,36 @@ export async function ask(prompt, { tools = true, fresh = false, timeoutMs = 600
   return out.answer || "";
 }
 
+/**
+ * Every model this computer can reach, asked of the app itself.
+ *
+ * Returns rows of {id, label, vendor, ready, effort, effortDefault} - the id to
+ * pass to ask({model}), and the effort words THAT model takes, which differ per
+ * vendor and are the other thing that gets guessed wrong. An empty list means
+ * no model is connected, in which case ask() will say so too.
+ *
+ *     const roster = await models();
+ *     const cheap = roster.find((m) => m.ready && m.id.includes("haiku"));
+ *     await ask("Sector or company?", { model: cheap?.id });
+ */
+export async function models() {
+  const url = process.env.ATLAS_ASK_URL;
+  const token = process.env.ATLAS_ASK_TOKEN;
+  if (!url || !token) return [];
+  try {
+    const res = await fetch(url.replace("/ask", "/models"), {
+      headers: { "X-Atlas-Token": token },
+      signal: AbortSignal.timeout(20000),
+    });
+    const out = await res.json().catch(() => ({}));
+    return (out.models || []).filter((m) => m && m.id);
+  } catch {
+    // A roster that cannot be read is not a reason to take the job down: the
+    // script can still ask the connected model without naming one.
+    return [];
+  }
+}
+
 /**
  * Call a tool on one of YOUR connected MCP servers.
  *

package/src/remote-control.js

@@ -1502,7 +1502,7 @@ const STARTER_README = (name) => [
   '- `main.py`        what runs. Replaced by the model on the first build.',
   '- `.env`           your keys. Values stay on this computer and are never read',
   '                   back by anything, including the model.',
-  '- `atlas_env.py`   helpers: secret(), require(), atlas(), ask().',
+  '- `atlas_env.py`   helpers: secret(), require(), atlas(), ask(), models().',
   '- `plan.md`        a diagram of what happens, written after the first build.',
   '- `dashboard.js`   how this job draws itself on the Dashboard tab. Atlas owns',
   '                   the page; this is the drawing.',