@camelai/run 0.11.0 → 0.11.1

package/README.md

@@ -10,7 +10,7 @@ npm install @camelai/run
 ```
 
 Node 22 or later, Bun, Deno or Cloudflare Workers. Get an API key from the
-console at <https://agents.camelai.dev/console> and export it as
+console at <https://run.camelai.com/console> and export it as
 `CAMELAI_API_KEY`.
 
 ```ts
@@ -55,10 +55,10 @@ await agents.close();
   `npm create @camelai/run-app`. `watchAgent` (`@camelai/run/watch`)
   shows an agent live with a browser token your server mints.
 
-Documentation: [Quickstart](https://agents.camelai.dev/docs/quickstart.md),
-[Concepts](https://agents.camelai.dev/docs/concepts.md),
-[SDK reference](https://agents.camelai.dev/docs/reference/sdk.md),
-and all of it as Markdown at <https://agents.camelai.dev/llms.txt>.
+Documentation: [Quickstart](https://run.camelai.com/docs/quickstart.md),
+[Concepts](https://run.camelai.com/docs/concepts.md),
+[SDK reference](https://run.camelai.com/docs/reference/sdk.md),
+and all of it as Markdown at <https://run.camelai.com/llms.txt>.
 
 `AgentRuntime` and `AgentClient`, the lower-level interface the SDK is built on,
 remain available. See the SDK reference's "Changes in 0.9" when upgrading.

package/dist/clients/agents.d.ts

@@ -15,7 +15,7 @@ declare const INSPECT: unique symbol;
 export interface AgentsOptions {
     /** Your API key (the console's). Default: the CAMELAI_API_KEY environment variable. */
     apiKey?: string;
-    /** The runtime's origin. Default: CAMELAI_BASE_URL, else https://agents.camelai.dev. */
+    /** The runtime's origin. Default: CAMELAI_BASE_URL, else https://run.camelai.com. */
     url?: string;
     fetch?: typeof globalThis.fetch;
     /** Opens a local file to attach by its path; the Node entry sets it. */

package/dist/clients/agents.js

@@ -36,7 +36,7 @@ export class Agents {
      */
     async upsert(key, config = {}) {
         if (!this.runtime.options.apiKey)
-            throw new AgentError("Set apiKey (or the CAMELAI_API_KEY environment variable): create a key in the console at https://agents.camelai.dev");
+            throw new AgentError("Set apiKey (or the CAMELAI_API_KEY environment variable): create a key in the console at https://run.camelai.com");
         const options = createOptions(config);
         const { session } = await this.runtime.upsertAgent(key, options);
         // The upsert declared these tools already (between the agent's turns, if it runs).

package/dist/clients/handler.d.ts

@@ -46,7 +46,7 @@ export interface SendEvent<A extends AgentAuth = AgentAuth> {
 export interface AgentHandlerOptions<A extends AgentAuth = AgentAuth> {
     /** Your API key. Default: the CAMELAI_API_KEY environment variable. */
     apiKey?: string;
-    /** The runtime's origin. Default: CAMELAI_BASE_URL, else https://agents.camelai.dev. */
+    /** The runtime's origin. Default: CAMELAI_BASE_URL, else https://run.camelai.com. */
     url?: string;
     /**
      * Your own session check, on every request. Return the user (and optionally which agent), or null to

package/dist/clients/server.d.ts

@@ -4,7 +4,7 @@
  * whom it acts for and who is acting; these helpers verify it and hand your tools the identity.
  * Portable: fetch-style handlers and WebCrypto (Ed25519), so it runs on Workers, Node 22+, Bun and Deno.
  *
- *   export default { fetch: serveTools(tools, { runtime: "https://agents.camelai.dev", tenant: "acme" }) };
+ *   export default { fetch: serveTools(tools, { runtime: "https://run.camelai.com", tenant: "acme" }) };
  *
  * An identity means something only within your own tenant: other tenants' agents can be pointed at your
  * server too, so every check here requires `tenant`, and refuses tokens made for anyone else's agents.
@@ -17,9 +17,9 @@ export interface VerifyOptions {
      * refused. Required: another tenant can point its agents at your server and say they act for anyone.
      */
     tenant: string | string[];
-    /** The runtime's URL (e.g. https://agents.camelai.dev): its keys are at /.well-known/jwks.json. */
+    /** The runtime's URL (e.g. https://run.camelai.com): its keys are at /.well-known/jwks.json. */
     runtime: string;
-    /** The issuer tokens must name; the runtime's URL by default. */
+    /** The issuer tokens must name; the runtime's URL by default (camelRun's hosted runtime names itself https://agents.camelai.dev at either of its URLs). */
     issuer?: string;
     /** What tokens must be for: your server's URL as the runtime calls it (a definition's `url`, or its `audience`). */
     audience: string | string[];

package/dist/clients/server.js

@@ -4,7 +4,7 @@
  * whom it acts for and who is acting; these helpers verify it and hand your tools the identity.
  * Portable: fetch-style handlers and WebCrypto (Ed25519), so it runs on Workers, Node 22+, Bun and Deno.
  *
- *   export default { fetch: serveTools(tools, { runtime: "https://agents.camelai.dev", tenant: "acme" }) };
+ *   export default { fetch: serveTools(tools, { runtime: "https://run.camelai.com", tenant: "acme" }) };
  *
  * An identity means something only within your own tenant: other tenants' agents can be pointed at your
  * server too, so every check here requires `tenant`, and refuses tokens made for anyone else's agents.
@@ -15,6 +15,15 @@ export class RuntimeTokenError extends Error {
     constructor(message) { super(message); this.name = "RuntimeTokenError"; }
 }
 const trim = (url) => url.replace(/\/+$/, "");
+/** camelRun's hosted runtime answers at both names, and signs as the first it had, which tool servers already check. */
+const HOSTED = ["https://run.camelai.com", "https://agents.camelai.dev"];
+const HOSTED_ISSUER = "https://agents.camelai.dev";
+const issuerOf = (options) => {
+    if (options.issuer)
+        return trim(options.issuer);
+    const runtime = trim(options.runtime);
+    return HOSTED.includes(runtime) ? HOSTED_ISSUER : runtime;
+};
 const decoder = new TextDecoder();
 function base64url(text) {
     const binary = atob(text.replace(/-/g, "+").replace(/_/g, "/").padEnd(Math.ceil(text.length / 4) * 4, "="));
@@ -86,7 +95,7 @@ export async function verifyRuntimeToken(token, options) {
         throw new RuntimeTokenError("Token signature does not verify");
     const claims = part(pieces[1]);
     const now = Math.floor(Date.now() / 1000), skew = options.clockTolerance ?? 30;
-    if (claims.iss !== trim(options.issuer ?? runtime))
+    if (claims.iss !== issuerOf(options))
         throw new RuntimeTokenError("Token is from another issuer");
     if (![options.tenant].flat().includes(claims.tenant))
         throw new RuntimeTokenError("Token is for another tenant's agent");
@@ -135,7 +144,7 @@ export function runtimeIdentity(extra) {
 export function serveTools(tools, options) {
     requireTenant(options);
     const server = typeof tools.listTools === "function" && typeof tools.callTool === "function" ? tools : toolServer(tools);
-    const issuer = trim(options.issuer ?? options.runtime);
+    const issuer = issuerOf(options);
     const json = (status, body, headers = {}) => new Response(JSON.stringify(body), { status, headers: { "Content-Type": "application/json", ...headers } });
     const WELL_KNOWN = "/.well-known/oauth-protected-resource";
     return async (request) => {

package/dist/clients/typescript.d.ts

@@ -160,9 +160,9 @@ export declare function answerMcp(message: Record<string, any>, server: ToolServ
 /** `tool({...})` definitions as an attached MCP server: JSON results become a text block (and structured content for objects). */
 export declare function toolServer(tools: Tools): ToolServer;
 /** The hosted runtime; `url` points elsewhere (a self-hosted runtime, or http://127.0.0.1:8790 in development). */
-export declare const DEFAULT_URL = "https://agents.camelai.dev";
+export declare const DEFAULT_URL = "https://run.camelai.com";
 export interface RuntimeOptions {
-    /** The runtime's origin. Default https://agents.camelai.dev. */
+    /** The runtime's origin. Default https://run.camelai.com. */
     url?: string;
     apiKey?: string;
     /** Injectable for tests, observability, or an application's HTTP stack. */
@@ -183,7 +183,8 @@ export interface AgentOptions {
      * throws goes to `onError`. A `message_update` is its delta alone (`assistantMessageEvent`), without the
      * message it updates: fold that from its `message_start` and the deltas since. Where the stream
      * cannot replay (a first connect, or a reconnect after the host's buffer moved on), the first event
-     * is a `{ type: "snapshot", turn }` of the running turn to fold from.
+     * is a `{ type: "snapshot", turn }` of the running turn to fold from. `close()` stops it: events still
+     * queued are dropped.
      */
     onEvent?: (event: AgentEvent, requestId?: string) => unknown | Promise<unknown>;
     /**
@@ -359,6 +360,8 @@ interface SourceOptions {
 }
 export interface DefinitionInput {
     name: string;
+    /** What its agents are for: shown to models as the description of each agent's MCP tool (/v1/agents/:id/mcp). */
+    description?: string;
     model?: string;
     systemPrompt?: string;
     thinkingLevel?: ThinkingLevel;

package/dist/clients/typescript.js

@@ -147,7 +147,7 @@ export function toolServer(tools) {
     };
 }
 /** The hosted runtime; `url` points elsewhere (a self-hosted runtime, or http://127.0.0.1:8790 in development). */
-export const DEFAULT_URL = "https://agents.camelai.dev";
+export const DEFAULT_URL = "https://run.camelai.com";
 export class AgentError extends Error {
     /** The HTTP status, or 0 for a failure that is not an HTTP response's (a run's, the connection's). */
     status;
@@ -703,7 +703,7 @@ export class AgentClient {
             }
         }
         const onEvent = this.options.onEvent;
-        if (!onEvent)
+        if (!onEvent || this.closed)
             return;
         if (this.queued >= MAX_QUEUED_EVENTS && event.type === "message_update") {
             if (this.dropped++ === 0)
@@ -712,8 +712,10 @@ export class AgentClient {
         }
         this.queued++;
         this.dispatching = this.dispatching.then(async () => {
+            // A closed client calls onEvent no more: events still queued are dropped.
             try {
-                await onEvent(event, requestId);
+                if (!this.closed)
+                    await onEvent(event, requestId);
             }
             catch (error) {
                 this.report(error);
@@ -1019,7 +1021,7 @@ export class AgentClient {
             waiter.reject(new AgentError("Client closed; request may still be running", 0, id));
         this.pending.clear();
         await this.loop;
-        // Events received before closing still reach onEvent, but a handler that never returns cannot hang shutdown.
+        // onEvent is called no more; the call in progress may finish, but one that never returns cannot hang shutdown.
         let timer;
         await Promise.race([this.dispatching, new Promise(resolve => { timer = setTimeout(resolve, 2000); })]);
         clearTimeout(timer);

package/dist/clients/watch.js

@@ -263,12 +263,13 @@ export function watchAgent(options) {
             }
             else
                 next = undefined;
-            // No turn in it: none runs, or the token does not show it. Its state says which, where the token reads it.
+            await newest();
+            // No turn in it: none runs, or the token does not show it. Its state says which, where the token reads it: read
+            // after history, so a run that began in between is running here too, never a message in history with no turn.
             if (!turn) {
                 const known = await json200("/state").catch(() => undefined);
                 state.running = !!known?.requests?.some(request => request.state === "running" && request.began && ["prompt", "continue", "resume"].includes(request.method));
             }
-            await newest();
             return;
         }
         if (data.type === "response") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camelai/run",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "description": "SDK for camelRun: define tools in your app, and the runtime runs the model loop, history and sandbox.",
   "type": "module",
   "license": "MIT",
@@ -66,7 +66,7 @@
   "dependencies": {
     "typebox": "1.1.38"
   },
-  "homepage": "https://agents.camelai.dev",
+  "homepage": "https://run.camelai.com",
   "peerDependencies": {
     "@modelcontextprotocol/sdk": "^1.30.1"
   },