@camelai/camelrun 0.11.1 → 0.12.0

package/README.md

@@ -16,7 +16,6 @@ revision only when it changed, and `--apply` moves live agents to it between the
 
 ```yaml
 key: support
-model: anthropic/claude-sonnet-5-5
 systemPromptFile: prompts/support.md
 builtins: [web_search, ask_user]
 mcpServers:

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";
@@ -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;
     }
 }
@@ -197,9 +198,9 @@ async function login(flags, io, print) {
     let apiKey = flags["api-key"] || io.env.CAMELAI_API_KEY;
     if (!apiKey) {
         if (!process.stdin.isTTY)
-            throw new UsageError("Pass --api-key art_… (or set CAMELAI_API_KEY); create one under API tokens at https://run.camelai.com/console");
+            throw new UsageError("Pass --api-key art_… (or set CAMELAI_API_KEY). Create one at https://run.camelai.com/console/tokens. Coding agents: read https://run.camelai.com/SKILL.md");
         const prompt = createInterface({ input: process.stdin, output: process.stderr });
-        apiKey = (await prompt.question("API key (from https://run.camelai.com/console, API tokens): ")).trim();
+        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;

package/dist/config.js

@@ -37,6 +37,6 @@ 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 under API tokens at https://run.camelai.com/console)");
+        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 };
 }

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.1",
+  "version": "0.12.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",