@workclaw/openclaw-workclaw 1.0.202 → 1.0.331

package/index.ts

@@ -1,326 +0,0 @@
-import type { OpenClawPluginApi } from 'openclaw/plugin-sdk'
-import { mkdir, readFile, writeFile } from 'node:fs/promises'
-import path from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { emptyPluginConfigSchema } from 'openclaw/plugin-sdk'
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore - types from openclaw 4.2, local dev uses 3.13
-import { defineChannelPluginEntry } from 'openclaw/plugin-sdk/core'
-
-import { createAccountsApiHandler } from './src/api/accounts-api.js'
-import { createPromptsApiHandler } from './src/api/prompts-api.js'
-import { createSessionApiHandler } from './src/api/session-api.js'
-import { createSkillsApiHandler } from './src/api/skills-api.js'
-import { isDefaultWorkspace, resolveWorkspaceDir } from './src/api/workspace.js'
-import { workclawPlugin } from './src/channel.js'
-import { sendMessageWorkclaw } from './src/outbound/index.js'
-import {
-  deleteToolContext,
-  getToolContext,
-  getToolResultHint,
-  getWorkclawLogger,
-  getWorkclawRuntime,
-  setToolCallIdToRunIdMapping,
-  setWorkclawRuntime,
-} from './src/runtime.js'
-
-import { registerAllOpenclawWorkclawCronTools } from './src/tools/openclaw-workclaw-cron/index.js'
-
-// ============================================================================
-// Tool output formatting helpers
-// ============================================================================
-
-function formatToolParams(toolName: string | undefined, params: unknown): string {
-  if (!params || typeof params !== 'object') {
-    return ''
-  }
-
-  const normalizedToolName = (toolName || '').toLowerCase().trim()
-  const p = params as Record<string, unknown>
-
-  try {
-    if (normalizedToolName === 'exec' || normalizedToolName === 'bash' || normalizedToolName === 'shell') {
-      const cmd = p.command || p.cmd
-      if (cmd)
-        return `command: ${String(cmd).slice(0, 200)}`
-    }
-    else if (
-      normalizedToolName === 'read'
-      || normalizedToolName === 'file_read'
-      || normalizedToolName === 'view'
-    ) {
-      const p2 = p.path
-      if (p2)
-        return `path: ${p2}`
-    }
-    else if (
-      normalizedToolName === 'write'
-      || normalizedToolName === 'file_write'
-      || normalizedToolName === 'edit'
-      || normalizedToolName === 'patch'
-    ) {
-      const p2 = p.path
-      if (p2)
-        return `path: ${p2}`
-    }
-    else if (
-      normalizedToolName === 'web_fetch'
-      || normalizedToolName === 'fetch'
-      || normalizedToolName === 'http_get'
-      || normalizedToolName === 'http_request'
-      || normalizedToolName === 'open_url'
-      || normalizedToolName === 'browser_open'
-      || normalizedToolName === 'open'
-    ) {
-      const u = p.url
-      if (u)
-        return `url: ${u}`
-    }
-    else if (
-      normalizedToolName === 'search'
-      || normalizedToolName === 'web_search'
-      || normalizedToolName === 'google_search'
-      || normalizedToolName === 'browser_search'
-      || normalizedToolName === 'browser.search'
-    ) {
-      const q = p.query || p.q || p.search
-      if (q)
-        return `query: ${q}`
-    }
-    else if (
-      normalizedToolName === 'image_generate'
-      || normalizedToolName === 'generate_image'
-      || normalizedToolName === 'dalle'
-      || normalizedToolName === 'text_to_image'
-    ) {
-      const prompt = p.prompt
-      if (prompt)
-        return `prompt: ${String(prompt).slice(0, 200)}`
-    }
-    else if (
-      normalizedToolName === 'code_interpreter'
-      || normalizedToolName === 'python'
-      || normalizedToolName === 'jupyter'
-    ) {
-      const code = p.code
-      if (code)
-        return `code: ${String(code).slice(0, 200)}`
-    }
-    else if (normalizedToolName === 'mcp_deliver' || normalizedToolName === 'deliver') {
-      const target = p.target || p.to
-      if (target)
-        return `target: ${target}`
-    }
-    else {
-      const entries = Object.entries(p)
-      if (entries.length > 0) {
-        return entries
-          .map(([k, v]) => {
-            const vStr = typeof v === 'string' ? v : JSON.stringify(v)
-            return vStr.length > 100 ? `${k}: ${vStr.slice(0, 100)}...` : `${k}: ${vStr}`
-          })
-          .join('\n')
-      }
-    }
-  }
-  catch {
-    return String(params)
-  }
-
-  return ''
-}
-
-function formatToolOutput(toolName: string | undefined, params: unknown, _result: unknown): string {
-  return formatToolParams(toolName, params)
-}
-
-// ============================================================================
-// Tool hooks
-// ============================================================================
-
-function registerToolHooks(api: OpenClawPluginApi) {
-  api.on('agent_end', (event: any, ctx: any) => {
-    const { runId } = ctx || {}
-    if (runId) {
-      deleteToolContext(runId)
-      api.logger?.info?.(`[ToolHook] agent_end runId=${runId} cleaned up`)
-    }
-    return event
-  })
-
-  api.on('before_tool_call', (event: any, _ctx: any) => {
-    api.logger?.info?.(`[ToolHook] before_tool_call event=${JSON.stringify(event)}`)
-  })
-
-  api.on('after_tool_call', (event: any, _ctx: any) => {
-    api.logger?.info?.(`[ToolHook] after_tool_call event=${JSON.stringify(event)}`)
-    const { runId, toolCallId, toolName, params, result } = event || {}
-    const toolCtx = runId ? getToolContext(runId) : undefined
-
-    if (toolCtx && result) {
-      const content = formatToolOutput(toolName, params, result)
-      if (content) {
-        try {
-          const cfg = getWorkclawRuntime().config.loadConfig()
-          const formattedToolOutput = {
-            name: getToolResultHint(toolName),
-            toolName,
-            content,
-            state: 'result',
-          }
-          sendMessageWorkclaw({
-            cfg,
-            to: toolCtx.target,
-            text: JSON.stringify(formattedToolOutput),
-            msgType: '26',
-            accountId: toolCtx.accountId,
-            openConversationId: toolCtx.openConversationId,
-            agentId: toolCtx.agentId,
-            replyToMessageId: toolCtx.replyToMessageId,
-            last: false,
-            source: 'after_tool_call',
-          }).catch((err) => {
-            api.logger?.error?.(`[ToolHook] after_tool_call push failed: ${err}`)
-          })
-          api.logger?.info?.(`[ToolHook] after_tool_call pushed for toolName=${toolName}`)
-        }
-        catch (err) {
-          api.logger?.error?.(`[ToolHook] after_tool_call push failed: ${err}`)
-        }
-      }
-    }
-
-    if (runId && toolCallId) {
-      setToolCallIdToRunIdMapping(toolCallId, runId)
-    }
-
-    return event
-  })
-
-  api.on('tool_result_persist', (event: any, _ctx: any) => {
-    return { message: event.message }
-  })
-
-  api.logger?.info?.(`[ToolHook] Tool execution hooks registered`)
-}
-
-// ============================================================================
-// Templates
-// ============================================================================
-
-const templateNames = ['SOUL.md', 'IDENTITY.md'] as const
-
-/**
- * 获取插件所在目录，兼容 Windows 下的 file:// URL 问题。
- * 4.2 的插件加载器在 Windows 上可能传入不带协议前缀的路径。
- */
-function getPluginDir(): string {
-  try {
-    const url = import.meta.url
-    if (!url.startsWith('file://')) {
-      // Windows 路径被直接传入（不带 file:// 前缀），直接取目录
-      return path.dirname(url)
-    }
-    return path.dirname(fileURLToPath(url))
-  }
-  catch {
-    return process.cwd()
-  }
-}
-
-async function writeFileIfMissing(filePath: string, content: string) {
-  try {
-    await writeFile(filePath, content, { encoding: 'utf-8', flag: 'wx' })
-  }
-  catch (error) {
-    if (
-      error
-      && typeof error === 'object'
-      && 'code' in error
-      && (error as NodeJS.ErrnoException).code === 'EEXIST'
-    ) {
-      return
-    }
-    throw error
-  }
-}
-
-async function releaseTemplates(api: OpenClawPluginApi) {
-  const workspaceDir = resolveWorkspaceDir(api)
-  getWorkclawLogger().info(`workspaceDir: ${workspaceDir}`)
-  // 模板文件在根目录的 templates/ 中，而不是 dist/templates/
-  const currentDir = getPluginDir()
-  const templatesDir = path.join(
-    currentDir.endsWith('dist') ? path.dirname(currentDir) : currentDir,
-    'templates',
-  )
-  const shouldOverwrite = isDefaultWorkspace(api)
-
-  await mkdir(workspaceDir, { recursive: true })
-
-  await Promise.all(
-    templateNames.map(async (name) => {
-      const sourcePath = path.join(templatesDir, name)
-      const targetPath = path.join(workspaceDir, name)
-      const content = await readFile(sourcePath, 'utf-8')
-      if (shouldOverwrite) {
-        await writeFile(targetPath, content, { encoding: 'utf-8' })
-      }
-      else {
-        await writeFileIfMissing(targetPath, content)
-      }
-    }),
-  )
-
-  api.logger.info(`openclaw-workclaw templates ready: ${workspaceDir}`)
-}
-
-// ============================================================================
-// Plugin entry point
-// ============================================================================
-
-export default defineChannelPluginEntry({
-  id: 'openclaw-workclaw',
-  name: 'openclaw-workclaw',
-  description: '智小途 channel plugin',
-  configSchema: emptyPluginConfigSchema() as any,
-  plugin: workclawPlugin,
-  registerFull(api) {
-    setWorkclawRuntime(api.runtime)
-
-    registerAllOpenclawWorkclawCronTools(api)
-    registerToolHooks(api)
-
-    api.registerService({
-      id: 'openclaw-workclaw-templates',
-      start: async () => {
-        await releaseTemplates(api)
-      },
-    })
-
-    api.registerHttpRoute({
-      path: '/openclaw-workclaw/workspace/prompts',
-      handler: createPromptsApiHandler(api),
-      auth: 'plugin',
-    })
-
-    api.registerHttpRoute({
-      path: '/openclaw-workclaw/accounts',
-      handler: createAccountsApiHandler(api),
-      auth: 'plugin',
-    })
-
-    api.registerHttpRoute({
-      path: '/openclaw-workclaw/skills',
-      handler: createSkillsApiHandler(api),
-      auth: 'plugin',
-    })
-
-    api.registerHttpRoute({
-      path: '/openclaw-workclaw/sessions',
-      handler: createSessionApiHandler(api),
-      auth: 'plugin',
-      match: 'prefix',
-    })
-  },
-})

