@wice24/tars-sdk 0.1.0 → 0.1.2

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 {
@@ -66,6 +66,12 @@ export declare class TarsClient {
         setMcpServers: (id: string, servers: McpServer[]) => Promise<{
             ok: boolean;
         }>;
+        /** Replace the session's client-executed tool declarations (takes effect
+         *  next turn; 409s while a turn is in flight). How a host app rolls new
+         *  tools out to sessions created before the tools existed. */
+        setCustomTools: (id: string, tools: Array<Pick<ClientTool, "name" | "description" | "inputSchema" | "timeoutSec">>) => Promise<{
+            ok: boolean;
+        }>;
         /** Abort the in-flight turn, if any. Idempotent. */
         interrupt: (id: string) => Promise<{
             ok: boolean;
@@ -150,6 +156,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

@@ -96,6 +96,17 @@ export class TarsClient {
         /** Replace the session's extra MCP server set (takes effect next turn;
          *  409s while a turn is in flight). */
         setMcpServers: (id, servers) => this.request('PATCH', `/v1/sessions/${id}`, { mcp_servers: servers }),
+        /** Replace the session's client-executed tool declarations (takes effect
+         *  next turn; 409s while a turn is in flight). How a host app rolls new
+         *  tools out to sessions created before the tools existed. */
+        setCustomTools: (id, tools) => this.request('PATCH', `/v1/sessions/${id}`, {
+            custom_tools: tools.map((t) => ({
+                name: t.name,
+                description: t.description,
+                input_schema: t.inputSchema,
+                ...(t.timeoutSec ? { timeout_sec: t.timeoutSec } : {}),
+            })),
+        }),
         /** Abort the in-flight turn, if any. Idempotent. */
         interrupt: (id) => this.request('POST', `/v1/sessions/${id}/interrupt`),
         usage: (id) => this.request('GET', `/v1/sessions/${id}/usage`),
@@ -184,6 +195,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

@@ -190,6 +190,13 @@ export interface SessionInfo {
     sandboxId: string | null;
     title?: string | null;
     metadata?: Record<string, string> | null;
+    /** Wire-shaped client-tool declarations stored on the session (no execute). */
+    custom_tools?: Array<{
+        name: string;
+        description: string;
+        input_schema: Record<string, unknown>;
+        timeout_sec?: number;
+    }> | null;
     archived?: boolean;
     last_seq?: number;
     events?: SessionEvent[];
@@ -233,6 +240,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.2",
   "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": {