@camelai/camelrun 0.11.2 → 0.13.0

package/dist/api.js

@@ -1,8 +1,13 @@
-/** A refused call: the runtime's `error` message, with the HTTP status and its `code` when it gave one. */
+/**
+ * A refused call: the runtime's `error` message, with the HTTP status and its `code` when it gave one. The message
+ * suits every surface; `cliHint` is what to do about it with the CLI, which only the CLI shows (an MCP client's model
+ * would try to run it).
+ */
 export class ApiError extends Error {
     status;
     code;
-    constructor(status, message, code) { super(message); this.status = status; this.code = code; }
+    cliHint;
+    constructor(status, message, code, cliHint) { super(message); this.status = status; this.code = code; this.cliHint = cliHint; }
 }
 /** SHA-256 as hex, with Web Crypto: the same in Node and browsers. */
 async function sha256(text) {
@@ -39,7 +44,7 @@ export class Api {
         }
         if (!response.ok) {
             const message = json?.error ?? json?.message ?? (text.slice(0, 300) || response.statusText);
-            throw new ApiError(response.status, response.status === 401 ? `${message} (check your API key: camelrun login)` : message, json?.code);
+            throw new ApiError(response.status, message, json?.code, response.status === 401 ? "check your API key: camelrun login" : undefined);
         }
         return json;
     }
@@ -66,7 +71,7 @@ export class Api {
         const agents = await this.get("/v1/agents");
         const found = agents.find(agent => agent.key === keyOrId);
         if (!found)
-            throw new ApiError(404, `No agent with key ${JSON.stringify(keyOrId)} (camelrun agents list shows them)`);
+            throw new ApiError(404, `No agent with key ${JSON.stringify(keyOrId)} in this account`, undefined, "camelrun agents list shows them");
         return found.id;
     }
 }

package/dist/cli.js

@@ -1,7 +1,7 @@
 import { existsSync, writeFileSync } from "node:fs";
 import { createInterface } from "node:readline/promises";
 import { parseArgs } from "node:util";
-import { Api, enc } from "./api.js";
+import { Api, ApiError, enc } from "./api.js";
 import { DEFAULT_URL, forget, resolve, save } from "./config.js";
 import { DEFAULT_FILES, template } from "./manifest.js";
 import { findManifest, loadManifests } from "./manifest-files.js";
@@ -51,7 +51,7 @@ MCP
 
 Options
   --json                           Print JSON (the default when stdout is not a terminal)
