@schlenkr/ragents 0.1.16 → 0.1.18

package/README.md

@@ -41,7 +41,11 @@ npm install -g @schlenkr/ragents
   ```
 
 - `workspace-client <server-url> [folder ...]` - register this machine and its folders as a
-  workspace for a server, so a run on that server works in these folders.
+  workspace for a server, so a run on that server works in these folders. Includes the same
+  ripgrep and Windows Bash as the VS Code extension. `RAGENTS_USER` and `RAGENTS_PASSWORD` in
+  the environment enable session renewal; `RAGENTS_TOKEN` supplies an existing or personal token.
+  Terminal or parent closure stops it and its children. Use `--detached` explicitly for nohup
+  or a service manager; SIGINT/SIGTERM still stop it.
 
   ```sh
   ragents workspace-client https://ragents.example.com ~/projects/demo

package/apps/web/dist/help/guide-distributed.html

@@ -130,7 +130,7 @@
       <a class="nav-github" href="https://github.com/SchlenkR/RAgents" aria-label="GitHub"><svg class="gh-icon" viewBox="0 0 24 24" aria-hidden="true"><path fill="currentColor" d="M12 2a10 10 0 0 0-3.2 19.5c.5.1.7-.2.7-.5v-1.7c-2.8.6-3.4-1.3-3.4-1.3-.5-1.2-1.1-1.5-1.1-1.5-.9-.6.1-.6.1-.6 1 .1 1.5 1 1.5 1 .9 1.6 2.4 1.1 3 .9.1-.7.4-1.1.6-1.4-2.2-.3-4.6-1.1-4.6-5 0-1.1.4-2 1-2.7-.1-.3-.4-1.3.1-2.7 0 0 .8-.3 2.8 1a9.6 9.6 0 0 1 5 0c1.9-1.3 2.8-1 2.8-1 .5 1.4.2 2.4.1 2.7.6.7 1 1.6 1 2.7 0 3.9-2.4 4.7-4.6 5 .4.3.7.9.7 1.9V21c0 .3.2.6.7.5A10 10 0 0 0 12 2Z"/></svg><span class="gh-label">GitHub</span></a>
     </nav>
     <button class="nav-menu" type="button" aria-expanded="false" aria-controls="main-navigation"><span data-menu-label>Menu</span><svg viewBox="0 0 24 24" aria-hidden="true"><path d="m6 9 6 6 6-6"/></svg></button>
