@wice24/tars-sdk 0.1.2 → 0.1.4

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, McpServer, Skill, SkillVersion, ApiKeyInfo } from './types.js';
+import type { Agent, AgentVersion, ClientTool, CreateAgentInput, FileMeta, McpCredentialInput, McpCredentialStatus, SessionEvent, SessionInfo, SessionListItem, UpdateAgentInput, UploadFileInput, UsageSummary, SessionUsageRow, DailyUsageRow, McpServer, Skill, SkillVersion, ApiKeyInfo } from './types.js';
 type ToolHandler = (input: any) => unknown | Promise<unknown>;
 export * from './types.js';
 export declare class TarsApiError extends Error {
@@ -149,6 +149,13 @@ export declare class TarsClient {
             };
         }>;
     };
+    /**
+     * Which model providers this instance is keyed for (`anthropic`, `openai`,
+     * `openrouter`, `custom`). Ask before OFFERING models: a picker listing GPT
+     * models on an instance with no OpenAI key produces turns that all fail at
+     * the provider call.
+     */
+    providers(): Promise<string[]>;
     readonly usage: {
         get: (filter?: {
             from?: string | Date;
@@ -156,6 +163,7 @@ export declare class TarsClient {
             sessionId?: string;
             endUserId?: string;
         }) => Promise<UsageSummary>;
+        daily: (from: string | Date) => Promise<DailyUsageRow[]>;
         sessions: (from: string | Date) => Promise<SessionUsageRow[]>;
     };
     readonly files: {

package/dist/index.js

@@ -178,6 +178,16 @@ export class TarsClient {
             ...(input.maxTokens ? { max_tokens: input.maxTokens } : {}),
         }),
     };
+    /**
+     * Which model providers this instance is keyed for (`anthropic`, `openai`,
+     * `openrouter`, `custom`). Ask before OFFERING models: a picker listing GPT
+     * models on an instance with no OpenAI key produces turns that all fail at
+     * the provider call.
+     */
+    async providers() {
+        const body = await this.request('GET', '/v1/providers');
+        return body.providers ?? [];
+    }
     usage = {
         // Aggregated token/cost usage for this tenant, with per-model, per-agent,
         // and per-end-user breakdowns. Dates are ISO 8601; sessionId narrows to one
@@ -195,6 +205,13 @@ export class TarsClient {
             const qs = params.size ? `?${params}` : '';
             return this.request('GET', `/v1/usage${qs}`);
         },
+        // Per-day, per-model buckets by TURN time — day/MTD dashboard views
+        // (per-session rollups attribute whole sessions to their creation day).
+        daily: async (from) => {
+            const qs = `?from=${encodeURIComponent(new Date(from).toISOString())}`;
+            const { days } = await this.request('GET', `/v1/usage/daily${qs}`);
+            return days;
+        },
         // Per-session usage snapshots for sessions created since `from` — the
         // shape usage dashboards want (one row per session, buckets + cost).
         sessions: async (from) => {

package/dist/types.d.ts

@@ -256,6 +256,16 @@ export interface SessionUsageRow {
         turns: number;
     };
 }
+export interface DailyUsageRow {
+    day: string;
+    model: string;
+    input_tokens: number;
+    output_tokens: number;
+    cache_read_tokens: number;
+    cache_write_tokens: number;
+    cost_usd: number | null;
+    turns: number;
+}
 export interface SessionListItem {
     id: string;
     status: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wice24/tars-sdk",
-  "version": "0.1.2",
-  "description": "Client SDK for TARS \u2014 the self-hosted managed-agents platform (sessions, streaming turns, client tools, MCP credentials, skills, files, usage)",
+  "version": "0.1.4",
+  "description": "Client SDK for TARS — the self-hosted managed-agents platform (sessions, streaming turns, client tools, MCP credentials, skills, files, usage)",
   "type": "module",
   "exports": {
     ".": {