@inferencesh/sdk 0.26.2 → 0.27.0

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.27.0] - 2026-10-13
+
+### Changed
+
+- `client.agent(...).sendMessage(text, { files })` sends the files as `MessageInput.attachments` (FileRefs with filename and content type) instead of the deprecated `images` / `files` URI lists.
+- A `tool(...).handler()` handler may return `{ result, attachments }` (`ClientToolResult`, now exported from the package root) like a `clientToolHandlers` handler: the result text plus files uploaded with `client.files.upload`.
+
+### Added
+
+- Generated types follow the API: `MCPServerDTO.connection` (`ConnectionInfo` with `MCPConnectionFacts`); `connection_status` is deprecated.
+
+## [0.26.2] - 2026-10-13
+
 Added: `mcpTool(name, { server, toolName, credentialId? })` names the MCP server by its slug (the API's model: a server declares the provider it signs in through); `credentialId` pins one connection. The old `mcpTool(name, credentialId, toolName)` still works (deprecated): the API saves such a tool with the server the connection's provider is declared by. `MCPServerUpdateBody` gains `credentials`; its `auth_type`, `oauth_client_id` and `oauth_secret_key` are no longer read by the API (the provider's OAuth app is set through `PUT /credentials/{slug}/app`). Generated types: `MCPToolConfig.server`; `MCPServerDTO.oauth_client_id`, `CredentialProviderMCP` and `CredentialTypeMCP` are gone from the API.
 
 ### Changed

package/dist/agent/types.d.ts

@@ -6,6 +6,7 @@
 import type { Dispatch } from 'react';
 import type { AgentRunDTO, AgentVersionDTO, AlwaysAllowOptionsDTO, AlwaysAllowResultDTO, ToolExplanationDTO, ChatAgentDTO, ChatDTO, ChatMessageDTO, ChatSettingsDTO, ChatSettingsRequest, AgentTool, AgentConfigInput as GeneratedAgentConfig, CoreAppConfigInput as CoreAppConfig, FileRef, ElicitResult } from '../types.js';
 import type { HttpClient } from '../http/client.js';
+import type { ClientToolResult } from '../tool-builder.js';
 import type { StreamableManager } from '../http/streamable.js';
 import type { PollManager } from '../http/poll.js';
 export type { FileRef } from '../types.js';
@@ -221,19 +222,8 @@ export interface AgentChatProviderProps {
     /** Children */
     children: React.ReactNode;
 }
-/**
- * What a client tool handler returns: the result text, or the text plus files.
- *
- * `attachments` are files already uploaded with POST /files (for example with
- * `client.files.upload(dataUrlOrBlob)` or the chat's `uploadFile`), passed as
- * `FileRef`s, the same as message attachments. An image attachment reaches the
- * model as image input when the model supports images; other files are listed
- * on the tool message.
- */
-export type ClientToolResult = string | {
-    result: string;
-    attachments?: FileRef[];
-};
+/** What a client tool handler returns (defined with the tool builder). */
+export type { ClientToolResult } from '../tool-builder.js';
 /**
  * Client tool handler function - takes args and returns a result (sync or async)
  */

package/dist/api/agents.js

@@ -63,8 +63,7 @@ export class Agent {
         const isTemplate = typeof this.config === 'string';
         const hasCallbacks = !!(options.onMessage || options.onChat || options.onToolCall || options.onDelta);
         // Process files - either already uploaded (FileDTO with uri) or needs upload (Blob)
-        let imageUris;
-        let fileUris;
+        let attachments;
         if (options.files && options.files.length > 0) {
             const toUpload = [];
             const alreadyUploaded = [];
@@ -78,14 +77,11 @@ export class Agent {
             }
             const uploadedFiles = toUpload.length > 0 ? await Promise.all(toUpload.map((blob) => this.files.upload(blob))) : [];
             const allFiles = [...alreadyUploaded, ...uploadedFiles];
-            const images = allFiles.filter((f) => f.content_type?.startsWith('image/'));
-            const others = allFiles.filter((f) => !f.content_type?.startsWith('image/'));
-            if (images.length > 0)
-                imageUris = images.map((f) => f.uri);
-            if (others.length > 0)
-                fileUris = others.map((f) => f.uri);
+            if (allFiles.length > 0) {
+                attachments = allFiles.map(({ id, uri, filename, content_type, size }) => ({ id, uri, filename, content_type, size }));
+            }
         }
-        const input = { text, images: imageUris, files: fileUris, role: 'user', context: [], system_prompt: '', context_size: 0 };
+        const input = attachments ? { text, attachments } : { text };
         const body = {
             chat_id: this.chatId ?? undefined,
             context: this.context,

package/dist/index.d.ts

@@ -32,7 +32,7 @@ export { STREAM_FORMAT, CLEAR_KEY, ERROR_KEY, REDIAL_CODES } from './live/protoc
 export { isLiveField, parseMediaType, pcmFormat, splitLiveSchema, binaryLiveField, alternativeLabel, alternativeTag, } from './live/schema.js';
 export type { JsonSchema, MediaType, PCMFormat, LiveField } from './live/schema.js';
 export { tool, appTool, agentTool, webhookTool, httpTool, callTool, mcpTool, internalTools, string, number, integer, boolean, enumOf, object, array, optional, } from './tool-builder.js';
-export type { ClientTool, ClientToolHandler } from './tool-builder.js';
+export type { ClientTool, ClientToolHandler, ClientToolResult } from './tool-builder.js';
 export { lifecycleHook, learningHooks } from './hook-builder.js';
 export type { LifecycleHookBuilder } from './hook-builder.js';
 export { DeltaAccumulator, createLLMDeltaAccumulator, type DeltaEvent, type FieldTags, type FieldTagsRegistry } from './delta.js';

package/dist/tool-builder.d.ts

@@ -1,9 +1,22 @@
 /**
  * Tool Builder - Fluent API for defining agent tools
  */
-import { AgentTool, InternalToolsConfig } from './types.js';
+import { AgentTool, FileRef, InternalToolsConfig } from './types.js';
+/**
+ * What a client tool handler returns: the result text, or the text plus files.
+ *
+ * `attachments` are files already uploaded with POST /files (for example with
+ * `client.files.upload(dataUrlOrBlob)` or the chat's `uploadFile`), passed as
+ * `FileRef`s, the same as message attachments. An image attachment reaches the
+ * model as image input when the model supports images; other files are listed
+ * on the tool message.
+ */
+export type ClientToolResult = string | {
+    result: string;
+    attachments?: FileRef[];
+};
 /** Handler function for client tools (executed in browser/Node) */
-export type ClientToolHandler = (args: Record<string, unknown>) => Promise<string> | string;
+export type ClientToolHandler = (args: Record<string, unknown>) => Promise<ClientToolResult> | ClientToolResult;
 /** Client tool with schema and handler bundled together */
 export interface ClientTool {
     /** Tool schema (sent to server, describes the tool to the LLM) */

package/dist/types.d.ts

@@ -4046,12 +4046,44 @@ export interface MCPServerDTO {
      */
     credentials?: CredentialRequirements;
     credential_slug?: string;
+    /**
+     * Deprecated: Connection.Status. Kept for clients reading it.
+     */
     connection_status?: string;
     /**
-     * ConnectionScope is who the caller's connection to this server belongs
+     * Deprecated: Connection.Scope. ConnectionScope is who the caller's connection to this server belongs
      * to (user, team, org, platform); empty when not connected.
      */
     connection_scope?: CredentialScope;
+    /**
+     * Connection is the whole of it: the login's status and scope above,
+     * and what the connection made with that login holds.
+     */
+    connection?: ConnectionInfo;
+}
+/**
+ * ConnectionInfo is the caller's standing with a server: their login's
+ * status (connected, expired, error; "" when they hold none) and whose it
+ * is, and what the connection made with that login holds.
+ */
+export interface ConnectionInfo extends MCPConnectionFacts {
+    /**
+     * Status and Scope are the caller's login's for the server: whether
+     * they can call it, and whose the login is.
+     */
+    status?: string;
+    scope?: CredentialScope;
+}
+/**
+ * MCPConnectionFacts is what an MCP connection (a server reached through
+ * one login) has recorded: the catalogue it listed, its last call.
+ */
+export interface MCPConnectionFacts {
+    connection_id?: string;
+    tool_count?: number;
+    tools_listed_at?: string;
+    last_called_at?: string;
+    last_error?: string;
 }
 /**
  * MCPServerSetup is what a server's directory entry knows about setting the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inferencesh/sdk",
-  "version": "0.26.2",
+  "version": "0.27.0",
   "description": "Official JavaScript/TypeScript SDK for inference.sh - Run AI models with a simple API",
   "type": "module",
   "main": "dist/index.js",