-  </header><main class="shell" id="main"><div class="guide-layout"><aside class="guide-sidebar"><nav class="guide-chapters" aria-label="Guide navigation"><a href="guide.html">Overview</a><div class="guide-nav-group"><p>Understand</p><a href="guide-ideas.html">Core ideas</a><a href="guide-runtime.html">Actors and messages</a></div><div class="guide-nav-group"><p>Use</p><a href="guide-getting-started.html">Get started</a><a href="guide-clients.html">Web and VS Code</a><a href="guide-distributed.html" aria-current="page">Distributed work</a></div><div class="guide-nav-group"><p>Build</p><a href="guide-functions.html">Work with TypeScript</a><a href="guide-programs.html">Build mini-apps</a><a href="guide-plugins.html">Plugins and skills</a></div><div class="guide-nav-group"><p>Access</p><a href="guide-access.html">Assign permissions</a></div></nav></aside><details class="guide-mobile-nav"><summary>Guide: Distributed work</summary><nav class="guide-chapters" aria-label="Guide navigation"><a href="guide.html">Overview</a><div class="guide-nav-group"><p>Understand</p><a href="guide-ideas.html">Core ideas</a><a href="guide-runtime.html">Actors and messages</a></div><div class="guide-nav-group"><p>Use</p><a href="guide-getting-started.html">Get started</a><a href="guide-clients.html">Web and VS Code</a><a href="guide-distributed.html" aria-current="page">Distributed work</a></div><div class="guide-nav-group"><p>Build</p><a href="guide-functions.html">Work with TypeScript</a><a href="guide-programs.html">Build mini-apps</a><a href="guide-plugins.html">Plugins and skills</a></div><div class="guide-nav-group"><p>Access</p><a href="guide-access.html">Assign permissions</a></div></nav></details><article class="guide-body"><header class="guide-title"><p class="eyebrow"><a href="guide.html">Guide</a></p><h1>Distributed work</h1><p>Run the host locally or remotely, keep tools beside the project, and move runs between servers.</p></header><details class="guide-page-nav"><summary>On this page</summary><nav aria-label="On this page"><a href="#work-without-a-checkout">Work without a checkout</a><a href="#connect-to-a-server">Connect to a server</a><a href="#transfer-a-run">Transfer a run</a><a href="#work-on-windows">Work on Windows</a></nav></details><h2 id="work-without-a-checkout">Work without a checkout</h2>
+  </header><main class="shell" id="main"><div class="guide-layout"><aside class="guide-sidebar"><nav class="guide-chapters" aria-label="Guide navigation"><a href="guide.html">Overview</a><div class="guide-nav-group"><p>Understand</p><a href="guide-ideas.html">Core ideas</a><a href="guide-runtime.html">Actors and messages</a></div><div class="guide-nav-group"><p>Use</p><a href="guide-getting-started.html">Get started</a><a href="guide-clients.html">Web and VS Code</a><a href="guide-distributed.html" aria-current="page">Distributed work</a></div><div class="guide-nav-group"><p>Build</p><a href="guide-functions.html">Work with TypeScript</a><a href="guide-programs.html">Build mini-apps</a><a href="guide-plugins.html">Plugins and skills</a></div><div class="guide-nav-group"><p>Access</p><a href="guide-access.html">Assign permissions</a></div></nav></aside><details class="guide-mobile-nav"><summary>Guide: Distributed work</summary><nav class="guide-chapters" aria-label="Guide navigation"><a href="guide.html">Overview</a><div class="guide-nav-group"><p>Understand</p><a href="guide-ideas.html">Core ideas</a><a href="guide-runtime.html">Actors and messages</a></div><div class="guide-nav-group"><p>Use</p><a href="guide-getting-started.html">Get started</a><a href="guide-clients.html">Web and VS Code</a><a href="guide-distributed.html" aria-current="page">Distributed work</a></div><div class="guide-nav-group"><p>Build</p><a href="guide-functions.html">Work with TypeScript</a><a href="guide-programs.html">Build mini-apps</a><a href="guide-plugins.html">Plugins and skills</a></div><div class="guide-nav-group"><p>Access</p><a href="guide-access.html">Assign permissions</a></div></nav></details><article class="guide-body"><header class="guide-title"><p class="eyebrow"><a href="guide.html">Guide</a></p><h1>Distributed work</h1><p>Run the host locally or remotely, keep tools beside the project, and move runs between servers.</p></header><details class="guide-page-nav"><summary>On this page</summary><nav aria-label="On this page"><a href="#work-without-a-checkout">Work without a checkout</a><a href="#connect-to-a-server">Connect to a server</a><a href="#run-a-cli-workstation">Run a CLI workstation</a><a href="#transfer-a-run">Transfer a run</a><a href="#work-on-windows">Work on Windows</a></nav></details><h2 id="work-without-a-checkout">Work without a checkout</h2>
 <p>Using RAgents does not require a repository. <code>pnpm build:package</code> creates the npm package
 <code>@schlenkr/ragents</code> from this checkout in <code>dist/ragents</code>; with <code>--pack</code>, it also creates
 <code>dist/schlenkr-ragents-&lt;version&gt;.tgz</code>. The package contains the server, engine, executor, all
@@ -246,6 +246,22 @@ records only forwarded calls with user, alias, target, status, and token count.<
 starts with the new web interface as long as the host API stays the same. Otherwise the start
 refuses the fetched bundles, and <code>connect</code> names the version to install.</li>
 </ul>
+<h2 id="run-a-cli-workstation">Run a CLI workstation</h2>
+<p><code>ragents workspace-client &lt;server-url&gt; [folders ...]</code> registers this machine with the same tools
+and executor as the VS Code extension. No folder means the current directory; <code>--id</code> and <code>--label</code>
+set its stable identity and display name. The npm installation includes ripgrep on every supported
+platform and the curated Bash on Windows. Plugin tools are provisioned before registration.</p>
+<p>Set <code>RAGENTS_TOKEN</code> for a personal or existing session token. For automatic sign-in and renewal,
+configure <code>RAGENTS_USER</code> and <code>RAGENTS_PASSWORD</code> in the process environment. Neither is a command-line
+option. Invalid or absent credentials when sign-in is required produce a visible failure and a
+nonzero exit. A temporary connection loss reconnects and registers the workstation again.</p>
+<p>Closing the terminal or SSH session, closing stdin, or ending the owning process unregisters the
+workstation and stops its children. SIGINT, SIGTERM, and SIGHUP also stop it. For an intentional
+background service, pass <code>--detached</code> and let a service manager own it, or run:</p>
+<pre><code class="language-sh">nohup ragents workspace-client https://ragents.example.com /home/user/project --detached &gt;workspace.log 2&gt;&amp;1 &lt;/dev/null &amp;
+</code></pre>
+<p>The flag ignores terminal closure, parent loss, and SIGHUP; it does not daemonize. SIGINT and
+SIGTERM still unregister and shut down. Use the service manager&#39;s stop command to end a service.</p>
 <h2 id="transfer-a-run">Transfer a run</h2>
 <p>A run can move from one server to another and continue there, for example from a notebook to an
 always-on machine or from a central server to a developer for local inspection.</p>
