@wice24/tars-sdk 0.1.7 → 0.1.8

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { Agent, AgentVersion, ClientTool, CreateAgentInput, FileMeta, McpCredentialInput, McpCredentialStatus, SessionEvent, SessionInfo, SessionListItem, UpdateAgentInput, UploadFileInput, UsageSummary, SessionUsageRow, DailyUsageRow, McpServer, Skill, SkillVersion, ApiKeyInfo, ClientIdentity, ClientRole, PlatformStats, Tenant } from './types.js';
+import type { Agent, AgentVersion, ClientTool, CreateAgentInput, FileMeta, McpCredentialInput, McpCredentialStatus, SessionEvent, ModelInfo, SessionInfo, SessionListItem, UpdateAgentInput, UploadFileInput, UsageSummary, SessionUsageRow, DailyUsageRow, McpServer, Skill, SkillVersion, ApiKeyInfo, ClientIdentity, ClientRole, PlatformStats, Tenant } from './types.js';
 type ToolHandler = (input: any) => unknown | Promise<unknown>;
 export * from './types.js';
 export declare class TarsApiError extends Error {
@@ -202,6 +202,20 @@ export declare class TarsClient {
      * the provider call.
      */
     providers(): Promise<string[]>;
+    /**
+     * The models this instance can route AND price — ids are full
+     * `provider/model` specs. `openrouter/*` entries mirror OpenRouter's live
+     * catalog, so those ids are guaranteed to exist right now; direct entries
+     * come from the deployment's curated pricing table. Offer models from this
+     * list rather than hardcoding ids that can drift.
+     *
+     * The list is "what is known now", not "everything routable": `openrouter`
+     * entries are absent before the instance's first successful catalog
+     * refresh, and a deployment routing only `custom/*` has no priced entries
+     * at all. When it comes back empty, fall back to `providers()` plus your
+     * own lineup instead of rendering an empty picker.
+     */
+    models(): Promise<ModelInfo[]>;
     readonly usage: {
         get: (filter?: {
             from?: string | Date;

package/dist/index.js

@@ -228,6 +228,23 @@ export class TarsClient {
         const body = await this.request('GET', '/v1/providers');
         return body.providers ?? [];
     }
+    /**
+     * The models this instance can route AND price — ids are full
+     * `provider/model` specs. `openrouter/*` entries mirror OpenRouter's live
+     * catalog, so those ids are guaranteed to exist right now; direct entries
+     * come from the deployment's curated pricing table. Offer models from this
+     * list rather than hardcoding ids that can drift.
+     *
+     * The list is "what is known now", not "everything routable": `openrouter`
+     * entries are absent before the instance's first successful catalog
+     * refresh, and a deployment routing only `custom/*` has no priced entries
+     * at all. When it comes back empty, fall back to `providers()` plus your
+     * own lineup instead of rendering an empty picker.
+     */
+    async models() {
+        const body = await this.request('GET', '/v1/models');
+        return body.models ?? [];
+    }
     // ── usage ────────────────────────────────────────────────────
     usage = {
         // Aggregated token/cost usage for this tenant, with per-model, per-agent,

package/dist/types.d.ts

@@ -129,6 +129,24 @@ export interface SkillVersion {
     size_bytes: number;
     created_at: string;
 }
+/** One routable-and-priced model from `GET /v1/models`. Prices are USD per
+ *  million tokens; `id` is the full `provider/model` spec, usable as-is when
+ *  creating agents/sessions. The list is "what is known now" — see
+ *  `TarsClient.models()` for the empty/partial cases. */
+export interface ModelInfo {
+    id: string;
+    name: string;
+    pricing: {
+        input: number;
+        output: number;
+        /** Absent ≠ free: TARS bills an unpublished cache-read price at the
+         *  `input` rate (conservative upper bound). */
+        cache_read?: number;
+        /** Absent ≠ free: billed at the `input` rate when unpublished. Providers
+         *  with genuinely free cache writes report an explicit 0. */
+        cache_write?: number;
+    };
+}
 export interface ApiKeyInfo {
     id: string;
     key_prefix: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wice24/tars-sdk",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Client SDK for TARS — the self-hosted managed-agents platform (sessions, streaming turns, client tools, MCP credentials, skills, files, usage, tenant administration)",
   "type": "module",
   "exports": {