@2en/clawly-plugins 1.24.2 → 1.24.4

package/command/clawly_echo.ts

@@ -3,7 +3,7 @@
  * invoking the LLM.
  */
 
-import type {PluginApi} from '../index'
+import type {PluginApi} from '../types'
 
 export function registerEchoCommand(api: PluginApi) {
   api.registerCommand({

package/command/index.ts

@@ -1,4 +1,4 @@
-import type {PluginApi} from '../index'
+import type {PluginApi} from '../types'
 import {registerEchoCommand} from './clawly_echo'
 
 export function registerCommands(api: PluginApi) {

package/config-setup.ts

@@ -136,9 +136,11 @@ export function patchGateway(config: Record<string, unknown>): boolean {
     dirty = true
   }
 
-  const desiredProxies = ['0.0.0.0/0']
-  if (JSON.stringify(gateway.trustedProxies) !== JSON.stringify(desiredProxies)) {
-    gateway.trustedProxies = desiredProxies
+  // trustedProxies: remove if present.
+  // OpenClaw v2026.2.19 hardened resolveClientIp to fail-closed, making
+  // trustedProxies: ['0.0.0.0/0'] actively break CLI auto-pair.
+  if (gateway.trustedProxies != null) {
+    delete gateway.trustedProxies
     dirty = true
   }
 

package/gateway/agent.ts

@@ -13,7 +13,7 @@
  */
 
 import {$} from 'zx'
-import type {PluginApi} from '../index'
+import type {PluginApi} from '../types'
 import {stripCliLogs} from '../lib/stripCliLogs'
 import {sendPushNotification} from './notification'
 import {isClientOnline} from './presence'

package/gateway/clawhub2gateway.ts

@@ -19,7 +19,7 @@
 import fs from 'node:fs/promises'
 import path from 'node:path'
 
-import type {PluginApi} from '../index'
+import type {PluginApi} from '../types'
 
 type JsonSchema = Record<string, unknown>
 

package/gateway/config-repair.ts

@@ -8,7 +8,7 @@
 
 import path from 'node:path'
 
-import type {PluginApi} from '../index'
+import type {PluginApi} from '../types'
 import {
   EXTRA_GATEWAY_MODELS,
   PROVIDER_NAME,

package/gateway/index.ts

@@ -1,4 +1,4 @@
-import type {PluginApi} from '../index'
+import type {PluginApi} from '../types'
 import {registerAgentSend} from './agent'
 import {registerClawhub2gateway} from './clawhub2gateway'
 import {registerConfigRepair} from './config-repair'

package/gateway/inject.ts

@@ -7,7 +7,7 @@
  */
 
 import {$} from 'zx'
-import type {PluginApi} from '../index'
+import type {PluginApi} from '../types'
 import {stripCliLogs} from '../lib/stripCliLogs'
 
 $.verbose = false

package/gateway/memory.ts

@@ -13,7 +13,7 @@ import fs from 'node:fs/promises'
 import os from 'node:os'
 import path from 'node:path'
 
-import type {PluginApi} from '../index'
+import type {PluginApi} from '../types'
 
 function isRecord(v: unknown): v is Record<string, unknown> {
   return Boolean(v && typeof v === 'object' && !Array.isArray(v))

package/gateway/notification.ts

@@ -14,7 +14,7 @@ import os from 'node:os'
 import path from 'node:path'
 
 import {$} from 'zx'
-import type {PluginApi} from '../index'
+import type {PluginApi} from '../types'
 import {stripCliLogs} from '../lib/stripCliLogs'
 
 $.verbose = false

package/gateway/offline-push.test.ts

@@ -1,5 +1,5 @@
 import {beforeEach, describe, expect, mock, test} from 'bun:test'
-import type {PluginApi} from '../index'
+import type {PluginApi} from '../types'
 import {
   getLastAssistantPreview,
   getLastAssistantText,

package/gateway/offline-push.ts

@@ -9,7 +9,7 @@
  * logic from apps/mobile/lib/messageFilter.ts.
  */
 
-import type {PluginApi} from '../index'
+import type {PluginApi} from '../types'
 import {sendPushNotification} from './notification'
 import {isClientOnline} from './presence'
 

package/gateway/pairing.ts

@@ -1,5 +1,5 @@
 import {$} from 'zx'
-import type {PluginApi} from '../index'
+import type {PluginApi} from '../types'
 import {stripCliLogs} from '../lib/stripCliLogs'
 
 $.verbose = false

package/gateway/plugins.ts

@@ -10,7 +10,7 @@ import fs from 'node:fs'
 import path from 'node:path'
 import {$} from 'zx'
 
-import type {PluginApi} from '../index'
+import type {PluginApi} from '../types'
 import {LruCache} from '../lib/lruCache'
 import {isUpdateAvailable} from '../lib/semver'
 import {stripCliLogs} from '../lib/stripCliLogs'

package/gateway/presence.ts

@@ -7,7 +7,7 @@
 
 import {$} from 'zx'
 
-import type {PluginApi} from '../index'
+import type {PluginApi} from '../types'
 import {stripCliLogs} from '../lib/stripCliLogs'
 
 $.verbose = false

package/gateway/version.ts

@@ -4,10 +4,18 @@
  * Method: clawly.version({}) → { version: string }
  */
 
-import type {PluginApi} from '../index'
+import type {PluginApi} from '../types'
 
 export function registerVersion(api: PluginApi) {
   api.registerGatewayMethod('clawly.version', async ({respond}) => {
+    // Fast path: read from config (no subprocess needed)
+    const cached = api.config?.meta?.lastTouchedVersion
+    if (cached) {
+      respond(true, {version: cached})
+      return
+    }
+
+    // Fallback: exec openclaw --version
     const run = api.runtime.system?.runCommandWithTimeout
     if (!run) {
       respond(false, undefined, {

package/index.ts

@@ -42,136 +42,15 @@ import {getGatewayConfig} from './gateway-fetch'
 import {registerOutboundHook, registerOutboundHttpRoute, registerOutboundMethods} from './outbound'
 import {registerSkillCommandRestore} from './skill-command-restore'
 import {registerTools} from './tools'
+import type {PluginApi} from './types'
 
-// ---------------------------------------------------------------------------
-// Types aligned with OpenClaw plugin API (openclaw/src/plugins/types.ts)
-// ---------------------------------------------------------------------------
-
-export type PluginLogger = {
-  debug?: (message: string) => void
-  info: (message: string) => void
-  warn: (message: string) => void
-  error: (message: string) => void
-}
-
-export type PluginRuntime = {
-  version?: string
-  config?: {
-    loadConfig?: (...args: unknown[]) => unknown
-    writeConfigFile?: (...args: unknown[]) => unknown
-  }
-  system?: {
-    runCommandWithTimeout?: (
-      argv: string[],
-      opts: {timeoutMs: number; cwd?: string; env?: Record<string, string | undefined>},
-    ) => Promise<{
-      stdout: string
-      stderr: string
-      code: number | null
-      signal: string | null
-      killed: boolean
-    }>
-  }
-  state?: {
-    resolveStateDir?: (env?: NodeJS.ProcessEnv) => string
-  }
-}
-
-export type GatewayRequestHandler = (opts: {
-  params: Record<string, unknown>
-  respond: (ok: boolean, payload?: unknown, error?: {code?: string; message?: string}) => void
-}) => Promise<void> | void
-
-export type PluginHookName =
-  | 'before_agent_start'
-  | 'agent_end'
-  | 'before_compaction'
-  | 'after_compaction'
-  | 'before_reset'
-  | 'message_received'
-  | 'message_sending'
-  | 'message_sent'
-  | 'before_tool_call'
-  | 'after_tool_call'
-  | 'tool_result_persist'
-  | 'session_start'
-  | 'session_end'
-  | 'gateway_start'
-  | 'gateway_stop'
-
-export type PluginApi = {
-  /** id from openclaw.plugin.json */
-  id: string
-  /** name from openclaw.plugin.json */
-  name: string
-  /** version from openclaw.plugin.json */
-  version?: string
-  /** description from openclaw.plugin.json */
-  description?: string
-  source?: string
-  config?: Record<string, unknown>
-  pluginConfig?: Record<string, unknown>
-  runtime: PluginRuntime
-  logger: PluginLogger
-  registerGatewayMethod: (method: string, handler: GatewayRequestHandler) => void
-  registerTool: (
-    tool: {
-      name: string
-      description: string
-      parameters: Record<string, unknown>
-      execute: (
-        toolCallId: string,
-        params: Record<string, unknown>,
-      ) => Promise<{content: Array<{type: string; text: string}>; details?: unknown}>
-    },
-    opts?: {optional?: boolean},
-  ) => void
-  registerHook?: (
-    events: string | string[],
-    handler: (...args: unknown[]) => unknown,
-    opts?: {name?: string; description?: string; register?: boolean},
-  ) => void
-  registerCommand: (cmd: {
-    name: string
-    description?: string
-    acceptsArgs?: boolean
-    requireAuth?: boolean
-    handler: (ctx: {
-      args?: string
-      [key: string]: unknown
-    }) => Promise<{text: string}> | {text: string}
-  }) => void
-  registerChannel: (registration: {plugin: unknown; dock?: unknown}) => void
-  registerHttpHandler?: (
-    handler: (
-      req: import('node:http').IncomingMessage,
-      res: import('node:http').ServerResponse,
-    ) => Promise<boolean> | boolean,
-  ) => void
-  registerHttpRoute: (params: {
-    path: string
-    handler: (
-      req: import('node:http').IncomingMessage,
-      res: import('node:http').ServerResponse,
-    ) => Promise<void> | void
-  }) => void
-  registerCli?: (
-    registrar: (...args: unknown[]) => void | Promise<void>,
-    opts?: {commands?: string[]},
-  ) => void
-  registerService?: (service: {
-    id: string
-    start: (...args: unknown[]) => void | Promise<void>
-    stop?: (...args: unknown[]) => void | Promise<void>
-  }) => void
-  registerProvider?: (provider: Record<string, unknown>) => void
-  resolvePath?: (input: string) => string
-  on: (
-    hookName: PluginHookName | (string & {}),
-    handler: (...args: any[]) => any,
-    opts?: {priority?: number},
-  ) => void
-}
+export type {
+  GatewayRequestHandler,
+  PluginApi,
+  PluginHookName,
+  PluginLogger,
+  PluginRuntime,
+} from './types'
 
 export default {
   id: 'clawly-plugins',

package/internal/hooks/auto-update.ts

@@ -4,7 +4,7 @@
  */
 import {$} from 'zx'
 
-import type {PluginApi} from '../../index'
+import type {PluginApi} from '../../types'
 
 $.verbose = false
 

package/outbound.ts

@@ -85,6 +85,17 @@ export function registerOutboundMethods(api: PluginApi) {
     const dest = outboundFilePath(rawPath)
 
     if (!(await fileExists(dest))) {
+      // Fallback: TTS writes directly to /tmp/openclaw/ and the tool_result_persist hook
+      // only fires for agent tool calls, not tts.convert RPC calls. Read the source file
+      // directly if it lives in the known-safe TTS temp directory.
+      if (rawPath.startsWith('/tmp/openclaw/') && (await fileExists(rawPath))) {
+        const buffer = await fsp.readFile(rawPath)
+        api.logger.info(
+          `clawly.file.getOutbound: served from source ${rawPath} (${buffer.length} bytes)`,
+        )
+        respond(true, {base64: buffer.toString('base64')})
+        return
+      }
       api.logger.warn(`outbound: file not found: ${rawPath} ${dest}`)
       respond(false, undefined, {code: 'not_found', message: 'outbound file not found'})
       return

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2en/clawly-plugins",
-  "version": "1.24.2",
+  "version": "1.24.4",
   "module": "index.ts",
   "type": "module",
   "repository": {
@@ -17,6 +17,8 @@
     "lib",
     "tools",
     "index.ts",
+    "types.ts",
+    "types",
     "auto-pair.ts",
     "calendar.ts",
     "config-setup.ts",

package/tools/clawly-is-user-online.ts

@@ -4,7 +4,7 @@
  *
  */
 
-import type {PluginApi} from '../index'
+import type {PluginApi} from '../types'
 import {isClientOnline} from '../gateway/presence'
 
 const TOOL_NAME = 'clawly_is_user_online'

package/tools/clawly-send-app-push.ts

@@ -6,7 +6,7 @@
  * https://docs.expo.dev/push-notifications/sending-notifications/
  */
 
-import type {PluginApi} from '../index'
+import type {PluginApi} from '../types'
 import {sendPushNotification} from '../gateway/notification'
 
 const TOOL_NAME = 'clawly_send_app_push'

package/tools/clawly-send-message.ts

@@ -7,7 +7,7 @@
  * - role: "user" — triggers agent turn via gateway RPC
  */
 
-import type {PluginApi} from '../index'
+import type {PluginApi} from '../types'
 import {callAgentGateway} from '../gateway/agent'
 import {injectAssistantMessage, resolveSessionKey} from '../gateway/inject'
 

package/tools/index.ts

@@ -1,4 +1,4 @@
-import type {PluginApi} from '../index'
+import type {PluginApi} from '../types'
 import {registerIsUserOnlineTool} from './clawly-is-user-online'
 import {registerSendAppPushTool} from './clawly-send-app-push'
 import {registerSendMessageTool} from './clawly-send-message'