@@ -299,13 +315,11 @@ otherwise it tells the model to exclude dependency and build folders from <code>
 contains no git, so your login works as usual: Git Credential Manager, <code>~/.gitconfig</code> and
 <code>~/.ssh</code>. On your own machine the bash inherits your whole environment, except the variables of
 VS Code itself and <code>BASH_ENV</code>/<code>ENV</code>.</li>
-<li><strong>Without the extension</strong> (<code>ragents start</code> or <code>ragents workspace-client</code> from the npm package)
-set <code>RAGENTS_BASH</code> to the <code>bash.exe</code> of such a bundle, for example
-<code>&lt;extension folder&gt;\dist\bash\win32-x64\usr\bin\bash.exe</code>. Without it every <code>bash</code> call fails
-and names what is missing. <code>RAGENTS_RG</code> names an <code>rg</code> in the same way, for example
-<code>&lt;extension folder&gt;\dist\rg\win32-x64\rg.exe</code>, on every platform; without it, an <code>rg</code> on
-<code>PATH</code> is used if there is one. A <code>RAGENTS_RG</code> that points to a missing file stops the server
-start or the workstation&#39;s registration.</li>
+<li><strong>CLI workstation</strong> (<code>ragents workspace-client</code>) carries the same Bash and ripgrep as the
+extension. npm installs only the optional tools package for this machine; keep optional
+dependencies enabled. A checkout uses the extension build from <code>pnpm bundle:rg</code> and
+<code>pnpm bundle:bash</code>. A standalone server (<code>ragents start</code>) still takes <code>RAGENTS_BASH</code> and
+<code>RAGENTS_RG</code> from its environment; these variables do not override workstation bundles.</li>
 <li><strong>Node.js</strong> is enough with <code>@schlenkr/ragents</code>. A checkout additionally needs <strong>pnpm</strong>, and
 <code>pnpm install</code>, <code>pnpm build:agent</code>, and <code>scripts/start.sh</code> need a bash of your own, such as
 Git Bash.</li>

package/apps/web/dist/help/guide-distributed.md

@@ -143,6 +143,29 @@ expose only the alias.
   starts with the new web interface as long as the host API stays the same. Otherwise the start
   refuses the fetched bundles, and `connect` names the version to install.
 
+## Run a CLI workstation
+
+`ragents workspace-client <server-url> [folders ...]` registers this machine with the same tools
+and executor as the VS Code extension. No folder means the current directory; `--id` and `--label`
+set its stable identity and display name. The npm installation includes ripgrep on every supported
+platform and the curated Bash on Windows. Plugin tools are provisioned before registration.
+
+Set `RAGENTS_TOKEN` for a personal or existing session token. For automatic sign-in and renewal,
+configure `RAGENTS_USER` and `RAGENTS_PASSWORD` in the process environment. Neither is a command-line
+option. Invalid or absent credentials when sign-in is required produce a visible failure and a
+nonzero exit. A temporary connection loss reconnects and registers the workstation again.
+
+Closing the terminal or SSH session, closing stdin, or ending the owning process unregisters the
+workstation and stops its children. SIGINT, SIGTERM, and SIGHUP also stop it. For an intentional
+background service, pass `--detached` and let a service manager own it, or run:
+
+```sh
+nohup ragents workspace-client https://ragents.example.com /home/user/project --detached >workspace.log 2>&1 </dev/null &
+```
+
+The flag ignores terminal closure, parent loss, and SIGHUP; it does not daemonize. SIGINT and
+SIGTERM still unregister and shut down. Use the service manager's stop command to end a service.
+
 ## Transfer a run
 
 A run can move from one server to another and continue there, for example from a notebook to an
@@ -203,13 +226,11 @@ The local host and workspace also run on Windows. Requirements are:
   contains no git, so your login works as usual: Git Credential Manager, `~/.gitconfig` and
   `~/.ssh`. On your own machine the bash inherits your whole environment, except the variables of
   VS Code itself and `BASH_ENV`/`ENV`.
-- **Without the extension** (`ragents start` or `ragents workspace-client` from the npm package)
-  set `RAGENTS_BASH` to the `bash.exe` of such a bundle, for example
-  `<extension folder>\dist\bash\win32-x64\usr\bin\bash.exe`. Without it every `bash` call fails
-  and names what is missing. `RAGENTS_RG` names an `rg` in the same way, for example
-  `<extension folder>\dist\rg\win32-x64\rg.exe`, on every platform; without it, an `rg` on
-  `PATH` is used if there is one. A `RAGENTS_RG` that points to a missing file stops the server
-  start or the workstation's registration.
+- **CLI workstation** (`ragents workspace-client`) carries the same Bash and ripgrep as the
+  extension. npm installs only the optional tools package for this machine; keep optional
+  dependencies enabled. A checkout uses the extension build from `pnpm bundle:rg` and
+  `pnpm bundle:bash`. A standalone server (`ragents start`) still takes `RAGENTS_BASH` and
+  `RAGENTS_RG` from its environment; these variables do not override workstation bundles.
 - **Node.js** is enough with `@schlenkr/ragents`. A checkout additionally needs **pnpm**, and
   `pnpm install`, `pnpm build:agent`, and `scripts/start.sh` need a bash of your own, such as
   Git Bash.

