@2en/clawly-plugins 1.30.0-beta.8 → 1.30.0

package/lib/calendar-cache.ts

@@ -109,7 +109,12 @@ export function initCache(): void {
 }
 
 export function getCache(): CalendarCache | null {
-  if (!cachedData) cachedData = loadCache()
+  // Always read from disk to avoid returning stale in-memory state.
+  // After gateway restart or ESM/CJS dual-loading, gateway methods and
+  // agent tools may hold separate module instances with divergent
+  // cachedData. Disk is the shared source of truth. The file is small
+  // (<10 KB) and tool calls are infrequent, so the I/O cost is negligible.
+  cachedData = loadCache()
   return cachedData
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2en/clawly-plugins",
-  "version": "1.30.0-beta.8",
+  "version": "1.30.0",
   "module": "index.ts",
   "type": "module",
   "repository": {

package/tools/clawly-search.test.ts

@@ -1,6 +1,11 @@
 import {afterAll, beforeEach, describe, expect, test} from 'bun:test'
 import type {PluginApi} from '../types'
-import {registerDeepSearchTool, registerGrokSearchTool, registerSearchTool} from './clawly-search'
+import {
+  registerDeepSearchTool,
+  registerGrokSearchTool,
+  registerKimiSearchTool,
+  registerSearchTool,
+} from './clawly-search'
 
 // ── Helpers ──────────────────────────────────────────────────────
 
@@ -267,3 +272,45 @@ describe('clawly_grok_search', () => {
     expect(res.error).toContain('Grok API error 429')
   })
 })
+
+// ── clawly_kimi_search ──────────────────────────────────────────
+
+describe('clawly_kimi_search', () => {
+  test('uses Kimi gateway endpoint with web_search tool', async () => {
+    mockResponse.body = {
+      choices: [{message: {content: 'Kimi answer with [source](https://example.com/page)'}}],
+    }
+    const {execute} = createMockApi(registerKimiSearchTool)
+    const res = parseResult(await execute('tc-1', {query: 'Chinese news'}))
+
+    expect(fetchCalls).toHaveLength(1)
+    const call = fetchCalls[0]
+    expect(call.url).toBe('https://gw.example.com/v1/kimi/v1/chat/completions')
+    expect(call.body?.model).toBe('kimi-k2-turbo-preview')
+    expect(call.body?.stream).toBe(false)
+    expect(call.body?.messages).toEqual([{role: 'user', content: 'Chinese news'}])
+    expect(call.body?.tools).toEqual([{type: 'builtin_function', function: {name: 'web_search'}}])
+
+    expect(res.answer).toBe('Kimi answer with [source](https://example.com/page)')
+    expect(res.citations).toEqual(['https://example.com/page'])
+    expect(res.provider).toBe('kimi')
+  })
+
+  test('returns empty citations when response has no inline links', async () => {
+    mockResponse.body = {choices: [{message: {content: 'Plain answer'}}]}
+    const {execute} = createMockApi(registerKimiSearchTool)
+    const res = parseResult(await execute('tc-1', {query: 'test'}))
+
+    expect(res.answer).toBe('Plain answer')
+    expect(res.citations).toEqual([])
+    expect(res.provider).toBe('kimi')
+  })
+
+  test('returns error on Kimi API failure', async () => {
+    mockResponse = {ok: false, status: 429, body: {error: 'rate limited'}}
+    const {execute} = createMockApi(registerKimiSearchTool)
+    const res = parseResult(await execute('tc-1', {query: 'test'}))
+
+    expect(res.error).toContain('Kimi API error 429')
+  })
+})

package/tools/clawly-search.ts

