neuralos 3.9.4 → 3.9.6

package/plugins/monid-bridge/index.mjs

@@ -1,228 +0,0 @@
-/**
- * monid-bridge — thin wrapper around the official Monid CLI (v0.1.6).
- *
- * Settings → Plugins → Monid (settings.monid): enabled, binaryPath, keyLabel
- * API key is NEVER stored in settings.json (`monid keys add -k … -l …`).
- *
- * Agent tools: monid_health, monid_discover, monid_inspect, monid_run.
- *
- * Argv MUST match `monid <cmd> --help`:
- *   discover --query <q> [--limit n] [--min-score s] --json
- *   inspect  --provider <p> --endpoint <e> --json
- *   run      --provider <p> --endpoint <e> [--input json] [--query json] [--path json] --json
- * Bare `discover <query>` / `run <tool>` are false positives (CLI rejects them).
- */
-
-import { createRequire } from 'node:module'
-
-const require = createRequire(import.meta.url)
-
-export function resolveConfig(ctx = {}, env = process.env) {
-  const s = (typeof ctx.getSettings === 'function' ? ctx.getSettings() : ctx.settings) || {}
-  const b = s.monid || {}
-  return {
-    enabled: b.enabled !== false,
-    binaryPath: b.binaryPath || env.MONID_BIN || 'monid',
-    keyLabel: b.keyLabel || 'rterm',
-  }
-}
-
-function reqStr(v, name) {
-  const s = String(v ?? '').trim()
-  if (!s) throw new Error(`${name} is required`)
-  return s
-}
-
-function optJsonFlag(argv, flag, value) {
-  if (value == null) return
-  const s = typeof value === 'string' ? value.trim() : JSON.stringify(value)
-  if (!s) return
-  argv.push(flag, s)
-}
-
-function optNumFlag(argv, flag, value) {
-  if (value == null || value === '') return
-  const n = Number(value)
-  if (!Number.isFinite(n)) throw new Error(`${flag} must be a number`)
-  argv.push(flag, String(n))
-}
-
-/**
- * Build argv AFTER the binary name.
- * Always pass --json so agents get structured output (no ANSI).
- */
-export function buildMonidArgv(sub, params = {}) {
-  switch (sub) {
-    case 'version':
-      return ['--version']
-    case 'keys-list':
-      return ['keys', 'list']
-    case 'whoami':
-      return ['whoami']
-    case 'discover': {
-      const q = reqStr(params.query, 'query')
-      const argv = ['discover', '--query', q]
-      optNumFlag(argv, '--limit', params.limit)
-      optNumFlag(argv, '--min-score', params.minScore ?? params['min-score'])
-      argv.push('--json')
-      return argv
-    }
-    case 'inspect': {
-      const provider = reqStr(params.provider, 'provider')
-      const endpoint = reqStr(params.endpoint, 'endpoint')
-      return ['inspect', '--provider', provider, '--endpoint', endpoint, '--json']
-    }
-    case 'run': {
-      // FN: agents may pass tool="provider/endpoint" from older docs.
-      let provider = String(params.provider || '').trim()
-      let endpoint = String(params.endpoint || '').trim()
-      const tool = String(params.tool || '').trim()
-      if ((!provider || !endpoint) && tool) {
-        const slash = tool.indexOf('/')
-        if (slash > 0) {
-          provider = provider || tool.slice(0, slash)
-          endpoint = endpoint || tool.slice(slash)
-        }
-      }
-      if (!provider) throw new Error('monid_run needs provider (slug from discover)')
-      if (!endpoint) throw new Error('monid_run needs endpoint (path from discover, e.g. /news/search)')
-      if (!endpoint.startsWith('/')) {
-        throw new Error('endpoint must start with / (Monid endpoint path, not a free-form tool name)')
-      }
-      const argv = ['run', '--provider', provider, '--endpoint', endpoint]
-      const input = params.input ?? params.body
-      if (input != null && String(input).trim()) {
-        argv.push('--input', typeof input === 'string' ? input : JSON.stringify(input))
-      }
-      optJsonFlag(argv, '--query', params.queryParams ?? params.query)
-      optJsonFlag(argv, '--path', params.pathParams ?? params.path)
-      if (params.wait != null && params.wait !== false && params.wait !== '') {
-        argv.push('--wait')
-        if (params.wait !== true) argv.push(String(params.wait))
-      }
-      argv.push('--json')
-      return argv
-    }
-    default:
-      throw new Error(`unknown monid subcommand: ${sub}`)
-  }
-}
-
-/** True if argv looks like the broken 3.3.8 shapes (for tests / guards). */
-export function isLegacyBrokenArgv(argv) {
-  if (!Array.isArray(argv) || argv.length < 2) return false
-  if (argv[0] === 'discover' && argv[1] !== '--query' && !argv[1].startsWith('-')) return true
-  if (argv[0] === 'run' && argv[1] !== '--provider' && !String(argv[1]).startsWith('-')) return true
-  return false
-}
-
-async function runMonid(ctx, cfg, argv) {
-  const env = { ...process.env, NO_COLOR: '1' }
-  if (typeof ctx.runCommand === 'function') {
-    const cmdline = [cfg.binaryPath, ...argv].map((a) => (/\s/.test(a) ? JSON.stringify(a) : a)).join(' ')
-    return ctx.runCommand({ command: cmdline, env })
-  }
-  if (typeof ctx.exec === 'function') {
-    const cmdline = [cfg.binaryPath, ...argv].map((a) => (/\s/.test(a) ? JSON.stringify(a) : a)).join(' ')
-    return ctx.exec(cmdline, { env })
-  }
-  const { execFile } = require('node:child_process')
-  return new Promise((resolve) => {
-    execFile(cfg.binaryPath, argv, { timeout: 120000, env }, (err, stdout, stderr) => {
-      resolve({
-        ok: !err,
-        exitCode: typeof err?.code === 'number' ? err.code : err ? 1 : 0,
-        stdout: String(stdout ?? ''),
-        stderr: String(stderr ?? ''),
-        error: err ? String(err.message) : undefined,
-      })
-    })
-  })
-}
-
-async function guarded(fn, log) {
-  try {
-    return await fn()
-  } catch (e) {
-    const msg = e?.message ?? String(e)
-    log?.(`[monid] ${msg}`)
-    return {
-      error: msg,
-      hint: 'Install @monid-ai/cli (`npm i -g @monid-ai/cli`) and paste an API key in Settings → Plugins → Monid. discover needs --query; run needs --provider and --endpoint.',
-    }
-  }
-}
-
-export function register(ctx) {
-  const { registerTool, log } = ctx
-  const cfg = resolveConfig(ctx)
-  if (!cfg.enabled) {
-    log?.('[monid] disabled in settings.monid.enabled')
-    return
-  }
-
-  registerTool({
-    name: 'monid_health',
-    description: 'Check the Monid CLI is installed and list configured key labels (never the secret).',
-    params: {},
-    handler: async () =>
-      guarded(async () => {
-        const ver = await runMonid(ctx, cfg, buildMonidArgv('version'))
-        const keys = await runMonid(ctx, cfg, buildMonidArgv('keys-list'))
-        const who = await runMonid(ctx, cfg, buildMonidArgv('whoami'))
-        return { binaryPath: cfg.binaryPath, keyLabel: cfg.keyLabel, version: ver, keys, whoami: who }
-      }, log),
-  })
-
-  registerTool({
-    name: 'monid_discover',
-    description:
-      'Search Monid data endpoints with natural language (company news, people, enrichment). Uses `monid discover --query`. Do not pass a bare positional query.',
-    params: {
-      query: { type: 'string', description: 'Natural-language search (required)' },
-      limit: { type: 'number', description: 'Max results (max 50)', optional: true },
-      minScore: { type: 'number', description: 'Minimum relevance score', optional: true },
-    },
-    handler: async (p) =>
-      guarded(async () => {
-        const argv = buildMonidArgv('discover', p)
-        const r = await runMonid(ctx, cfg, argv)
-        return { argv: [cfg.binaryPath, ...argv], ...r }
-      }, log),
-  })
-
-  registerTool({
-    name: 'monid_inspect',
-    description: 'Get full details for one Monid endpoint (`monid inspect --provider --endpoint`).',
-    params: {
-      provider: { type: 'string', description: 'Provider slug (e.g. context.dev)' },
-      endpoint: { type: 'string', description: 'Endpoint path (e.g. /news/search)' },
-    },
-    handler: async (p) =>
-      guarded(async () => {
-        const argv = buildMonidArgv('inspect', p)
-        const r = await runMonid(ctx, cfg, argv)
-        return { argv: [cfg.binaryPath, ...argv], ...r }
-      }, log),
-  })
-
-  registerTool({
-    name: 'monid_run',
-    description:
-      'Execute a Monid endpoint (`monid run --provider --endpoint`). provider+endpoint from discover; optional JSON --input / --query / --path. Not `monid run <toolName>`.',
-    params: {
-      provider: { type: 'string', description: 'Provider slug', optional: true },
-      endpoint: { type: 'string', description: 'Endpoint path starting with /', optional: true },
-      tool: { type: 'string', description: 'Optional shorthand provider/endpoint', optional: true },
-      input: { type: 'string', description: 'Body JSON string', optional: true },
-      queryParams: { type: 'string', description: 'Query-parameters JSON string', optional: true },
-      pathParams: { type: 'string', description: 'Path-parameters JSON string', optional: true },
-    },
-    handler: async (p) =>
-      guarded(async () => {
-        const argv = buildMonidArgv('run', p)
-        const r = await runMonid(ctx, cfg, argv)
-        return { argv: [cfg.binaryPath, ...argv], ...r }
-      }, log),
-  })
-}