package/apps/web/dist/host-web.json

@@ -138,6 +138,6 @@
     "packages/ragents/src/rpc/peer.ts": "9050dff218bdc6603478a77bdca241629f55c03b65f6efe7df598b53446b4c09",
     "packages/ragents/src/rpc/protocol.ts": "82bbcb8181a2f90708dc607922fef4a9d472cd82d6dede09324df778773699a6",
     "packages/ragents/src/runtime/domain-error.ts": "d6bf8fa09769c4137e616c83a84cb9c05a58bfa6c2e32c9404a1c202815837a4",
-    "pnpm-lock.yaml": "7a0ed220c7b68d8da22c5b6df864934dafa53aecad8e61d438ee86ddf79ee108"
+    "pnpm-lock.yaml": "2428bb94f1bb44305e258747adef0db465a9dcceacc8eb901d082e3acfd06b2f"
   }
 }

package/apps/web/src/server-client.ts

@@ -0,0 +1,165 @@
+import type { AccessSnapshot } from "../../../packages/ragents/src/access";
+import { accessSnapshotFrom } from "./access-session";
+import { RpcClient } from "./rpc/client";
+
+export class ServerError extends Error {
+  constructor(message: string, readonly status: number, readonly code?: string) {
+    super(message);
+    this.name = "ServerError";
+  }
+}
+
+export class UnreachableError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = "UnreachableError";
+  }
+}
+
+const sessionTokenFrom = (setCookie: readonly string[]): string => {
+  for (const cookie of setCookie) {
+    const pair = cookie.split(";")[0] ?? "";
+    const token = pair.slice(pair.indexOf("=") + 1).trim();
+    if (/^[A-Za-z0-9_-]{43}$/.test(token)) return token;
+  }
+  throw new ServerError("The server did not deliver a session token.", 500);
+};
+
+const errorFrom = async (response: Response): Promise<ServerError> => {
+  let message = `The server responded with ${response.status}.`;
+  let code: string | undefined;
+  try {
+    const body = await response.json() as { error?: unknown; message?: unknown; code?: unknown };
+    if (typeof body.error === "string" && body.error) message = body.error;
+    else if (typeof body.message === "string" && body.message) message = body.message;
+    if (typeof body.code === "string") code = body.code;
+  } catch {}
+  return new ServerError(message, response.status, code);
+};
+
+/** A workstation's access: sign-in and delivery over HTTP, everything else as JSON-RPC; the session token goes as bearer. */
+export interface SignInOptions {
+  readonly credentials: () => Promise<{ id: string; password: string } | undefined>;
+  readonly onToken?: (token: string) => Promise<void>;
+  readonly log?: (line: string) => void;
+}
+
+export class ServerClient {
+  #authenticating: Promise<boolean> | undefined;
+  #signInFailure: string | undefined;
+  readonly origin: string;
+  readonly rpc: RpcClient;
+
+  constructor(readonly baseUrl: string, private token: string | undefined, private readonly request: typeof fetch = fetch, private readonly signIn?: SignInOptions) {
+    this.origin = new URL(baseUrl).origin;
+    this.rpc = new RpcClient({
+      baseUrl: this.origin,
+      fetch: (input, init) => this.#authorized(input, init),
+    });
+  }
+
+  signInFailure(): string | undefined {
+    return this.#signInFailure;
+  }
+
+  async #authorized(input: Parameters<typeof fetch>[0], init?: RequestInit): Promise<Response> {
+    const token = this.token;
+    const send = () => this.request(input, { ...init, headers: this.headers(init?.headers as Record<string, string> | undefined ?? {}) });
+    const response = await send();
+    if (response.status !== 401 || !this.signIn || init?.signal?.aborted) return response;
+    const rejection = await response.clone().json().catch(() => undefined) as { code?: unknown } | undefined;
+    if (rejection?.code !== "login-required") {
+      this.#signInFailure = "Access token required: this server does not accept automatic user/password sign-in. Supply a valid access token.";
+      return response;
+    }
+    if (token === this.token) {
+      this.#authenticating ??= this.#authenticate().finally(() => { this.#authenticating = undefined; });
+      if (!await this.#authenticating) return response;
+    }
+    if (init?.signal?.aborted) return response;
+    await response.body?.cancel();
+    const retried = await send();
+    if (retried.status === 401) this.#signInFailure = "Sign-in required: the server rejected the renewed session.";
+    return retried;
+  }
+
+  async #authenticate(): Promise<boolean> {
+    try {
+      const credentials = await this.signIn!.credentials();
+      if (!credentials) {
+        this.#signInFailure = "Sign-in required: no credentials are configured for session renewal.";
+        return false;
+      }
+      this.signIn!.log?.(`== Signing in to ${this.origin} with configured credentials`);
+      const { token } = await this.login(credentials.id, credentials.password);
+      await this.signIn!.onToken?.(token);
+      this.useToken(token);
+      this.#signInFailure = undefined;
+      return true;
+    } catch {
+      this.#signInFailure = "Sign-in required: automatic sign-in failed. Check the configured credentials and server availability.";
+      return false;
+    }
+  }
+
+  get hasToken(): boolean {
+    return this.token !== undefined;
+  }
+
+  get accessToken(): string | undefined {
+    return this.token;
+  }
+
+  /** The client reads the token on every request, so the messaging layer stays in place. */
+  useToken(token: string | undefined): void {
+    this.token = token;
+  }
+
+  url(path: string): string {
+    return new URL(path, `${this.origin}/`).toString();
+  }
+
+  headers(extra: Record<string, string> = {}): Record<string, string> {
+    return this.token === undefined ? extra : { ...extra, authorization: `Bearer ${this.token}` };
+  }
+
+  async fetch(path: string, init: RequestInit = {}): Promise<Response> {
+    try {
+      return await this.#authorized(this.url(path), init);
+    } catch (cause) {
+      throw new UnreachableError(`${this.origin} is unreachable: ${cause instanceof Error ? cause.message : String(cause)}`);
+    }
+  }
+
+  async json<T>(path: string, init: RequestInit = {}, validate: (value: unknown) => T = (value) => value as T): Promise<T> {
+    const response = await this.fetch(path, init);
+    if (!response.ok) throw await errorFrom(response);
+    return validate(await response.json());
+  }
+
+  async access(): Promise<AccessSnapshot> {
+    const snapshot = await this.json("/api/access", { cache: "no-store" }, accessSnapshotFrom);
+    if (!snapshot.enabled || snapshot.user || !this.signIn) return snapshot;
+    this.#authenticating ??= this.#authenticate().finally(() => { this.#authenticating = undefined; });
+    return await this.#authenticating ? this.json("/api/access", { cache: "no-store" }, accessSnapshotFrom) : snapshot;
+  }
+
+  async login(id: string, password: string): Promise<{ snapshot: AccessSnapshot; token: string }> {
+    const response = await this.request(this.url("/api/access/login"), {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ id, password }),
+      signal: AbortSignal.timeout(10_000),
+      redirect: "error",
+    });
+    if (!response.ok) throw await errorFrom(response);
+    const snapshot = accessSnapshotFrom(await response.json());
+    if (!snapshot.user) throw new ServerError("The server did not confirm the sign-in.", 500);
+    return { snapshot, token: sessionTokenFrom(response.headers.getSetCookie()) };
+  }
+
+  async logout(): Promise<void> {
+    const response = await this.fetch("/api/access/logout", { method: "POST" });
+    if (!response.ok && response.status !== 401) throw await errorFrom(response);
+  }
+}