@@ -1,9 +1,12 @@
 import {
   buildGrokBody,
   buildGrokUrl,
+  buildKimiBody,
+  buildKimiUrl,
   buildPerplexityUrl,
   createSearchToolRegistrar,
   parseGrokResponse,
+  parseKimiResponse,
 } from './create-search-tool'
 
 export const registerSearchTool = createSearchToolRegistrar({
@@ -40,3 +43,14 @@ export const registerGrokSearchTool = createSearchToolRegistrar({
   buildBody: buildGrokBody,
   parseResponse: parseGrokResponse,
 })
+
+export const registerKimiSearchTool = createSearchToolRegistrar({
+  toolName: 'clawly_kimi_search',
+  description: 'Search the web using Kimi. Good for Chinese-language queries and content.',
+  model: 'kimi-k2-turbo-preview',
+  buildUrl: buildKimiUrl,
+  timeoutMs: 30_000,
+  provider: 'kimi',
+  buildBody: buildKimiBody,
+  parseResponse: parseKimiResponse,
+})

package/tools/create-search-tool.ts

@@ -1,7 +1,7 @@
 import type {PluginApi} from '../types'
 import {resolveGatewayCredentials} from '../resolve-gateway-credentials'
 
-export type SearchProvider = 'grok' | 'perplexity'
+export type SearchProvider = 'grok' | 'kimi' | 'perplexity'
 
 export interface SearchResult {
   query: string
@@ -44,6 +44,19 @@ export function buildGrokBody(model: string, query: string): Record<string, unkn
   return {model, input: query, tools: [{type: 'web_search'}]}
 }
 
+export function buildKimiUrl(baseUrl: string): string {
+  return `${baseUrl.replace(/\/$/, '')}/kimi/v1/chat/completions`
+}
+
+export function buildKimiBody(model: string, query: string): Record<string, unknown> {
+  return {
+    model,
+    stream: false,
+    messages: [{role: 'user', content: query}],
+    tools: [{type: 'builtin_function', function: {name: 'web_search'}}],
+  }
+}
+
 function extractCitations(text: string): string[] {
   const urls: string[] = []
   const seen = new Set<string>()
@@ -57,6 +70,12 @@ function extractCitations(text: string): string[] {
   return urls
 }
 
+export function parseKimiResponse(data: unknown): {answer: string; citations: string[]} {
+  const d = data as {choices?: {message?: {content?: string}}[]}
+  const answerText = d.choices?.[0]?.message?.content ?? ''
+  return {answer: answerText, citations: extractCitations(answerText)}
+}
+
 export function parseGrokResponse(data: unknown): {answer: string; citations: string[]} {
   const typed = data as {
     output?: Array<{type: string; content?: Array<{type: string; text?: string}>}>
@@ -113,9 +132,13 @@ export function createSearchToolRegistrar(config: SearchToolConfig) {
 
           if (!res.ok) {
             const body = await res.text().catch(() => '')
-            throw new Error(
-              `${config.provider === 'grok' ? 'Grok' : 'Perplexity'} API error ${res.status}: ${body.slice(0, 200)}`,
-            )
+            const providerLabel =
+              config.provider === 'grok'
+                ? 'Grok'
+                : config.provider === 'kimi'
+                  ? 'Kimi'
+                  : 'Perplexity'
+            throw new Error(`${providerLabel} API error ${res.status}: ${body.slice(0, 200)}`)
           }
 
           const data = await res.json()

package/tools/index.ts

@@ -2,7 +2,12 @@ import type {PluginApi} from '../types'
 import {registerCalendarTools} from './clawly-calendar'
 import {registerIsUserOnlineTool} from './clawly-is-user-online'
 import {registerMsgBreakTool} from './clawly-msg-break'
-import {registerDeepSearchTool, registerGrokSearchTool, registerSearchTool} from './clawly-search'
+import {
+  registerDeepSearchTool,
+  registerGrokSearchTool,
+  registerKimiSearchTool,
+  registerSearchTool,
+} from './clawly-search'
 import {registerSendAppPushTool} from './clawly-send-app-push'
 import {registerSendFileTool} from './clawly-send-file'
 import {registerSendMessageTool} from './clawly-send-message'
@@ -14,6 +19,7 @@ export function registerTools(api: PluginApi) {
   registerSearchTool(api)
   registerDeepSearchTool(api)
   registerGrokSearchTool(api)
+  registerKimiSearchTool(api)
   registerSendAppPushTool(api)
   registerSendFileTool(api)
   registerSendMessageTool(api)