@runappsai/sdk 0.6.3 → 0.6.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runappsai/sdk",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "description": "JavaScript / TypeScript client for the RunApps AI Gateway",
   "license": "MIT",
   "author": "RunApps",

package/src/activity-tracker.ts

@@ -215,6 +215,8 @@ export class ActivityTracker {
   private onEnd(e: RequestEndEvent): void {
     const call = this.active.get(e.id);
     this.active.delete(e.id);
+    // File calls only show while in flight: nothing to list or add up.
+    if (e.capability === "files") return;
     this.pushRecent({
       id: e.id,
       model: e.model,
@@ -233,6 +235,12 @@ export class ActivityTracker {
   private onError(e: RequestErrorEvent): void {
     const call = this.active.get(e.id);
     this.active.delete(e.id);
+    if (e.capability === "files") {
+      // Not listed; the LED goes red for a moment unless it was only a
+      // missing file, which apps probe for routinely.
+      if (e.statusCode !== 404) this.lastErrorAt = Date.now();
+      return;
+    }
     this.pushRecent({
       id: e.id,
       model: e.model,

package/src/browser-auth.ts

@@ -985,12 +985,15 @@ function mountActivityBadge(opts: MountOpts): HTMLButtonElement {
   const led = document.createElement("span");
   led.style.cssText = [
     "position:absolute",
-    "bottom:-2px;right:-2px",
-    "width:8px;height:8px;border-radius:50%",
+    "bottom:-1px;right:-1px",
+    "width:7px;height:7px;border-radius:50%",
     "background:rgba(255,255,255,0.2)",
-    "border:2px solid rgba(15,15,20,1)",
+    "border:1.5px solid rgba(15,15,20,1)",
     "box-shadow:0 0 0 0 transparent",
-    "transition:background-color 150ms ease-out, box-shadow 200ms ease-out",
+    // Hidden at rest: it only appears while something is happening
+    // (syncing, offline, an error, the green flash after a sync).
+    "opacity:0",
+    "transition:background-color 150ms ease-out, box-shadow 200ms ease-out, opacity 200ms ease-out",
     "pointer-events:none",
   ].join(";");
 
@@ -1276,6 +1279,7 @@ function mountActivityBadge(opts: MountOpts): HTMLButtonElement {
       // No event bus → static badge. Hide ring + LED.
       ring.style.opacity = "0";
       led.style.background = "rgba(255,255,255,0.2)";
+      led.style.opacity = "0";
       return;
     }
     const snap = tracker.snapshot();
@@ -1383,6 +1387,7 @@ function syncedPing(avatarWrap: HTMLElement, led: HTMLSpanElement): void {
   avatarWrap.appendChild(ping);
   setTimeout(() => ping.remove(), 1000); // in case animationend never fires
   syncFlashUntil = Date.now() + 1200;
+  led.style.opacity = "1";
   led.style.background = "#10b981";
   led.style.boxShadow = "0 0 0 2px rgba(16,185,129,0.35)";
   led.style.animation = "";
@@ -1390,12 +1395,14 @@ function syncedPing(avatarWrap: HTMLElement, led: HTMLSpanElement): void {
     // Back to the resting colour once the flash is over.
     if (Date.now() >= syncFlashUntil) {
       led.style.background = "rgba(255,255,255,0.2)";
+      led.style.opacity = "0";
       led.style.boxShadow = "0 0 0 0 transparent";
     }
   }, 1250);
 }
 
 function updateLED(led: HTMLSpanElement, snap: ActivitySnapshot): void {
+  led.style.opacity = "1"; // the resting branches below hide it again
   switch (snap.status) {
     case "idle": {
       // Nothing in flight: the LED shows the sync instead — blue pulse
@@ -1416,6 +1423,7 @@ function updateLED(led: HTMLSpanElement, snap: ActivitySnapshot): void {
         led.style.animation = "";
       } else {
         led.style.background = "rgba(255,255,255,0.2)";
+      led.style.opacity = "0";
         led.style.boxShadow = "0 0 0 0 transparent";
         led.style.animation = "";
       }

package/src/client.ts

@@ -248,7 +248,7 @@ export class RunApps {
     // `project` also scopes the file URLs (/v1/p/<project>/files/...),
     // so two apps never issue byte-identical file requests.  Omitted →
     // legacy unscoped /v1/files/... paths.
-    this.files = new FilesService(transport, options.project);
+    this.files = new FilesService(transport, options.project, this.events);
     this.embeddings = new EmbeddingsService(transport, this.events);
 
     // Sync: an app on RunApps gets it unless it says no. It
@@ -259,7 +259,9 @@ export class RunApps {
       const auth = this.auth;
       const engine = new SyncEngine(
         {
-          remote: new FilesRemote(this.files),
+          // Its own file service, without the event bus: sync traffic
+          // must not spin the badge every minute.
+          remote: new FilesRemote(new FilesService(transport, options.project)),
           events: this.events,
           userId: () => auth.ownerId(),
           onAuthChange: (cb) => auth.onTokenChange(() => cb()),

package/src/events.ts

@@ -32,7 +32,10 @@ export type SDKCapability =
   | "text_to_speech"
   | "speech_to_text"
   | "video_generation"
-  | "computer_use";
+  | "computer_use"
+  /** A file-space call (`client.files`). Shown on the badge while in
+   *  flight and on failure, but not listed or charged per call. */
+  | "files";
 
 /** Fired the moment a request hits the wire. */
 export interface RequestStartEvent {

package/src/files.ts

@@ -8,6 +8,8 @@
 // token (rrt_*) issued by the grant flow.
 
 import type { Transport } from "./transport.js";
+import type { SDKEvents } from "./events.js";
+import { wrapEvents } from "./event-wrap.js";
 
 export interface FileObject {
   path: string;
@@ -121,12 +123,21 @@ export class FilesService {
   constructor(
     private readonly transport: Transport,
     project?: string,
+    /** When given, every call emits request:start / end / error so the
+     *  badge can show it in flight; the sync engine's own file traffic
+     *  uses a service without one. */
+    private readonly events?: SDKEvents,
   ) {
     this.base = project
       ? "/v1/p/" + encodeURIComponent(project) + "/files"
       : "/v1/files";
   }
 
+  /** Run one file call, with badge events when the service has a bus. */
+  private run<T>(op: string, fn: () => Promise<T>): Promise<T> {
+    return this.events ? wrapEvents(this.events, { model: op, capability: "files" }, fn) : fn();
+  }
+
   /**
    * Upload `body` to `path`.  Returns the resulting FileObject — its
    * `url` is the stable public address for that path.
@@ -143,11 +154,11 @@ export class FilesService {
     const headers: Record<string, string> = {};
     if (opts?.ifNoneMatch) headers["If-None-Match"] = "*";
     if (opts?.ifMatch) headers["If-Match"] = `"${opts.ifMatch.replace(/"/g, "")}"`;
-    return this.transport.putBytes<FileObject>(pathToURL(this.base, path), body, {
+    return this.run("files.put", () => this.transport.putBytes<FileObject>(pathToURL(this.base, path), body, {
       contentType: opts?.contentType,
       headers: Object.keys(headers).length ? headers : undefined,
       signal: opts?.signal,
-    });
+    }));
   }
 
   /** Convenience: upload string content with sensible content-type. */
@@ -178,6 +189,10 @@ export class FilesService {
    * still the version that was read.
    */
   async read(path: string, init?: { signal?: AbortSignal; ifNoneMatch?: string }): Promise<FileRead> {
+    return this.run("files.read", () => this.readRaw(path, init));
+  }
+
+  private async readRaw(path: string, init?: { signal?: AbortSignal; ifNoneMatch?: string }): Promise<FileRead> {
     const { data, contentType, etag, notModified } = await this.transport.getRaw(pathToURL(this.base, path), init);
     return {
       blob: new Blob([new Uint8Array(data)], { type: contentType || "application/octet-stream" }),
@@ -212,7 +227,7 @@ export class FilesService {
 
   /** Stat: HEAD-only object metadata. */
   async stat(path: string, init?: { signal?: AbortSignal }): Promise<FileObject> {
-    const { status, headers } = await this.transport.head(pathToURL(this.base, path), init);
+    const { status, headers } = await this.run("files.stat", () => this.transport.head(pathToURL(this.base, path), init));
     if (status === 404) {
       throw Object.assign(new Error("not found"), { status: 404 });
     }
@@ -231,13 +246,13 @@ export class FilesService {
 
   /** Returns true iff the path resolves to an existing object. */
   async exists(path: string, init?: { signal?: AbortSignal }): Promise<boolean> {
-    const { status } = await this.transport.head(pathToURL(this.base, path), init);
+    const { status } = await this.run("files.exists", () => this.transport.head(pathToURL(this.base, path), init));
     return status >= 200 && status < 400;
   }
 
   /** Delete the object at `path`.  Idempotent. */
   async del(path: string, init?: { signal?: AbortSignal }): Promise<void> {
-    await this.transport.deletePath<{ ok: boolean }>(pathToURL(this.base, path), init);
+    await this.run("files.del", () => this.transport.deletePath<{ ok: boolean }>(pathToURL(this.base, path), init));
   }
 
   /** List objects.  Pass an empty / omitted prefix for the root. */
@@ -248,10 +263,10 @@ export class FilesService {
     if (opts?.limit) params.set("limit", String(opts.limit));
     if (opts?.glob) params.set("glob", opts.glob);
     const qs = params.toString();
-    return this.transport.getJSON<FileListResult>(
+    return this.run("files.list", () => this.transport.getJSON<FileListResult>(
       this.base + (qs ? "?" + qs : ""),
       opts?.signal ? { signal: opts.signal } : undefined,
-    );
+    ));
   }
 
   /**
@@ -268,21 +283,21 @@ export class FilesService {
     opts: { prefix?: string; glob?: string },
     init?: { signal?: AbortSignal },
   ): Promise<{ deleted: number }> {
-    return this.transport.postJSON<{ deleted: number }>(
+    return this.run("files.deleteMany", () => this.transport.postJSON<{ deleted: number }>(
       this.base + "/delete",
       { prefix: opts.prefix ?? "", glob: opts.glob ?? "" },
       init,
-    );
+    ));
   }
 
   /** Atomic rename (copy + delete server-side). */
   async move(from: string, to: string, init?: { signal?: AbortSignal }): Promise<FileObject> {
-    return this.transport.postJSON<FileObject>(this.base + "/move", { from, to }, init);
+    return this.run("files.move", () => this.transport.postJSON<FileObject>(this.base + "/move", { from, to }, init));
   }
 
   /** Server-side copy. */
   async copy(from: string, to: string, init?: { signal?: AbortSignal }): Promise<FileObject> {
-    return this.transport.postJSON<FileObject>(this.base + "/copy", { from, to }, init);
+    return this.run("files.copy", () => this.transport.postJSON<FileObject>(this.base + "/copy", { from, to }, init));
   }
 
   /**
@@ -295,7 +310,7 @@ export class FilesService {
     srcURL: string,
     opts?: PutFromURLOptions,
   ): Promise<FileObject> {
-    return this.transport.postJSON<FileObject>(
+    return this.run("files.putFromURL", () => this.transport.postJSON<FileObject>(
       this.base + "/put-url",
       {
         path,
@@ -305,7 +320,7 @@ export class FilesService {
         if_match: opts?.ifMatch,
       },
       opts?.signal ? { signal: opts.signal } : undefined,
-    );
+    ));
   }
 
   /**
@@ -325,6 +340,10 @@ export class FilesService {
     init?: { signal?: AbortSignal },
   ): Promise<BatchResult[]> {
     if (ops.length === 0) return [];
+    return this.run("files.batch", () => this.batchRaw(ops, init));
+  }
+
+  private async batchRaw(ops: BatchOp[], init?: { signal?: AbortSignal }): Promise<BatchResult[]> {
     const chunkSize = 30;
     if (ops.length <= chunkSize) {
       const resp = await this.transport.postJSON<{ results: BatchResult[] }>(