package/bundles/ragents.activity/ragents-bundle.json

@@ -23,7 +23,7 @@
     }
   },
   "revision": "b7b04d050f5f4bcb0980880167b8e2cdd3ad533ba07f589dd0de471b9e55c0fd",
-  "sourceRevision": "047290b262944aedbbbb4c4a819509c4bc3a7e0df4fa76b38d9e21ebe5626828",
+  "sourceRevision": "51444903dfadf6f23f55ad0369575949aec7fd1696b5f34450834d06a3fd23ed",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.actor-programs/ragents-bundle.json

@@ -195,7 +195,7 @@
     }
   },
   "revision": "15fc5afb9aac414335069c28989cae4fa95fec8a2937584f8497a42ce01ffaba",
-  "sourceRevision": "6abd7c9e82683655c2bf5010641391a3960ccf495729a87ef00ef58cfb07f7af",
+  "sourceRevision": "1e6b4725db96bd433b77a1f09f751a41152f77d2d394736bc51886b32ccdd691",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.ask/ragents-bundle.json

@@ -72,7 +72,7 @@
     }
   },
   "revision": "0c115b8cade07b18dee1b1d11200bbc0427d98d13d0315d9bd47c8619ded8fbc",
-  "sourceRevision": "79645163f0f2b1d740c94f0d0fd881b5a55bee6bcf7af7b21b827b7254e7b4c5",
+  "sourceRevision": "ce0c0ff38394586fe032f02838bd9fcf644642c31f4a08f1575ca2aaade7bfbf",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.browser/ragents-bundle.json