package/setup-entry.ts

@@ -1,13 +0,0 @@
-import { defineBundledChannelSetupEntry } from 'openclaw/plugin-sdk/channel-entry-contract'
-
-export default defineBundledChannelSetupEntry({
-  importMetaUrl: import.meta.url,
-  plugin: {
-    specifier: './api.js',
-    exportName: 'workclawPlugin',
-  },
-  secrets: {
-    specifier: './src/secret-contract-api.js',
-    exportName: 'channelSecrets',
-  },
-})

package/src/accounts.ts

@@ -1,360 +0,0 @@
-import type { OpenClawConfig } from 'openclaw/plugin-sdk'
-import type {
-  ResolvedWorkclawAccount,
-  WorkclawAccountConfig,
-  WorkclawConfig,
-} from './types.js'
-import { DEFAULT_ACCOUNT_ID } from 'openclaw/plugin-sdk/account-id'
-import { getWorkclawConnectionConfig, getWorkclawLogger } from './runtime.js'
-
-// =============================================================================
-// In-memory lookup cache for (userId, agentId) → workspace-N accountId
-// Problem: OpenClaw doesn't support dashes in account IDs, agentId can be negative
-// Solution: workspace-N naming + in-memory Map for O(1) lookups
-// =============================================================================
-
-/**
- * Normalize account ID by trimming whitespace
- */
-export function normalizeAccountId(accountId: string | null | undefined): string {
-  return String(accountId ?? '').trim()
-}
-
-/**
- * Key format for the lookup map: "userId|agentId"
- */
-function makeLookupKey(userId: string, agentId: string): string {
-  return `${userId}|${agentId}`
-}
-
-/**
- * In-memory map: lookupKey -> accountId
- */
-const lookupCache = new Map<string, string>()
-
-/**
- * In-memory map: accountId -> { userId, agentId }
- */
-const accountIndex = new Map<string, { userId: string, agentId: string }>()
-
-/**
- * Next workspace number to allocate
- */
-let nextWorkspaceNum = 1
-
-/**
- * Build the lookup cache from existing accounts in cfg.
- * Called once at gateway startup.
- */
-export function buildAccountMap(cfg: OpenClawConfig): void {
-  lookupCache.clear()
-  accountIndex.clear()
-  nextWorkspaceNum = 1
-
-  const _WorkclawConfig = (cfg.channels?.['openclaw-workclaw'] || {}) as WorkclawConfig
-
-  const accounts = _WorkclawConfig?.accounts
-  if (!accounts || typeof accounts !== 'object')
-    return
-
-  for (const [accountId, accountCfg] of Object.entries(accounts)) {
-    if (!accountCfg)
-      continue
-    const userId = accountCfg.userId || _WorkclawConfig.userId
-    const agentId = accountCfg.agentId
-    if (!agentId)
-      continue
-
-    // userId may not be present for config-defined accounts; only build
-    // lookup if userId is available (dynamically created accounts have it)
-    if (userId) {
-      const key = makeLookupKey(String(userId), String(agentId))
-      lookupCache.set(key, accountId)
-    }
-    accountIndex.set(accountId, { userId: String(userId ?? ''), agentId: String(agentId) })
-
-    if (accountId.startsWith('workspace-')) {
-      const num = Number.parseInt(accountId.slice(accountId.lastIndexOf('-') + 1), 10)
-      if (!Number.isNaN(num) && num >= nextWorkspaceNum) {
-        nextWorkspaceNum = num + 1
-      }
-    }
-  }
-
-  // 默认账户允许直接使用顶层 userId/agentId，不要求必须存在 accounts.default
-  if (!accountIndex.has(DEFAULT_ACCOUNT_ID) && _WorkclawConfig.userId && _WorkclawConfig.agentId) {
-    const userId = String(_WorkclawConfig.userId)
-    const agentId = String(_WorkclawConfig.agentId)
-    const key = makeLookupKey(userId, agentId)
-    lookupCache.set(key, DEFAULT_ACCOUNT_ID)
-    accountIndex.set(DEFAULT_ACCOUNT_ID, { userId, agentId })
-  }
-
-  getWorkclawLogger().info(`[AccountManager] Built account map with ${lookupCache.size} entries, nextWorkspaceNum=${nextWorkspaceNum}`)
-}
-
-/**
- * Resolve accountId by userId + agentId.
- * First checks cache, then falls back to iteration.
- */
-export function resolveAccountByUserIdAndAgentId(
-  cfg: OpenClawConfig,
-  userId: string,
-  agentId: string,
-): string | null {
-  const key = makeLookupKey(userId, agentId)
-
-  if (lookupCache.has(key)) {
-    return lookupCache.get(key)!
-  }
-
-  const _WorkclawConfig = (cfg.channels?.['openclaw-workclaw'] || {}) as WorkclawConfig
-  const accounts = _WorkclawConfig?.accounts
-  if (accounts && typeof accounts === 'object') {
-    for (const [accountId, accountCfg] of Object.entries(accounts)) {
-      if (!accountCfg)
-        continue
-      const accountUserId = accountCfg.userId || _WorkclawConfig.userId
-      if (String(accountUserId) === userId && String(accountCfg.agentId) === agentId) {
-        lookupCache.set(key, accountId)
-        accountIndex.set(accountId, { userId, agentId })
-        return accountId
-      }
-    }
-  }
-
-  // 兼容默认账户直接写在顶层配置中的场景
-  if (
-    String(_WorkclawConfig.userId ?? '') === userId
-    && String(_WorkclawConfig.agentId ?? '') === agentId
-  ) {
-    lookupCache.set(key, DEFAULT_ACCOUNT_ID)
-    accountIndex.set(DEFAULT_ACCOUNT_ID, { userId, agentId })
-    return DEFAULT_ACCOUNT_ID
-  }
-
-  return null
-}
-
-/**
- * Allocate a new workspace-N accountId and register it in the map.
- */
-export function allocateWorkerAccountId(
-  _cfg: OpenClawConfig,
-  userId: string,
-  agentId: string,
-): string {
-  const accountId = `workspace-${nextWorkspaceNum}`
-  nextWorkspaceNum++
-
-  const key = makeLookupKey(userId, agentId)
-  lookupCache.set(key, accountId)
-  accountIndex.set(accountId, { userId, agentId })
-
-  getWorkclawLogger().info(`[AccountManager] Allocated accountId=${accountId} for userId=${userId} agentId=${agentId}`)
-  return accountId
-}
-
-/**
- * Refresh the cache when an account's userId or agentId changes.
- */
-export function refreshAccountCache(cfg: OpenClawConfig): void {
-  buildAccountMap(cfg)
-}
-
-// =============================================================================
-// Account config resolution (pure functions, no in-memory state)
-// =============================================================================
-
-/**
- * List all configured account IDs from the accounts field.
- */
-function listConfiguredAccountIds(cfg: OpenClawConfig): string[] {
-  const accounts = (cfg.channels?.['openclaw-workclaw'] as WorkclawConfig)?.accounts
-  if (!accounts || typeof accounts !== 'object') {
-    return []
-  }
-  return Object.keys(accounts).filter(Boolean)
-}
-
-/**
- * Check if plugin-level workclaw config exists (appKey + appSecret)
- */
-function hasPluginLevelWorkClawConfig(cfg: OpenClawConfig): boolean {
-  const workclawCfg = cfg.channels?.['openclaw-workclaw'] as WorkclawConfig | undefined
-  const key = typeof workclawCfg?.appKey === 'string' ? workclawCfg.appKey.trim() : ''
-  const secret = typeof workclawCfg?.appSecret === 'string' ? workclawCfg.appSecret.trim() : ''
-  return Boolean(key && secret)
-}
-
-/**
- * List all account IDs.
- * If no accounts are configured but plugin has workclaw config, returns [DEFAULT_ACCOUNT_ID].
- */
-export function listWorkclawAccountIds(cfg: OpenClawConfig): string[] {
-  const ids = listConfiguredAccountIds(cfg)
-  if (ids.length === 0) {
-    // 如果没有配置账户，但插件级别有 workclaw 配置，返回默认账户
-    if (hasPluginLevelWorkClawConfig(cfg)) {
-      return [DEFAULT_ACCOUNT_ID]
-    }
-    // Backward compatibility: no accounts configured, use default
-    return [DEFAULT_ACCOUNT_ID]
-  }
-  return [...ids].toSorted((a, b) => a.localeCompare(b))
-}
-
-/**
- * Resolve the default account ID.
- */
-export function resolveDefaultWorkclawAccountId(cfg: OpenClawConfig): string {
-  const ids = listWorkclawAccountIds(cfg)
-  if (ids.includes(DEFAULT_ACCOUNT_ID)) {
-    return DEFAULT_ACCOUNT_ID
-  }
-  return ids[0] ?? DEFAULT_ACCOUNT_ID
-}
-
-/**
- * Get the raw account-specific config.
- */
-function resolveAccountConfig(
-  cfg: OpenClawConfig,
-  accountId: string,
-): WorkclawAccountConfig | undefined {
-  const accounts = (cfg.channels?.['openclaw-workclaw'] as WorkclawConfig)?.accounts
-  if (!accounts || typeof accounts !== 'object') {
-    return undefined
-  }
-  return accounts[accountId]
-}
-
-function hasWorkClawConfig(config: {
-  appKey?: string
-  appSecret?: string
-  agentId?: string | number
-}): boolean {
-  const key = typeof config.appKey === 'string' ? config.appKey.trim() : ''
-  const secret
-    = typeof config.appSecret === 'string' ? config.appSecret.trim() : ''
-  // 只要有 appKey 和 appSecret 就认为配置了 workclaw（agentId 可以动态添加）
-  return Boolean(key && secret)
-}
-
-export function isWorkclawAccountConfigured(config: {
-  appKey?: string
-  appSecret?: string
-  agentId?: string | number
-}): boolean {
-  return hasWorkClawConfig(config)
-}
-
-/**
- * Merge top-level config with account-specific config.
- * Account-specific fields override top-level fields.
- */
-function mergeWorkclawAccountConfig(cfg: OpenClawConfig, accountId: string): WorkclawConfig {
-  const workclawCfg = cfg.channels?.['openclaw-workclaw'] as WorkclawConfig | undefined
-
-  // Extract base config (exclude accounts field to avoid recursion)
-  const { accounts: _ignored, ...base } = workclawCfg ?? {}
-
-  // Get account-specific overrides
-  const account = resolveAccountConfig(cfg, accountId) ?? {}
-
-  // Merge: account config overrides base config
-  return { ...base, ...account } as WorkclawConfig
-}
-
-/**
- * Resolve a complete account with merged config.
- */
-export function resolveWorkclawAccount(params: {
-  cfg: OpenClawConfig
-  accountId?: string | null
-}): ResolvedWorkclawAccount {
-  const accountId = normalizeAccountId(params.accountId)
-  const workclawCfg = params.cfg.channels?.['openclaw-workclaw'] as WorkclawConfig | undefined
-
-  // Base enabled state (top-level)
-  const baseEnabled = workclawCfg?.enabled !== false
-
-  // Merge configs
-  const merged = mergeWorkclawAccountConfig(params.cfg, accountId)
-
-  // Account-level enabled state
-  const accountEnabled = merged.enabled !== false
-  const enabled = baseEnabled && accountEnabled
-
-  return {
-    accountId,
-    enabled,
-    configured: isWorkclawAccountConfigured(merged),
-    name: (merged as WorkclawAccountConfig).name?.trim() || undefined,
-    config: merged,
-  }
-}
-
-/**
- * List all enabled and configured accounts.
- */
-export function listEnabledWorkclawAccounts(cfg: OpenClawConfig): ResolvedWorkclawAccount[] {
-  return listConfiguredAccountIds(cfg)
-    .map(accountId => resolveWorkclawAccount({ cfg, accountId }))
-    .filter(account => account.enabled && account.configured)
-}
-
-/**
- * Resolve account and apply cached connection config if available.
- * This ensures that appKey/appSecret etc. use the stable values captured at connection time,
- * not potentially mutated values from cfg at resolution time.
- */
-export function resolveWorkclawAccountWithCache(params: {
-  cfg: OpenClawConfig
-  accountId?: string | null
-}): ResolvedWorkclawAccount {
-  const account = resolveWorkclawAccount(params)
-  const cachedConfig = getWorkclawConnectionConfig(account.accountId)
-
-  if (cachedConfig) {
-    // Apply cached values to ensure stability
-    account.config.appKey = cachedConfig.appKey || account.config.appKey
-    account.config.appSecret = cachedConfig.appSecret || account.config.appSecret
-    if (cachedConfig.baseUrl)
-      account.config.baseUrl = cachedConfig.baseUrl
-    if (cachedConfig.websocketUrl !== undefined)
-      account.config.websocketUrl = cachedConfig.websocketUrl
-    if (cachedConfig.localIp !== undefined)
-      account.config.localIp = cachedConfig.localIp
-    if (cachedConfig.allowInsecureTls !== undefined)
-      account.config.allowInsecureTls = cachedConfig.allowInsecureTls
-    if (cachedConfig.requestTimeout !== undefined)
-      account.config.requestTimeout = cachedConfig.requestTimeout
-  }
-
-  return account
-}
-
-/**
- * Inspect and probe workclaw credentials.
- * Returns a function that can be called to test the connection.
- */
-export function inspectWorkclawCredentials(workclawCfg?: WorkclawConfig): (() => Promise<{ ok: boolean, botName?: string }>) | null {
-  const appKey = typeof workclawCfg?.appKey === 'string' ? workclawCfg.appKey.trim() : ''
-  const appSecret = typeof workclawCfg?.appSecret === 'string' ? workclawCfg.appSecret.trim() : ''
-
-  if (!appKey || !appSecret) {
-    return null
-  }
-
-  return async () => {
-    try {
-      // 这里可以实现凭证验证逻辑
-      // 暂时返回成功,因为实际验证需要连接工作线程
-      return { ok: true }
-    }
-    catch {
-      return { ok: false }
-    }
-  }
-}