aamp-openclaw-plugin 0.1.7 → 0.1.10

package/README.md

@@ -27,14 +27,14 @@ npm run build
 {
   "plugins": {
     "entries": {
-      "aamp": {
+      "aamp-openclaw-plugin": {
         "enabled": true,
         "config": {
           "aampHost": "https://meshmail.ai",
           "slug": "openclaw-agent",
-          "credentialsFile": ".aamp-identity.json",
+          "credentialsFile": "~/.openclaw/extensions/aamp-openclaw-plugin/.credentials.json",
           "allowedSenders": [
-            "system@aamp.local"
+            "meegle-bot@meshmail.ai"
           ]
         }
       }

package/bin/aamp-openclaw-plugin.mjs

@@ -0,0 +1,328 @@
+#!/usr/bin/env node
+
+import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { dirname, join } from 'node:path'
+import { createInterface } from 'node:readline/promises'
+import { stdin as input, stdout as output, stderr } from 'node:process'
+import { spawnSync } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
+
+const PLUGIN_ID = 'aamp-openclaw-plugin'
+const DEFAULT_AAMP_HOST = 'https://meshmail.ai'
+const DEFAULT_CREDENTIALS_FILE = '~/.openclaw/extensions/aamp-openclaw-plugin/.credentials.json'
+
+function resolveOpenClawHome() {
+  return process.env.OPENCLAW_HOME?.trim() || join(homedir(), '.openclaw')
+}
+
+function resolveOpenClawConfigPath() {
+  return join(resolveOpenClawHome(), 'openclaw.json')
+}
+
+function resolveExtensionDir() {
+  return join(resolveOpenClawHome(), 'extensions', PLUGIN_ID)
+}
+
+function expandHome(pathValue) {
+  if (!pathValue) return pathValue
+  if (pathValue === '~') return homedir()
+  if (pathValue.startsWith('~/')) return join(homedir(), pathValue.slice(2))
+  return pathValue
+}
+
+function readJsonFile(path) {
+  if (!existsSync(path)) return null
+  return JSON.parse(readFileSync(path, 'utf-8'))
+}
+
+function writeJsonFile(path, value) {
+  mkdirSync(dirname(path), { recursive: true })
+  writeFileSync(path, JSON.stringify(value, null, 2) + '\n', 'utf-8')
+}
+
+function normalizeBaseUrl(url) {
+  if (url.startsWith('http://') || url.startsWith('https://')) return url.replace(/\/$/, '')
+  return `https://${url.replace(/\/$/, '')}`
+}
+
+function ensurePluginConfig(config, pluginConfig) {
+  const next = config && typeof config === 'object' ? structuredClone(config) : {}
+  if (!next.plugins || typeof next.plugins !== 'object') next.plugins = {}
+  if (!Array.isArray(next.plugins.allow)) next.plugins.allow = []
+  if (!next.plugins.entries || typeof next.plugins.entries !== 'object') next.plugins.entries = {}
+
+  if (!next.plugins.allow.includes(PLUGIN_ID)) {
+    next.plugins.allow.push(PLUGIN_ID)
+  }
+
+  const legacyEntry = next.plugins.entries.aamp
+  const prevEntry = next.plugins.entries[PLUGIN_ID] ?? legacyEntry
+  const mergedConfig = {
+    ...(prevEntry?.config && typeof prevEntry.config === 'object' ? prevEntry.config : {}),
+    ...pluginConfig,
+  }
+  if (!pluginConfig.allowedSenders) {
+    delete mergedConfig.allowedSenders
+  }
+
+  next.plugins.entries[PLUGIN_ID] = {
+    enabled: true,
+    ...(prevEntry && typeof prevEntry === 'object' ? prevEntry : {}),
+    config: mergedConfig,
+  }
+
+  if (next.plugins.entries.aamp) {
+    delete next.plugins.entries.aamp
+  }
+
+  return next
+}
+
+function parseAllowedSenders(raw) {
+  const trimmed = raw.trim()
+  if (!trimmed) return undefined
+  return trimmed
+    .split(',')
+    .map((s) => s.trim())
+    .filter(Boolean)
+}
+
+function packageRootFromEntry(entryPath) {
+  let current = dirname(entryPath)
+  while (current !== dirname(current)) {
+    if (existsSync(join(current, 'package.json'))) return current
+    current = dirname(current)
+  }
+  throw new Error(`Could not locate package root for ${entryPath}`)
+}
+
+function copyIntoDir(src, dest) {
+  cpSync(src, dest, { recursive: true, force: true })
+}
+
+function installPluginFiles(credentialsFile = DEFAULT_CREDENTIALS_FILE) {
+  const extensionDir = resolveExtensionDir()
+  const packageRoot = packageRootFromEntry(fileURLToPath(import.meta.url))
+  const packageJson = readJsonFile(join(packageRoot, 'package.json'))
+  const credentialsPath = expandHome(credentialsFile)
+  const existingCredentials = existsSync(credentialsPath)
+    ? readFileSync(credentialsPath)
+    : null
+
+  rmSync(extensionDir, { recursive: true, force: true })
+  mkdirSync(extensionDir, { recursive: true })
+
+  for (const rel of packageJson.files ?? []) {
+    const src = join(packageRoot, rel)
+    if (existsSync(src)) {
+      copyIntoDir(src, join(extensionDir, rel))
+    }
+  }
+
+  writeJsonFile(join(extensionDir, 'package.json'), packageJson)
+
+  const dependencyPackages = ['aamp-sdk', 'ws', 'nodemailer']
+  const nodeModulesDir = join(extensionDir, 'node_modules')
+  mkdirSync(nodeModulesDir, { recursive: true })
+
+  for (const dep of dependencyPackages) {
+    const depRoot = join(packageRoot, 'node_modules', dep)
+    if (!existsSync(depRoot)) {
+      throw new Error(`Missing dependency directory: ${depRoot}`)
+    }
+    copyIntoDir(depRoot, join(nodeModulesDir, dep))
+  }
+
+  if (existingCredentials) {
+    mkdirSync(dirname(credentialsPath), { recursive: true })
+    writeFileSync(credentialsPath, existingCredentials)
+  }
+
+  return extensionDir
+}
+
+function restartGateway() {
+  const result = spawnSync('openclaw', ['gateway', 'restart'], {
+    encoding: 'utf-8',
+  })
+
+  if (result.error) {
+    return {
+      ok: false,
+      reason: result.error.message,
+    }
+  }
+
+  if (result.status !== 0) {
+    return {
+      ok: false,
+      reason: (result.stderr || result.stdout || `exit code ${result.status}`).trim(),
+    }
+  }
+
+  return {
+    ok: true,
+    message: (result.stdout || 'Gateway restart requested successfully.').trim(),
+  }
+}
+
+async function ensureMailboxIdentity({ aampHost, slug, credentialsFile }) {
+  const resolvedCreds = expandHome(credentialsFile)
+  if (existsSync(resolvedCreds)) {
+    return { created: false, email: null, credentialsPath: resolvedCreds }
+  }
+
+  const base = normalizeBaseUrl(aampHost)
+  const registerRes = await fetch(`${base}/api/nodes/self-register`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({
+      slug,
+      description: 'OpenClaw AAMP agent node',
+    }),
+  })
+
+  if (!registerRes.ok) {
+    const text = await registerRes.text().catch(() => '')
+    throw new Error(`AAMP self-register failed (${registerRes.status}): ${text || registerRes.statusText}`)
+  }
+
+  const registerData = await registerRes.json()
+  const code = registerData?.registrationCode
+  if (!code) {
+    throw new Error('AAMP self-register succeeded but no registrationCode was returned')
+  }
+
+  const credRes = await fetch(`${base}/api/nodes/credentials?code=${encodeURIComponent(code)}`)
+  if (!credRes.ok) {
+    const text = await credRes.text().catch(() => '')
+    throw new Error(`AAMP credential exchange failed (${credRes.status}): ${text || credRes.statusText}`)
+  }
+
+  const credData = await credRes.json()
+  const identity = {
+    email: credData?.email,
+    jmapToken: credData?.jmap?.token,
+    smtpPassword: credData?.smtp?.password,
+  }
+
+  if (!identity.email || !identity.jmapToken || !identity.smtpPassword) {
+    throw new Error('AAMP credential exchange returned an incomplete identity payload')
+  }
+
+  writeJsonFile(resolvedCreds, identity)
+  return { created: true, email: identity.email, credentialsPath: resolvedCreds }
+}
+
+function printHelp() {
+  output.write(
+    [
+      'aamp-openclaw-plugin',
+      '',
+      'Commands:',
+      '  init   Install the OpenClaw plugin and write ~/.openclaw/openclaw.json',
+      '  help   Show this help',
+      '',
+    ].join('\n'),
+  )
+}
+
+async function runInit() {
+  let aampHost = DEFAULT_AAMP_HOST
+  let allowedSenders
+
+  if (input.isTTY) {
+    const rl = createInterface({ input, output })
+    try {
+      output.write('AAMP OpenClaw Plugin Setup\n\n')
+
+      const aampHostAnswer = await rl.question(`AAMP Host (${DEFAULT_AAMP_HOST}): `)
+      aampHost = aampHostAnswer.trim() || DEFAULT_AAMP_HOST
+
+      const allowedSendersAnswer = await rl.question(
+        'Allowed Senders (comma-separated, leave blank to allow all): ',
+      )
+      allowedSenders = parseAllowedSenders(allowedSendersAnswer)
+    } finally {
+      rl.close()
+    }
+  } else {
+    const [hostLine = '', sendersLine = ''] = readFileSync(0, 'utf-8').split(/\r?\n/)
+    aampHost = hostLine.trim() || DEFAULT_AAMP_HOST
+    allowedSenders = parseAllowedSenders(sendersLine)
+  }
+
+  const configPath = resolveOpenClawConfigPath()
+  const existing = readJsonFile(configPath)
+  const previousEntry = existing?.plugins?.entries?.[PLUGIN_ID] ?? existing?.plugins?.entries?.aamp
+  const previousCredentialsFile = previousEntry?.config?.credentialsFile || DEFAULT_CREDENTIALS_FILE
+
+  output.write('\nInstalling OpenClaw plugin files...\n')
+  const extensionDir = installPluginFiles(previousCredentialsFile)
+
+  const next = ensurePluginConfig(existing, {
+    aampHost,
+    slug: 'openclaw-agent',
+    credentialsFile: DEFAULT_CREDENTIALS_FILE,
+    ...(allowedSenders ? { allowedSenders } : {}),
+  })
+
+  writeJsonFile(configPath, next)
+
+  const identityResult = await ensureMailboxIdentity({
+    aampHost,
+    slug: 'openclaw-agent',
+    credentialsFile: DEFAULT_CREDENTIALS_FILE,
+  })
+
+  const restartResult = restartGateway()
+
+  output.write(
+    [
+      '',
+      `Updated ${configPath}`,
+      `Installed files to ${extensionDir}`,
+      '',
+      'Configured plugin entry:',
+      `  plugins.entries["${PLUGIN_ID}"]`,
+      `  aampHost: ${aampHost}`,
+      `  credentialsFile: ${DEFAULT_CREDENTIALS_FILE}`,
+      `  allowedSenders: ${allowedSenders ? allowedSenders.join(', ') : '(allow all)'}`,
+      identityResult.created
+        ? `  mailbox: ${identityResult.email} (registered and saved to ${identityResult.credentialsPath})`
+        : `  mailbox: existing credentials reused from ${identityResult.credentialsPath}`,
+      '',
+      restartResult.ok
+        ? `Gateway restart: ${restartResult.message}`
+        : `Gateway restart failed: ${restartResult.reason}`,
+      restartResult.ok
+        ? 'Plugin changes should now be active.'
+        : 'Please restart the OpenClaw gateway manually for the plugin changes to take effect.',
+      '',
+    ].join('\n'),
+  )
+}
+
+async function main() {
+  const command = process.argv[2] || 'help'
+
+  if (command === 'help' || command === '--help' || command === '-h') {
+    printHelp()
+    return
+  }
+
+  if (command === 'init') {
+    await runInit()
+    return
+  }
+
+  stderr.write(`Unknown command: ${command}\n\n`)
+  printHelp()
+  process.exitCode = 1
+}
+
+main().catch((err) => {
+  stderr.write(`${err instanceof Error ? err.message : String(err)}\n`)
+  process.exit(1)
+})

package/dist/file-store.js

@@ -0,0 +1,43 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+function defaultCredentialsPath() {
+  return join(homedir(), ".openclaw", "extensions", "aamp-openclaw-plugin", ".credentials.json");
+}
+function loadCachedIdentity(file) {
+  const resolved = file ?? defaultCredentialsPath();
+  if (!existsSync(resolved))
+    return null;
+  try {
+    const parsed = JSON.parse(readFileSync(resolved, "utf-8"));
+    if (!parsed.email || !parsed.jmapToken || !parsed.smtpPassword)
+      return null;
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function saveCachedIdentity(identity, file) {
+  const resolved = file ?? defaultCredentialsPath();
+  mkdirSync(dirname(resolved), { recursive: true });
+  writeFileSync(resolved, JSON.stringify(identity, null, 2), "utf-8");
+}
+function ensureDir(dir) {
+  mkdirSync(dir, { recursive: true });
+}
+function readBinaryFile(path) {
+  return readFileSync(path);
+}
+function writeBinaryFile(path, content) {
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, content);
+}
+export {
+  defaultCredentialsPath,
+  ensureDir,
+  loadCachedIdentity,
+  readBinaryFile,
+  saveCachedIdentity,
+  writeBinaryFile
+};
+//# sourceMappingURL=file-store.js.map

package/dist/file-store.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/file-store.ts"],
+  "sourcesContent": ["import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\nimport { homedir } from 'node:os'\n\nexport interface Identity {\n  email: string\n  jmapToken: string\n  smtpPassword: string\n}\n\nexport function defaultCredentialsPath(): string {\n  return join(homedir(), '.openclaw', 'extensions', 'aamp-openclaw-plugin', '.credentials.json')\n}\n\nexport function loadCachedIdentity(file?: string): Identity | null {\n  const resolved = file ?? defaultCredentialsPath()\n  if (!existsSync(resolved)) return null\n  try {\n    const parsed = JSON.parse(readFileSync(resolved, 'utf-8')) as Partial<Identity>\n    if (!parsed.email || !parsed.jmapToken || !parsed.smtpPassword) return null\n    return parsed as Identity\n  } catch {\n    return null\n  }\n}\n\nexport function saveCachedIdentity(identity: Identity, file?: string): void {\n  const resolved = file ?? defaultCredentialsPath()\n  mkdirSync(dirname(resolved), { recursive: true })\n  writeFileSync(resolved, JSON.stringify(identity, null, 2), 'utf-8')\n}\n\nexport function ensureDir(dir: string): void {\n  mkdirSync(dir, { recursive: true })\n}\n\nexport function readBinaryFile(path: string): Buffer {\n  return readFileSync(path)\n}\n\nexport function writeBinaryFile(path: string, content: Uint8Array | Buffer): void {\n  mkdirSync(dirname(path), { recursive: true })\n  writeFileSync(path, content)\n}\n"],
+  "mappings": "AAAA,SAAS,YAAY,WAAW,cAAc,qBAAqB;AACnE,SAAS,SAAS,YAAY;AAC9B,SAAS,eAAe;AAQjB,SAAS,yBAAiC;AAC/C,SAAO,KAAK,QAAQ,GAAG,aAAa,cAAc,wBAAwB,mBAAmB;AAC/F;AAEO,SAAS,mBAAmB,MAAgC;AACjE,QAAM,WAAW,QAAQ,uBAAuB;AAChD,MAAI,CAAC,WAAW,QAAQ;AAAG,WAAO;AAClC,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,aAAa,UAAU,OAAO,CAAC;AACzD,QAAI,CAAC,OAAO,SAAS,CAAC,OAAO,aAAa,CAAC,OAAO;AAAc,aAAO;AACvE,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,mBAAmB,UAAoB,MAAqB;AAC1E,QAAM,WAAW,QAAQ,uBAAuB;AAChD,YAAU,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AAChD,gBAAc,UAAU,KAAK,UAAU,UAAU,MAAM,CAAC,GAAG,OAAO;AACpE;AAEO,SAAS,UAAU,KAAmB;AAC3C,YAAU,KAAK,EAAE,WAAW,KAAK,CAAC;AACpC;AAEO,SAAS,eAAe,MAAsB;AACnD,SAAO,aAAa,IAAI;AAC1B;AAEO,SAAS,gBAAgB,MAAc,SAAoC;AAChF,YAAU,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;AAC5C,gBAAc,MAAM,OAAO;AAC7B;",
+  "names": []
+}