@@ -32,7 +32,7 @@
     "web": {}
   },
   "revision": "333c6a9b57576a4ab95556e201da67ed864acdf02787ce5edbd653e7beba6020",
-  "sourceRevision": "6c3246a05b9b6ddc46373f88bca9113a2b1705487b4de41711be7f5ccb5617f3",
+  "sourceRevision": "43dc6b7d6064ff67e5bbd6ab2a32ee77bca8e562a2c1566fb223ec2f7d5c6792",
   "server": "server/index.js",
   "executor": "executor/index.mjs",
   "exports": {

package/bundles/ragents.documents/ragents-bundle.json

@@ -101,7 +101,7 @@
     }
   },
   "revision": "3fdba8c39f30027176229901cf731b778170f0e1597c287ad94f7e48a430b5e8",
-  "sourceRevision": "8875b59b406fa0e663b9f69dff1f6525bff867dca5947d3e114084650393ebf2",
+  "sourceRevision": "4ec5929328998f6fff1cb2d4dd5a97d8d2352b1b858e4a88706728eafe2fead1",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.lsp-fsharp/ragents-bundle.json

@@ -29,7 +29,7 @@
     }
   },
   "revision": "a39dafc264c6703d9481f358b21e5bf3997dc5d2dc7fe0d969d4905d49c7a1f8",
-  "sourceRevision": "4ff8724bbc7065832b907cfc53ea561fa4df3e8802f2937e0df6963840baba31",
+  "sourceRevision": "0c1724bed58160a4bfb446c45ef22ea4fa063a43b358d7c78ef64b220b36f653",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.lsp-roslyn/ragents-bundle.json

@@ -41,7 +41,7 @@
     }
   },
   "revision": "cbe81aa88a4ea56476537fabbbb0995d09ccbfa269dd6a003df50a57c8286b02",
-  "sourceRevision": "0bb27e39ad643657c464d5c3c28d045ed71c2164dea8e76c4c0ffe491a84442a",
+  "sourceRevision": "f351e54c82571eb6cde2b5e75379e9d6f13e8f57b38bd36d661e68b53d2e355d",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.lsp-typescript/ragents-bundle.json

@@ -18,7 +18,7 @@
     }
   },
   "revision": "8387de707a4fe8fdb8c67315346522b331728f8adf51a7fadda8db662681f0c4",
-  "sourceRevision": "9b9bdd5a6858ef808ae2541fefb7cb0262e4bc963cfb0674166ff9a29da22c5c",
+  "sourceRevision": "b188ca64f6ebf562df726715a505837a537cf9a432d549dc3dbec205ed8ff5ab",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.model-relay/ragents-bundle.json

@@ -26,7 +26,7 @@
     "web": {}
   },
   "revision": "9090692eca49235944f149b25dccdc986a3c638007d8da2fb35f74d942454379",
-  "sourceRevision": "9548157817cee5c693da03f3a7e0f37e1099915826ef682cb0339a32736b70ef",
+  "sourceRevision": "f57ee897c518cd93bc1a089c0e37ed0154b04da83549ecedcc3c340ab1e36c62",
   "server": "server/index.js",
   "exports": {
     "server": {},

package/bundles/ragents.orchestration/ragents-bundle.json

@@ -173,7 +173,7 @@
     }
   },
   "revision": "cbd72b88af0c8ac76486b4c0617545fc53b23315cf93dd924631ceb8e389b34b",
-  "sourceRevision": "306e4ba17b1cae6ee69a03bf8dd492a61b51eccc426b68bb55ab9b6721f08e0c",
+  "sourceRevision": "2a6a34d768f487b027fbffac38beed2afb04c8bbec3311d8f05ce7cd5d90ef4c",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.overseer/ragents-bundle.json

@@ -130,7 +130,7 @@
     }
   },
   "revision": "58b8b02a346c4323afdef69cfd96b8f3717806919f2c46f146bcc803ef12bac4",
-  "sourceRevision": "9310057d7fc569e6a0d103d727131e6644899a9ccf17c9ba79680cc3539c9a16",
+  "sourceRevision": "23351003ee6534e2535ca08493c457c7366047bd1b4de4ef267fcac618bdef37",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.processes/ragents-bundle.json

@@ -78,7 +78,7 @@
     }
   },
   "revision": "e602a8711818533fc7372c5cb2ca51ae55362079d9944da008db9084621b5ccc",
-  "sourceRevision": "0d7379e3a1c3fe42300ff72891203b4c4c043ce8720e58152358571b7af8adf1",
+  "sourceRevision": "7913d1ad21363aa3742d7c2b5b32ab7b3be49aeef8d9fc3c9a5caf5df28cab2c",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.product/ragents-bundle.json