-  --api-key <key>, --url <url>     Instead of CAMELAI_API_KEY / CAMELAI_URL / the saved login
+  --api-key <key>, --url <url>     Instead of CAMELAI_API_KEY / CAMELAI_BASE_URL / the saved login
 
 Docs: https://run.camelai.com/llms.txt`;
 const OPTIONS = {
@@ -189,7 +189,8 @@ export async function main(argv, io = { out: text => process.stdout.write(text +
         }
     }
     catch (error) {
-        io.err(json && !(error instanceof UsageError) ? JSON.stringify({ error: error.message, ...("status" in error ? { status: error.status, code: error.code } : {}) }) : `Error: ${error.message}`);
+        const message = error.message + (error instanceof ApiError && error.cliHint ? ` (${error.cliHint})` : "");
+        io.err(json && !(error instanceof UsageError) ? JSON.stringify({ error: message, ...("status" in error ? { status: error.status, code: error.code } : {}) }) : `Error: ${message}`);
         return 1;
     }
 }
@@ -202,7 +203,7 @@ async function login(flags, io, print) {
         apiKey = (await prompt.question("API key (create one at https://run.camelai.com/console/tokens): ")).trim();
         prompt.close();
     }
-    const url = flags.url || io.env.CAMELAI_URL || DEFAULT_URL;
+    const url = flags.url || io.env.CAMELAI_BASE_URL || io.env.CAMELAI_URL || DEFAULT_URL;
     const me = await new Api({ apiKey, url }).me();
     const path = save({ apiKey, url }, io.env);
     print({ tenant: me.tenant, url, saved: path }, () => `Logged in as ${me.login ?? me.tenant} on ${url} (key saved to ${path})`);

package/dist/config.js

@@ -32,11 +32,11 @@ export function forget(env = process.env) {
     rmSync(path, { force: true });
     return had ? path : undefined;
 }
-/** Flags first, then CAMELAI_API_KEY / CAMELAI_URL, then what `camelrun login` saved. */
+/** Flags first, then CAMELAI_API_KEY / CAMELAI_BASE_URL (as the SDKs read it; CAMELAI_URL too), then what `camelrun login` saved. */
 export function resolve(flags, env = process.env) {
     const saved = readSaved(env);
     const apiKey = flags.apiKey || env.CAMELAI_API_KEY || saved.apiKey;
     if (!apiKey)
         throw new Error("No API key: run `camelrun login`, or set CAMELAI_API_KEY. Create one at https://run.camelai.com/console/tokens. Coding agents: read https://run.camelai.com/SKILL.md");
-    return { apiKey, url: flags.url || env.CAMELAI_URL || saved.url || DEFAULT_URL };
+    return { apiKey, url: flags.url || env.CAMELAI_BASE_URL || env.CAMELAI_URL || saved.url || DEFAULT_URL };
 }

package/dist/ops.js

@@ -51,7 +51,8 @@ export function summarize(agent, record) {
     const result = outcome.result ?? {};
     const failure = outcome.error ? { code: outcome.uncertain ? "uncertain" : "runtime_error", message: outcome.error }
         : result.error ? { code: result.code ?? "model_error", message: result.error }
-            : result.stopped === "spend_limit" ? { code: "spend_limit", message: "The agent reached its spend limit; raise it to go on" } : undefined;
+            : result.stopped === "spend_limit" ? { code: "spend_limit", message: "The agent reached its spend limit; raise it to go on" }
+                : result.stopped === "turn_limit" ? { code: "turn_limit", message: "The run reached its limit of model responses or time; send another message to continue" } : undefined;
     const status = failure ? "failed" : result.stopped === "input_required" ? "input_required" : "completed";
     return {
         ...base, status,

package/dist/tools.js

@@ -68,7 +68,10 @@ export function tools(api, options = {}) {
         const client = api();
         return client.call("DELETE", `/v1/definitions/${await client.definitionId(definition)}`);
     }, destructive);
-    tool("list_agents", "List agents", "The account's agents: key, id, model, and whether each is running. Changes nothing.", {}, () => api().get("/v1/agents"), read);
+    tool("list_agents", "List agents", "The account's agents: key, id, name and model. `loaded` is whether the agent is in a runtime's memory now, idle or not; it says nothing about whether a run is going (run_agent and get_run do). `toolsConnected` is whether an application serving its attached tools is connected. Changes nothing.", {}, async () => {
+        const list = await api().get("/v1/agents");
+        return list.map(({ id, key, name, model, running, connected, expiresAt }) => ({ key, id, name, model, loaded: running, toolsConnected: connected, expiresAt }));
+    }, read);
     tool("get_agent", "Get agent", "An agent's configuration, the definition revision it has, and every source of its tools with what each offers. Changes nothing.", { agent }, async ({ agent }) => {
         const client = api();
         return client.get(`/v1/agents/${enc(await client.agentId(agent))}`);
@@ -129,7 +132,7 @@ export function tools(api, options = {}) {
     }, async ({ agent, ...schedule }) => {
         const client = api();
         return client.call("POST", `/v1/agents/${enc(await client.agentId(agent))}/schedules`, schedule);
-    }, add);
+    }, { ...add, openWorldHint: true });
     tool("delete_schedule", "Delete schedule", "Cancel a scheduled wake-up; this cannot be undone.", { agent, scheduleId: z.string() }, async ({ agent, scheduleId }) => {
         const client = api();
         return client.call("DELETE", `/v1/agents/${enc(await client.agentId(agent))}/schedules/${enc(scheduleId)}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camelai/camelrun",
-  "version": "0.11.2",
+  "version": "0.13.0",
   "description": "camelRun CLI: deploy and manage agents on camelRun from a terminal, or from a coding agent over MCP (camelrun mcp).",
   "type": "module",
   "license": "MIT",