@runappsai/sdk 0.8.1 → 0.9.0

package/package.json

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

package/src/client.ts

@@ -5,7 +5,6 @@ import { ImageService } from "./image.js";
 import { AudioService } from "./audio.js";
 import { RealtimeService } from "./realtime.js";
 import { VideoService } from "./video.js";
-import { ComputerService } from "./computer.js";
 import { FilesService } from "./files.js";
 import { EmbeddingsService } from "./embeddings.js";
 import { BrowserAuth, type BrowserUser } from "./browser-auth.js";
@@ -153,7 +152,6 @@ export class RunApps {
   readonly image: ImageService;
   readonly audio: AudioService;
   readonly video: VideoService;
-  readonly computer: ComputerService;
   readonly files: FilesService;
   readonly embeddings: EmbeddingsService;
   /** Realtime voice sessions over WebSocket — see `RealtimeService.connect`. */
@@ -176,7 +174,7 @@ export class RunApps {
 
   /**
    * Runtime event bus for SDK-call telemetry. Every LLM-ish service
-   * (chat / embeddings / image / audio / video / computer) fires
+   * (chat / embeddings / image / audio / video) fires
    * `request:start`, `request:streamDelta`, `request:end`, and
    * `request:error` events here so UI overlays — like the bottom-right
    * identity badge's activity ring — can render real-time state
@@ -253,7 +251,7 @@ export class RunApps {
       ...(options.fetch ? { fetchImpl: options.fetch } : {}),
     });
     // Service constructors receive the shared event bus so each call
-    // path (chat/embeddings/image/audio/video/computer) can emit
+    // path (chat/embeddings/image/audio/video) can emit
     // start/end/error around its network operations. Files and Models
     // intentionally don't take it — they're infrastructure, not
     // user-facing LLM calls, and surfacing them would clutter the
@@ -263,7 +261,6 @@ export class RunApps {
     this.image = new ImageService(transport, this.events);
     this.audio = new AudioService(transport, this.events);
     this.video = new VideoService(transport, this.events);
-    this.computer = new ComputerService(transport, this.events);
     // `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.

package/src/events.ts

@@ -1,8 +1,8 @@
 /**
  * Typed runtime event bus for SDK call telemetry.
  *
- * Every LLM-ish service method (chat, embeddings, image, audio, video,
- * computer) emits start / streamDelta / end / error events on the
+ * Every LLM-ish service method (chat, embeddings, image, audio, video)
+ * emits start / streamDelta / end / error events on the
  * shared `client.events` bus so UI overlays (e.g. the bottom-right
  * identity badge with its activity ring) can render real-time state
  * without business code having to thread anything through.
@@ -32,7 +32,6 @@ export type SDKCapability =
   | "text_to_speech"
   | "speech_to_text"
   | "video_generation"
-  | "computer_use"
   /** A realtime voice session (`client.realtime`). */
   | "realtime"
   /** A file-space call (`client.files`). Shown on the badge while in

package/src/index.ts

@@ -88,6 +88,7 @@ export {
   supportsVoiceClone,
   supportsInstructText,
   defaultVoice,
+  defaultModel,
 } from "./models.js";
 
 // Model options schema (input validation + capability introspection)
@@ -156,13 +157,6 @@ export type {
 // Media helpers (shared by image + video + chat-multimodal)
 export { encodeImageUrl, decodeMediaUrl } from "./media.js";
 
-// Computer
-export type {
-  ComputerStepParams,
-  ComputerContentBlock,
-  ComputerResponse,
-} from "./computer.js";
-
 // Files (per-project file system)
 export type {
   FileObject,

package/src/models.ts

@@ -10,6 +10,15 @@ export interface Model {
   object: string;
   capability: string;
   provider?: string;
+  /**
+   * The model the platform uses for this capability when a request names
+   * none: the one the admin starred in the gateway settings, else the
+   * first of the capability. Exactly one model per capability carries it.
+   * Use `defaultModel` to pick it out of a list.
+   */
+  is_default?: boolean;
+  /** One or two sentences about the model, set on the gateway. */
+  description?: string;
   /**
    * Server-derived "what this model can actually do" tags
    * (e.g. {id:"t2v", label:"Text-to-Video"}, {id:"i2v", label:"Image-to-Video"}).
@@ -100,6 +109,18 @@ export const defaultVoice = (model: Model): string | null => {
   return typeof v === "string" ? v : null;
 };
 
+/**
+ * The platform's default model among `models` — the admin-starred one for
+ * the capability, else the first of the capability. With `capability`
+ * given, only that capability is considered; without it, the first
+ * default in list order (so pass a list from
+ * `client.models.list({ capability })`). Null when the list has none.
+ */
+export const defaultModel = (models: Model[], capability?: string): Model | null => {
+  const pool = capability ? models.filter((m) => m.capability === capability) : models;
+  return pool.find((m) => m.is_default) ?? null;
+};
+
 export class ModelsService {
   constructor(private readonly transport: Transport) {}
 
@@ -120,4 +141,14 @@ export class ModelsService {
     const resp = await this.transport.getPublicJSON<{ data: Model[] }>(path, init);
     return resp.data;
   }
+
+  /**
+   * The platform's default model for a capability (`"text"` unless given):
+   * the admin-starred one, else the first. What a request without `model`
+   * would use before the user's own preference. Null when the capability
+   * has no models.
+   */
+  async default(capability = "text", init?: { signal?: AbortSignal }): Promise<Model | null> {
+    return defaultModel(await this.list({ capability }, init), capability);
+  }
 }

package/dist/computer.d.ts

@@ -1,57 +0,0 @@
-import type { Transport } from "./transport.js";
-import type { Usage } from "./types.js";
-import type { SDKEvents } from "./events.js";
-/** Single-step computer-use request — a screenshot + history → next action(s). */
-export interface ComputerStepParams {
-    /**
-     * Conversation history including screenshots and tool results. Each
-     * entry has `role` + `content` (string or array of blocks). Format is
-     * intentionally opaque to support both Anthropic and OpenAI computer-use
-     * protocols — the gateway adapts.
-     */
-    messages: Record<string, unknown>[];
-    /** Screen resolution. Defaults to 1920×1080 if omitted. */
-    display_width?: number;
-    display_height?: number;
-    max_tokens?: number;
-    enable_zoom?: boolean;
-    /** OpenAI Responses-API state chaining. */
-    previous_response_id?: string;
-    /** Follow-up `computer_call_output` for OpenAI's Responses API. */
-    openai_input?: unknown;
-    user?: string;
-}
-/** One block of a computer-use response: text, tool_use (Anthropic), or computer_call (OpenAI). */
-export interface ComputerContentBlock {
-    type: string;
-    text?: string;
-    id?: string;
-    name?: string;
-    /** Anthropic tool input (raw JSON). */
-    input?: unknown;
-    call_id?: string;
-    /** OpenAI computer-call action. */
-    action?: Record<string, unknown>;
-}
-export interface ComputerResponse {
-    content: ComputerContentBlock[];
-    stop_reason?: string;
-    usage: Usage;
-    response_id?: string;
-    /** "anthropic" | "openai" — which protocol the upstream returned. */
-    protocol?: string;
-}
-export declare class ComputerService {
-    private readonly transport;
-    private readonly events;
-    constructor(transport: Transport, events: SDKEvents);
-    /**
-     * Execute one step of a computer-use agent loop. Given a screenshot
-     * and conversation history, returns the next action(s) the model
-     * wants the caller to execute.
-     */
-    step(model: string, params: ComputerStepParams, init?: {
-        signal?: AbortSignal;
-    }): Promise<ComputerResponse>;
-}
-//# sourceMappingURL=computer.d.ts.map

package/dist/computer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"computer.d.ts","sourceRoot":"","sources":["../src/computer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,kFAAkF;AAClF,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACpC,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2CAA2C;IAC3C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mEAAmE;IACnE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,mGAAmG;AACnG,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,SAAS;IAGpC;;;;OAIG;IACG,IAAI,CACR,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,kBAAkB,EAC1B,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC9B,OAAO,CAAC,gBAAgB,CAAC;CAgB7B"}

package/dist/computer.js

@@ -1,21 +0,0 @@
-import { wrapEvents } from "./event-wrap.js";
-export class ComputerService {
-    transport;
-    events;
-    constructor(transport, events) {
-        this.transport = transport;
-        this.events = events;
-    }
-    /**
-     * Execute one step of a computer-use agent loop. Given a screenshot
-     * and conversation history, returns the next action(s) the model
-     * wants the caller to execute.
-     */
-    async step(model, params, init) {
-        return wrapEvents(this.events, { model, capability: "computer_use" }, () => this.transport.postJSON("/v1/computer/step", { model, ...params }, init), (r) => ({
-            totalTokens: r.usage?.completion_tokens,
-            costUSD: r.usage?.total_cost,
-        }));
-    }
-}
-//# sourceMappingURL=computer.js.map

package/dist/computer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"computer.js","sourceRoot":"","sources":["../src/computer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AA6C7C,MAAM,OAAO,eAAe;IAEP;IACA;IAFnB,YACmB,SAAoB,EACpB,MAAiB;QADjB,cAAS,GAAT,SAAS,CAAW;QACpB,WAAM,GAAN,MAAM,CAAW;IACjC,CAAC;IAEJ;;;;OAIG;IACH,KAAK,CAAC,IAAI,CACR,KAAa,EACb,MAA0B,EAC1B,IAA+B;QAE/B,OAAO,UAAU,CACf,IAAI,CAAC,MAAM,EACX,EAAE,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,EACrC,GAAG,EAAE,CACH,IAAI,CAAC,SAAS,CAAC,QAAQ,CACrB,mBAAmB,EACnB,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,EACpB,IAAI,CACL,EACH,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACN,WAAW,EAAE,CAAC,CAAC,KAAK,EAAE,iBAAiB;YACvC,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,UAAU;SAC7B,CAAC,CACH,CAAC;IACJ,CAAC;CACF"}

package/src/computer.ts

@@ -1,80 +0,0 @@
-import type { Transport } from "./transport.js";
-import type { Usage } from "./types.js";
-import type { SDKEvents } from "./events.js";
-import { wrapEvents } from "./event-wrap.js";
-
-/** Single-step computer-use request — a screenshot + history → next action(s). */
-export interface ComputerStepParams {
-  /**
-   * Conversation history including screenshots and tool results. Each
-   * entry has `role` + `content` (string or array of blocks). Format is
-   * intentionally opaque to support both Anthropic and OpenAI computer-use
-   * protocols — the gateway adapts.
-   */
-  messages: Record<string, unknown>[];
-  /** Screen resolution. Defaults to 1920×1080 if omitted. */
-  display_width?: number;
-  display_height?: number;
-  max_tokens?: number;
-  enable_zoom?: boolean;
-  /** OpenAI Responses-API state chaining. */
-  previous_response_id?: string;
-  /** Follow-up `computer_call_output` for OpenAI's Responses API. */
-  openai_input?: unknown;
-  user?: string;
-}
-
-/** One block of a computer-use response: text, tool_use (Anthropic), or computer_call (OpenAI). */
-export interface ComputerContentBlock {
-  type: string;
-  text?: string;
-  id?: string;
-  name?: string;
-  /** Anthropic tool input (raw JSON). */
-  input?: unknown;
-  call_id?: string;
-  /** OpenAI computer-call action. */
-  action?: Record<string, unknown>;
-}
-
-export interface ComputerResponse {
-  content: ComputerContentBlock[];
-  stop_reason?: string;
-  usage: Usage;
-  response_id?: string;
-  /** "anthropic" | "openai" — which protocol the upstream returned. */
-  protocol?: string;
-}
-
-export class ComputerService {
-  constructor(
-    private readonly transport: Transport,
-    private readonly events: SDKEvents,
-  ) {}
-
-  /**
-   * Execute one step of a computer-use agent loop. Given a screenshot
-   * and conversation history, returns the next action(s) the model
-   * wants the caller to execute.
-   */
-  async step(
-    model: string,
-    params: ComputerStepParams,
-    init?: { signal?: AbortSignal },
-  ): Promise<ComputerResponse> {
-    return wrapEvents(
-      this.events,
-      { model, capability: "computer_use" },
-      () =>
-        this.transport.postJSON<ComputerResponse>(
-          "/v1/computer/step",
-          { model, ...params },
-          init,
-        ),
-      (r) => ({
-        totalTokens: r.usage?.completion_tokens,
-        costUSD: r.usage?.total_cost,
-      }),
-    );
-  }
-}