@@ -76,7 +76,7 @@
     }
   },
   "revision": "7a3eb7a847ce6a4c8324b9c073c3c7a13c760088a194d419fe21342575c4208f",
-  "sourceRevision": "7c8b3522ee90f89a7d3941ea396c458980ac53c83fa5096eab5a19b5f1a7aa81",
+  "sourceRevision": "9164cdb7e60d692e88452d5f24dbd6bbbcb8e9eafff911e84726d3cad345cb10",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.profile-distribution/ragents-bundle.json

@@ -53,7 +53,7 @@
     "web": {}
   },
   "revision": "3e99cf5cb8921685ad83aa6aaf9657da4c648f9d68cb744988a73f227c342e1d",
-  "sourceRevision": "cbf9d98fe42583b619b84425e648666df7cafd04930cf0692b43a5943fb4bd39",
+  "sourceRevision": "37a64513c41b585ecfef5171e26eac917e7cb69f069e057f0f62bbc3bfbba29e",
   "server": "server/index.js",
   "exports": {
     "server": {},

package/bundles/ragents.reference/ragents-bundle.json

@@ -21,7 +21,7 @@
     }
   },
   "revision": "2c684e9daab9b2ffe4c002c03d4fa8549b2d4dd0b20513fb5eec0e4f10a396ee",
-  "sourceRevision": "0f2f0bb43908bed73e743ed21d07d35abed4bcc84563c893c5c32117ad559ade",
+  "sourceRevision": "3e5f750bd9f707910743092b94df19a6b9bf9956ad7ab33818b5cd820bb85075",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.todo/ragents-bundle.json

@@ -33,7 +33,7 @@
     }
   },
   "revision": "5e18b249f3c8b53b61820ef05da59823d58163c6962e6d836dcb37c05034aad0",
-  "sourceRevision": "e69f899d1733ba54341bfc2fd8c6adbf6025126a4b21a74bdd8206378e86b87e",
+  "sourceRevision": "1c5eafe2e0da0c98f0c03b6cdd33b3d3cddc799da393df6a94c6d290fb285cbd",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.transcript/ragents-bundle.json

@@ -23,7 +23,7 @@
     "web": {}
   },
   "revision": "e3bb513053f6385f9d78d314d28302324095a5163c4e1563df6fc8b3251305f7",
-  "sourceRevision": "7df3be99d8024c7878a0afe2bcd698909b6389f4484d98f84a0e3bdead954ab4",
+  "sourceRevision": "840c4195ce48a06cc8c49513c96a94381e7d8e10802f8835e3aab1c6ece01118",
   "server": "server/index.js",
   "exports": {
     "server": {},

package/bundles/ragents.watch/ragents-bundle.json

@@ -25,7 +25,7 @@
     "web": {}
   },
   "revision": "007ee50ab186e3070930f23e9795210fa36c723365657325d5440cc2f0b81d60",
-  "sourceRevision": "1ce434ee7a1752f72e3d7160d895130948b8bcd5bba466f5555fff6ff278cd19",
+  "sourceRevision": "8cec5a0d238ff52a630bd3f822cf95ea9a640626c8c7345def28c4f1feabff10",
   "server": "server/index.js",
   "exports": {
     "server": {

package/bundles/ragents.workspace/ragents-bundle.json

@@ -137,7 +137,7 @@
     }
   },
   "revision": "db9370b7b3449c44be49986b074806351b857c430963aa878e209d2d5c9ba4f8",
-  "sourceRevision": "f91d81de973c9c7b46f1882a8cb4f067fbdf72c2e7617f24f8865f92d9ed05bc",
+  "sourceRevision": "25a05a48b591f8f4b575b06d495f7f191037d7419b79a98ad321328c455f4e0d",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schlenkr/ragents",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "RAgents host: server, engine, plugins and tools without a source checkout",
   "keywords": [
     "agents",
@@ -50,6 +50,7 @@
     "dompurify": "3.4.13",
     "elkjs": "0.12.0",
     "esbuild": "0.28.2",
+    "eventsource-parser": "3.1.1",
     "handlebars": "4.7.9",
     "highlight.js": "11.12.0",
     "lucide-react": "1.46.0",
@@ -69,7 +70,15 @@
     "vscode-jsonrpc": "9.0.2",
     "yaml": "2.9.0"
   },
+  "optionalDependencies": {
+    "@schlenkr/ragents-tools-win32-x64": "0.1.18",
+    "@schlenkr/ragents-tools-win32-arm64": "0.1.18",
+    "@schlenkr/ragents-tools-darwin-x64": "0.1.18",
+    "@schlenkr/ragents-tools-darwin-arm64": "0.1.18",
+    "@schlenkr/ragents-tools-linux-x64": "0.1.18",
+    "@schlenkr/ragents-tools-linux-arm64": "0.1.18"
+  },
   "ragents": {
-    "hostVersion": "cbd2d641afb2ae43222b6a82d08f37f5e0cd1b74"
+    "hostVersion": "6f896323c8bdb2622d4dc9459a901949bf5fae33"
   }
 }

