docs(client/tools): add xsai example

Author: kwaa

docs/content/docs/client/shared/tools.mdx

@@ -38,3 +38,94 @@ await client.callTool('add', { a: 1, b: 1 })
 await client.callTool('echo', { message: 'Hello, World!' })
 await client.callTool('getTinyImage', {})
 ```
+
+## integration with [xsAI](https://xsai.js.org) (experimental)
+
+> This feature is yet to be tested and feedback is welcome.
+
+### Library
+
+```ts
+import type { AudioPart, ImagePart, TextPart, Tool as XSAITool } from '@xsai/shared-chat'
+import type { Client } from '@xsmcp/client-shared'
+import type { CallToolResult } from '@xsmcp/shared'
+
+import { rawTool } from '@xsai/tool'
+
+const toXSAIContent = (contents: CallToolResult['content']): (AudioPart | ImagePart | TextPart)[] =>
+  // eslint-disable-next-line array-callback-return
+  contents.map((content) => {
+    switch (content.type) {
+      case 'audio':
+        return {
+          input_audio: {
+            data: content.data,
+            format: content.mimeType === 'audio/wav'
+              ? 'wav'
+              // TODO: fallback
+              : 'mp3',
+          },
+          type: 'input_audio',
+        } satisfies AudioPart
+      case 'image':
+        return {
+          image_url: { url: content.data },
+          type: 'image_url',
+        } satisfies ImagePart
+      case 'resource':
+        return {
+          text: ('text' in content.resource
+            ? content.resource.text
+            // TODO: fallback
+            : content.resource.blob
+          ),
+          type: 'text',
+        } satisfies TextPart
+      case 'text':
+        return {
+          text: content.text,
+          type: 'text',
+        } satisfies TextPart
+    }
+  })
+
+export const getTools = async (client: Client): Promise<XSAITool[]> =>
+  client
+    .listTools()
+    .then(({ tools }) => tools.map(tool => rawTool({
+      description: tool.description,
+      execute: async params => client.callTool(tool.name, params as Record<string, unknown>)
+        // eslint-disable-next-line sonarjs/no-nested-functions
+        .then(result => toXSAIContent(result.content)),
+      name: tool.name,
+      parameters: tool.inputSchema,
+    })))
+```
+
+### Usage
+
+```ts
+import { createHttpTransport } from '@xsmcp/client-http'
+import { createClient } from '@xsmcp/server-shared'
+
+import { getTools } from './get-tools'
+
+const client = createClient({
+  name: 'example-client',
+  transport: createHttpTransport({ url: 'http://localhost:3000/mcp' }),
+  version: '1.0.0',
+})
+
+const mcpTools = await client.listTools()
+
+const result = await streamText({
+  baseURL: 'http://localhost:11434/v1/',
+  messages: [{
+    content: 'What is the weather in Brooklyn, New York?',
+    role: 'user',
+  }],
+  model: 'gemma3',
+  onFinish: async () => await client.close(),
+  tools: await getTools(client),
+})
+```

package.json

@@ -19,6 +19,8 @@
     "@importantimport/tsconfig": "^1.0.0-beta.2",
     "@pnpm/find-workspace-dir": "^1000.1.0",
     "@types/node": "^22.15.24",
+    "@xsai/shared-chat": "0.3.0-beta.3",
+    "@xsai/tool": "0.3.0-beta.3",
     "automd": "^0.4.0",
     "bumpp": "^10.1.1",
     "eslint": "^9.27.0",

packages/client-shared/test/fixtures/get-tools.ts

@@ -0,0 +1,54 @@
+import type { AudioPart, ImagePart, TextPart, Tool as XSAITool } from '@xsai/shared-chat'
+import type { Client } from '@xsmcp/client-shared'
+import type { CallToolResult } from '@xsmcp/shared'
+
+import { rawTool } from '@xsai/tool'
+
+const toXSAIContent = (contents: CallToolResult['content']): (AudioPart | ImagePart | TextPart)[] =>
+  // eslint-disable-next-line array-callback-return
+  contents.map((content) => {
+    switch (content.type) {
+      case 'audio':
+        return {
+          input_audio: {
+            data: content.data,
+            format: content.mimeType === 'audio/wav'
+              ? 'wav'
+              // TODO: fallback
+              : 'mp3',
+          },
+          type: 'input_audio',
+        } satisfies AudioPart
+      case 'image':
+        return {
+          image_url: { url: content.data },
+          type: 'image_url',
+        } satisfies ImagePart
+      case 'resource':
+        return {
+          text: ('text' in content.resource
+            ? content.resource.text
+            // TODO: fallback
+            : content.resource.blob
+          ),
+          type: 'text',
+        } satisfies TextPart
+      case 'text':
+        return {
+          text: content.text,
+          type: 'text',
+        } satisfies TextPart
+    }
+  })
+
+export const getTools = async (client: Client): Promise<XSAITool[]> =>
+  client
+    .listTools()
+    .then(({ tools }) => tools.map(tool => rawTool({
+      description: tool.description,
+      execute: async params => client.callTool(tool.name, params as Record<string, unknown>)
+        // eslint-disable-next-line sonarjs/no-nested-functions
+        .then(result => toXSAIContent(result.content)),
+      name: tool.name,
+      parameters: tool.inputSchema,
+    })))