package/plugins/monid-bridge/monid-bridge.extreme.spec.mjs

@@ -1,75 +0,0 @@
-import { buildMonidArgv, isLegacyBrokenArgv, resolveConfig } from './index.mjs'
-
-const assert = (c, m) => {
-  if (!c) throw new Error(`assert failed: ${m}`)
-}
-
-// --- config ---
-assert(resolveConfig({ settings: {} }).enabled === true, 'enabled default')
-assert(resolveConfig({ settings: { monid: { enabled: false } } }).enabled === false, 'disabled')
-assert(resolveConfig({ settings: { monid: { binaryPath: '/opt/monid' } } }).binaryPath === '/opt/monid', 'bin')
-assert(resolveConfig({}, { MONID_BIN: 'custom-monid' }).binaryPath === 'custom-monid', 'env bin')
-
-// --- FP: 3.3.8 positional argv must be detected as broken ---
-assert(isLegacyBrokenArgv(['discover', 'company news']) === true, 'FP discover positional')
-assert(isLegacyBrokenArgv(['run', 'foo']) === true, 'FP run positional')
-assert(isLegacyBrokenArgv(['discover', '--query', 'company news']) === false, 'good discover')
-assert(isLegacyBrokenArgv(['run', '--provider', 'x', '--endpoint', '/y']) === false, 'good run')
-
-const disc = buildMonidArgv('discover', { query: 'company news', limit: 5 })
-assert(!isLegacyBrokenArgv(disc), 'new discover not legacy')
-assert(disc[0] === 'discover' && disc[1] === '--query' && disc[2] === 'company news', `disc=${disc}`)
-assert(disc.includes('--limit') && disc.includes('5') && disc.includes('--json'), 'limit+json')
-
-assert(buildMonidArgv('version').join(' ') === '--version', 'version')
-assert(buildMonidArgv('keys-list').join(' ') === 'keys list', 'keys list')
-assert(buildMonidArgv('whoami').join(' ') === 'whoami', 'whoami')
-
-const insp = buildMonidArgv('inspect', { provider: 'context.dev', endpoint: '/news/search' })
-assert(insp.join(' ') === 'inspect --provider context.dev --endpoint /news/search --json', insp.join(' '))
-
-const run = buildMonidArgv('run', {
-  provider: 'context.dev',
-  endpoint: '/news/search',
-  input: '{"q":"acme"}',
-})
-assert(run[0] === 'run' && run.includes('--provider') && run.includes('context.dev'), 'run provider')
-assert(run.includes('--endpoint') && run.includes('/news/search'), 'run endpoint')
-assert(run.includes('--input') && run.includes('--json'), 'run input+json')
-assert(!isLegacyBrokenArgv(run), 'new run not legacy')
-
-// FN: tool="provider/endpoint" shorthand
-const fromTool = buildMonidArgv('run', { tool: 'apollo/mixed_companies/search' })
-assert(fromTool.includes('apollo') && fromTool.includes('/mixed_companies/search'), `fromTool=${fromTool}`)
-
-// FN: queryParams / pathParams
-const withQP = buildMonidArgv('run', {
-  provider: 'akta',
-  endpoint: '/v1/news',
-  queryParams: '{"q":"x"}',
-  pathParams: '{"id":"1"}',
-})
-assert(withQP.includes('--query') && withQP.includes('{"q":"x"}'), 'query flag')
-assert(withQP.includes('--path') && withQP.includes('{"id":"1"}'), 'path flag')
-
-// rejects
-let threw = false
-try { buildMonidArgv('discover', { query: '  ' }) } catch { threw = true }
-assert(threw, 'empty query')
-threw = false
-try { buildMonidArgv('run', { tool: 'not-a-path' }) } catch { threw = true }
-assert(threw, 'run without provider/endpoint')
-threw = false
-try { buildMonidArgv('run', { provider: 'x', endpoint: 'news' }) } catch { threw = true }
-assert(threw, 'endpoint must start with /')
-threw = false
-try { buildMonidArgv('inspect', { provider: 'x' }) } catch { threw = true }
-assert(threw, 'inspect needs endpoint')
-threw = false
-try { buildMonidArgv('nope') } catch { threw = true }
-assert(threw, 'unknown sub')
-threw = false
-try { buildMonidArgv('discover', { query: 'q', limit: 'nope' }) } catch { threw = true }
-assert(threw, 'bad limit')
-
-console.log('monid-bridge: all cases passed')