package/packages/ai/dist/api/openai-compatible-response.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeOpenAiResponse(response: Response): Promise<Response>;
+//# sourceMappingURL=openai-compatible-response.d.ts.map

package/packages/ai/package.json

@@ -29,6 +29,7 @@
 	"dependencies": {
 		"@openrouter/ai-sdk-provider": "^3.0.0",
 		"ai": "^7.0.99",
+		"eventsource-parser": "3.1.1",
 		"partial-json": "0.1.7",
 		"typebox": "1.1.38"
 	},

package/packages/ai/src/api/ai-sdk-transport.ts

@@ -1,6 +1,7 @@
 import { createOpenRouter } from "@openrouter/ai-sdk-provider";
 import type { Model, ProviderHeaders } from "../types.ts";
 import { headersToRecord } from "../utils/headers.ts";
+import { normalizeOpenAiResponse } from "./openai-compatible-response.ts";
 
 interface SdkOptions<TModel> {
 	apiKey?: string;
@@ -43,9 +44,10 @@ export function createSdkProvider<TModel extends Model<string>>(model: TModel, o
 			});
 			try {
 				await options?.onResponse?.({ status: response.status, headers: headersToRecord(response.headers) }, model);
-				return response;
+				return model.baseUrl && new URL(model.baseUrl).hostname !== "openrouter.ai"
+					? await normalizeOpenAiResponse(response) : response;
 			} catch (error) {
-				await response.body?.cancel();
+				if (!response.body?.locked) await response.body?.cancel();
 				throw error;
 			}
 		},

package/packages/ai/src/api/openai-compatible-response.ts

@@ -0,0 +1,60 @@
+import { EventSourceParserStream, type EventSourceMessage } from "eventsource-parser/stream";
+
+function isObject(value: unknown): value is Record<string, unknown> {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+
+function omitNulls(value: Record<string, unknown>, fields: readonly string[]) {
+	for (const field of fields) if (value[field] === null) delete value[field];
+}
+
+function normalizeCompletion(value: unknown): unknown {
+	if (!isObject(value) || !Array.isArray(value.choices)) return value;
+	for (const choice of value.choices) {
+		if (!isObject(choice)) continue;
+		for (const kind of ["delta", "message"] as const) {
+			const message = choice[kind];
+			if (!isObject(message)) continue;
+			omitNulls(message, [
+				"content", "reasoning", "reasoning_content", "reasoning_text", "reasoning_details",
+				"tool_calls", "refusal", "audio", "function_call", "images", "annotations",
+			]);
+			if (kind === "delta") omitNulls(message, ["role"]);
+			if (kind === "message" && message.reasoning === undefined && typeof message.reasoning_content === "string") {
+				message.reasoning = message.reasoning_content;
+			}
+			if (!Array.isArray(message.tool_calls)) continue;
+			for (const tool of message.tool_calls) {
+				if (!isObject(tool)) continue;
+				if (tool.type == null && isObject(tool.function)) tool.type = "function";
+				if (isObject(tool.function)) omitNulls(tool.function, ["arguments"]);
+			}
+		}
+	}
+	return value;
+}
+
+export async function normalizeOpenAiResponse(response: Response): Promise<Response> {
+	if (!response.ok || !response.body) return response;
+	const contentType = response.headers.get("content-type")?.split(";")[0]?.trim().toLowerCase();
+	const headers = new Headers(response.headers);
+	headers.delete("content-length");
+	headers.delete("content-encoding");
+	const init = { status: response.status, statusText: response.statusText, headers };
+	if (contentType === "application/json") {
+		return new Response(JSON.stringify(normalizeCompletion(await response.json())), init);
+	}
+	if (contentType !== "text/event-stream") return response;
+	const body = response.body
+		.pipeThrough(new TextDecoderStream())
+		.pipeThrough(new EventSourceParserStream())
+		.pipeThrough(new TransformStream<EventSourceMessage, string>({
+			transform(event, controller) {
+				const data = event.data.trim() === "[DONE]" ? "[DONE]" : JSON.stringify(normalizeCompletion(JSON.parse(event.data)));
+				const metadata = `${event.id === undefined ? "" : `id: ${event.id}\n`}${event.event === undefined ? "" : `event: ${event.event}\n`}`;
+				controller.enqueue(`${metadata}data: ${data}\n\n`);
+			},
+		}))
+		.pipeThrough(new TextEncoderStream());
+	return new Response(body, init);
+}