@wice24/tars-sdk 0.2.3 → 0.2.4

package/dist/types.d.ts

@@ -67,6 +67,17 @@ export type SessionEvent = {
 } & ({
     status: 'connected';
     tool_count: number;
+    /** The tool names the model received from this server (its own
+     *  unprefixed names, in server order) — what `tool_count` counts.
+     *  Absent on rows journaled by servers before 0.2.4. */
+    tools?: string[];
+    /** Offered by the server but removed by the declaration's policy:
+     *  the `blocked_tools` it offered (deny), or everything not in
+     *  `tools` (allow). Empty with no policy. Absent before 0.2.4. */
+    filtered_out?: string[];
+    /** Either list was cut — at 256 names, a 200-character name, or
+     *  the row's character budget; `tool_count` stays exact. */
+    truncated?: true;
 } | {
     status: 'failed';
     code: AgentErrorCode;
@@ -309,6 +320,30 @@ export interface CreateAgentInput {
     mcp_servers?: McpServer[] | null;
 }
 export type UpdateAgentInput = Partial<CreateAgentInput>;
+/** A client-executed tool as a session stores it: the wire declaration,
+ *  without `execute` (that runs in your app) — the same shape as a
+ *  `SessionInfo.custom_tools` element. */
+export interface SessionClientTool {
+    name: string;
+    description: string;
+    input_schema: Record<string, unknown>;
+    timeout_sec?: number;
+}
+/**
+ * The complete tool surface a session's turns are built with, as declared:
+ * the enabled built-ins with the descriptions the model is shown, the
+ * client-executed tools, and the MCP servers with their `tools` /
+ * `blocked_tools` policy. What each MCP server actually contributed on a
+ * given turn is in that turn's `mcp_connect` event (`tools` / `filtered_out`).
+ */
+export interface SessionToolSurface {
+    builtin: Array<{
+        name: BuiltInTool;
+        description: string;
+    }>;
+    client: SessionClientTool[];
+    mcp_servers: McpServer[];
+}
 export interface SessionInfo {
     id: string;
     status: SessionStatus;
@@ -328,6 +363,12 @@ export interface SessionInfo {
         input_schema: Record<string, unknown>;
         timeout_sec?: number;
     }> | null;
+    /**
+     * The declared tool surface (built-ins, client tools, MCP servers with
+     * policy) the session's turns run with. Optional: absent from servers
+     * predating this field.
+     */
+    tools?: SessionToolSurface;
     /**
      * The EFFECTIVE system prompt the session's turns run with — agent base
      * prompt + session system_suffix + skills appendix, fused at creation.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wice24/tars-sdk",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "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": {