package/plugins/monid-bridge/plugin.json

@@ -1,15 +0,0 @@
-{
-  "name": "monid-bridge",
-  "version": "1.0.0",
-  "description": "Thin Monid CLI bridge: paste an API key in Settings → Plugins; agents get monid_discover / monid_run / monid_health wrapping the official CLI. Does not reimplement TinyFish.",
-  "entry": "index.mjs",
-  "tools": [
-    "monid_health",
-    "monid_discover",
-    "monid_inspect",
-    "monid_run"
-  ],
-  "permissions": [
-    "exec"
-  ]
-}

package/plugins/netdata-rterm/index.mjs

@@ -1,229 +0,0 @@
-/**
- * netdata-rterm plugin — Netdata integration for RTerm.
- *
- * Ingests Netdata alert webhooks (per the Netdata Cloud webhook schema),
- * correlates anomalies with RTerm's metrics ledger + incident history for
- * agent RCA, and fires triggers for auto-remediation playbooks.
- *
- * Netdata webhook alert payload fields (from Netdata docs):
- *   message, alert, info, chart, context, space, rooms, family, class,
- *   severity (warning|critical|clear), date (ISO8601), duration,
- *   additional_active_critical_alerts, additional_active_warning_alerts,
- *   alert_url
- *
- * Netdata webhook reachability payload fields:
- *   message, node, space, rooms, status (up|down), date, duration
- */
-
-// --- Pure: parse a Netdata webhook alert payload ---
-export function parseNetdataAlert(payload) {
-  if (!payload || typeof payload !== 'object') return null
-
-  // Alert notification
-  if (payload.alert && payload.severity) {
-    return {
-      kind: 'alert',
-      alert: String(payload.alert),
-      message: String(payload.message ?? ''),
-      info: String(payload.info ?? ''),
-      chart: String(payload.chart ?? ''),
-      context: String(payload.context ?? ''),
-      space: String(payload.space ?? ''),
-      family: String(payload.family ?? ''),
-      class: String(payload.class ?? ''),
-      severity: String(payload.severity), // warning | critical | clear
-      date: String(payload.date ?? ''),
-      duration: String(payload.duration ?? ''),
-      alertUrl: String(payload.alert_url ?? ''),
-      additionalCritical: Number(payload.additional_active_critical_alerts ?? 0),
-      additionalWarning: Number(payload.additional_active_warning_alerts ?? 0),
-      // host is inferred from space/node; Netdata Cloud sends space name.
-      host: String(payload.space ?? 'unknown'),
-    }
-  }
-
-  // Reachability notification
-  if (payload.node && payload.status) {
-    return {
-      kind: 'reachability',
-      message: String(payload.message ?? ''),
-      node: String(payload.node),
-      space: String(payload.space ?? ''),
-      status: String(payload.status), // up | down
-      date: String(payload.date ?? ''),
-      duration: String(payload.duration ?? ''),
-      host: String(payload.node ?? 'unknown'),
-    }
-  }
-
-  return null
-}
-
-// --- Pure: map Netdata severity to RTerm alert severity ---
-export function mapSeverity(netdataSeverity) {
-  const s = String(netdataSeverity).toLowerCase()
-  if (s === 'critical') return 'critical'
-  if (s === 'warning') return 'warning'
-  if (s === 'clear') return 'info' // alert cleared
-  return 'info'
-}
-
-// --- Pure: build an RTerm alert fingerprint from a parsed Netdata alert ---
-export function buildFingerprint(parsed) {
-  if (!parsed) return ''
-  if (parsed.kind === 'reachability') {
-    return `netdata:reachability:${parsed.host}:${parsed.status}`
-  }
-  return `netdata:${parsed.host}:${parsed.alert}:${parsed.severity}`
-}
-
-// --- Pure: build a trigger event from a parsed Netdata alert ---
-export function toTriggerEvent(parsed) {
-  if (!parsed) return null
-  const severity = parsed.kind === 'reachability'
-    ? (parsed.status === 'down' ? 'critical' : 'info')
-    : mapSeverity(parsed.severity)
-
-  return {
-    source: 'netdata',
-    fingerprint: buildFingerprint(parsed),
-    title: parsed.kind === 'reachability'
-      ? `${parsed.host} ${parsed.status === 'down' ? 'is DOWN' : 'is UP'}`
-      : `[Netdata] ${parsed.alert} on ${parsed.host}`,
-    severity,
-    detail: parsed.message || parsed.info || '',
-    labels: {
-      host: parsed.host,
-      alert: parsed.alert ?? '',
-      chart: parsed.chart ?? '',
-      context: parsed.context ?? '',
-      netdata_severity: parsed.severity ?? parsed.status ?? '',
-      netdata_space: parsed.space ?? '',
-    },
-    at: parsed.date ? new Date(parsed.date).getTime() : Date.now(),
-  }
-}
-
-// --- Pure: correlate a Netdata alert with RTerm's metrics + incidents ---
-export function correlateWithRterm(parsed, metricsLedger, incidentLedger) {
-  if (!parsed) return { recentMetrics: null, openIncidents: [], correlation: '' }
-
-  const host = parsed.host
-
-  // Pull recent metrics for the host from the ledger.
-  let recentMetrics = null
-  if (metricsLedger && typeof metricsLedger.snapshot === 'function') {
-    try {
-      recentMetrics = metricsLedger.snapshot(host)
-    } catch { /* best-effort */ }
-  }
-
-  // Pull open incidents for the host.
-  let openIncidents = []
-  if (incidentLedger && typeof incidentLedger.list === 'function') {
-    try {
-      const all = incidentLedger.list()
-      openIncidents = all.filter(
-        (inc) => Array.isArray(inc.affected) && inc.affected.includes(host) && inc.status !== 'resolved'
-      )
-    } catch { /* best-effort */ }
-  }
-
-  // Build a correlation summary for the agent.
-  const parts = []
-  if (recentMetrics) {
-    parts.push(`Recent metrics for ${host}: ${JSON.stringify(recentMetrics).slice(0, 500)}`)
-  }
-  if (openIncidents.length > 0) {
-    parts.push(`${openIncidents.length} open incident(s) for ${host}: ${openIncidents.map((i) => i.title).join('; ')}`)
-  }
-  if (parsed.kind === 'alert' && parsed.additionalCritical > 0) {
-    parts.push(`${parsed.additionalCritical} additional critical alert(s) on the same node`)
-  }
-
-  const correlation = parts.length > 0
-    ? `Netdata alert "${parsed.alert ?? parsed.message}" on ${host} correlates with: ${parts.join('. ')}.`
-    : `No prior RTerm context for ${host}.`
-
-  return { recentMetrics, openIncidents, correlation }
-}
-
-// --- Plugin entry: register tools, triggers, panel ---
-export function register(ctx) {
-  const { registerTool, registerTrigger, registerPanel, exec, readLedger, log } = ctx
-
-  // Tool: netdata_alert_summary — summarize recent Netdata alerts for a host.
-  registerTool({
-    name: 'netdata_alert_summary',
-    description: 'Summarize recent Netdata alerts for a host. Returns parsed alert details including severity, chart, context, and duration.',
-    params: { host: { type: 'string', description: 'Host name to summarize alerts for' } },
-    handler: async (params) => {
-      const host = params?.host ?? 'unknown'
-      log(`[netdata] alert summary requested for ${host}`)
-      return { host, summary: `No cached Netdata alerts for ${host}. Configure Netdata Cloud to send webhooks to RTerm's gateway.` }
-    },
-  })
-
-  // Tool: netdata_correlate — correlate a Netdata alert with RTerm's metrics + incidents.
-  registerTool({
-    name: 'netdata_correlate',
-    description: 'Correlate a Netdata alert with RTerm metrics ledger and incident history for root-cause analysis. Returns recent metrics, open incidents, and a correlation summary.',
-    params: {
-      alert: { type: 'object', description: 'Parsed Netdata alert payload (from webhook)' },
-    },
-    handler: async (params) => {
-      const parsed = parseNetdataAlert(params?.alert)
-      if (!parsed) return { error: 'Invalid Netdata alert payload' }
-
-      const metrics = readLedger ? readLedger('metrics') : null
-      const incidents = readLedger ? readLedger('incidents') : null
-
-      // readLedger returns ledger-like objects or plain data.
-      const metricsLedger = metrics && typeof metrics === 'object' && typeof metrics.snapshot === 'function' ? metrics : null
-      const incidentLedger = incidents && typeof incidents === 'object' && typeof incidents.list === 'function' ? incidents : null
-
-      const result = correlateWithRterm(parsed, metricsLedger, incidentLedger)
-      log(`[netdata] correlated alert "${parsed.alert ?? parsed.message}" on ${parsed.host}: ${result.correlation}`)
-      return { parsed, ...result }
-    },
-  })
-
-  // Trigger: netdata_critical_alert — fires when a Netdata webhook delivers a critical alert.
-  registerTrigger({
-    name: 'netdata_critical_alert',
-    description: 'Fires when Netdata sends a critical-severity alert via webhook. Use for auto-remediation playbooks.',
-    match: (event) => {
-      if (event?.source !== 'netdata') return false
-      return event.severity === 'critical'
-    },
-    action: 'run-playbook', // operator assigns a remediation playbook
-  })
-
-  // Trigger: netdata_warning_alert — fires when a Netdata webhook delivers a warning alert.
-  registerTrigger({
-    name: 'netdata_warning_alert',
-    description: 'Fires when Netdata sends a warning-severity alert via webhook. Use for investigation/diagnosis playbooks.',
-    match: (event) => {
-      if (event?.source !== 'netdata') return false
-      return event.severity === 'warning'
-    },
-    action: 'propose-change', // propose a MOP change for investigation
-  })
-
-  // Panel: netdata-alert-feed — dashboard panel showing recent Netdata alerts.
-  registerPanel({
-    name: 'netdata-alert-feed',
-    title: 'Netdata Alert Feed',
-    render: (data) => {
-      const alerts = Array.isArray(data) ? data : []
-      const rows = alerts.map((a) =>
-        `<tr><td>${a.host ?? ''}</td><td>${a.alert ?? a.message ?? ''}</td><td>${a.severity ?? a.status ?? ''}</td><td>${a.date ?? ''}</td></tr>`
-      ).join('')
-      return `<div class="netdata-alert-feed"><h3>Netdata Alerts</h3><table><thead><tr><th>Host</th><th>Alert</th><th>Severity</th><th>Date</th></tr></thead><tbody>${rows}</tbody></table></div>`
-    },
-  })
-
-  log('[netdata] netdata-rterm plugin registered: 2 tools, 2 triggers, 1 panel')
-}
-
-export default { register, parseNetdataAlert, mapSeverity, buildFingerprint, toTriggerEvent, correlateWithRterm }