@wice24/tars-sdk 0.1.0 → 0.1.1

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { Agent, AgentVersion, ClientTool, CreateAgentInput, FileMeta, McpCredentialInput, McpCredentialStatus, SessionEvent, SessionInfo, SessionListItem, UpdateAgentInput, UploadFileInput, UsageSummary, McpServer, Skill, SkillVersion, ApiKeyInfo } from './types.js';
+import type { Agent, AgentVersion, ClientTool, CreateAgentInput, FileMeta, McpCredentialInput, McpCredentialStatus, SessionEvent, SessionInfo, SessionListItem, UpdateAgentInput, UploadFileInput, UsageSummary, SessionUsageRow, McpServer, Skill, SkillVersion, ApiKeyInfo } from './types.js';
 type ToolHandler = (input: any) => unknown | Promise<unknown>;
 export * from './types.js';
 export declare class TarsApiError extends Error {
@@ -150,6 +150,7 @@ export declare class TarsClient {
             sessionId?: string;
             endUserId?: string;
         }) => Promise<UsageSummary>;
+        sessions: (from: string | Date) => Promise<SessionUsageRow[]>;
     };
     readonly files: {
         upload: (input: UploadFileInput) => Promise<FileMeta>;

package/dist/index.js

@@ -184,6 +184,13 @@ export class TarsClient {
             const qs = params.size ? `?${params}` : '';
             return this.request('GET', `/v1/usage${qs}`);
         },
+        // Per-session usage snapshots for sessions created since `from` — the
+        // shape usage dashboards want (one row per session, buckets + cost).
+        sessions: async (from) => {
+            const qs = `?from=${encodeURIComponent(new Date(from).toISOString())}`;
+            const { sessions } = await this.request('GET', `/v1/usage/sessions${qs}`);
+            return sessions;
+        },
     };
     // ── files ────────────────────────────────────────────────────
     files = {

package/dist/types.d.ts

@@ -233,6 +233,22 @@ export interface UsageSummary {
         end_user_id: string | null;
     })[];
 }
+export interface SessionUsageRow {
+    session_id: string;
+    title: string | null;
+    model: string;
+    metadata: Record<string, string> | null;
+    end_user_id: string | null;
+    created_at: string;
+    usage: {
+        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,6 +1,6 @@
 {
   "name": "@wice24/tars-sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Client SDK for TARS \u2014 the self-hosted managed-agents platform (sessions, streaming turns, client tools, MCP credentials, skills, files, usage)",
   "type": "module",
   "exports": {