Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

12.8 KB
Raw Blame
import type { Verdict } from './verdict'

/**
 * The commands hook-handler.cjs `pre-bash` refuses. The root-delete entry
 * matches a root operand, not the prefix of every absolute path. The parity
 * tests exercise the same commands against the mod and classic helpers.
 */
export const DANGEROUS_COMMANDS: readonly string[] = ['rm -rf /', 'format c:', 'del /s /q c:\\', ':(){:|:&};:']

// Keep this literal-word scanner in sync with the classic helpers/fallback.
// It joins quote fragments and escapes, but never evaluates expansions or links.
function hasRootDelete(command: string, depth = 0): boolean {
  // mask has one letter per character of word: 'u' unquoted, 'q' quoted or escaped (only unquoted braces expand).
  let word = '', mask = '', quote = '', started = false, redirect = false
  let ansiNul = false // a NUL inside $'...' ends that string, as in bash
  let inRm = false, optionsEnded = false, recursive = false, force = false, root = false
  const isRoot = (operand: string) => {
    if (!operand.startsWith('/')) return false
    const parts: string[] = []
    for (const part of operand.split('/')) {
      if (!part || part === '.') continue
      if (part === '..') parts.pop()
      else parts.push(part)
    }
    return parts.length === 0 || /[*?\[]/.test(parts[0])
  }
  // One backslash escape inside $'...', from the character after the backslash.
  // Returns the text it stands for and the index of its last character. An unknown escape keeps its backslash.
  // The command arrives lowercased, so an uppercase-U escape reads as a lowercase one: eight digits starting 0000 are one code point.
  const ansiEscape = (s: string, at: number): [string, number] => {
    const c = s[at]
    const simple: Record<string, string> = { a: '\x07', b: '\b', e: '\x1b', f: '\f', n: '\n', r: '\r', t: '\t', v: '\v', '\\': '\\', "'": "'", '"': '"', '?': '?' }
    if (simple[c] !== undefined) return [simple[c], at]
    const digits = (from: number, max: number, pattern: RegExp) => pattern.exec(s.slice(from, from + max))?.[0]
    const octal = digits(at, 3, /^[0-7]+/)
    if (octal) return [String.fromCharCode(parseInt(octal, 8) & 255), at + octal.length - 1]
    const hex = c === 'x' ? digits(at + 1, 2, /^[0-9a-f]+/) : undefined
    if (hex) return [String.fromCharCode(parseInt(hex, 16)), at + hex.length]
    const wide = c === 'u' ? (digits(at + 1, 8, /^0000[0-9a-f]{4}$/) ?? digits(at + 1, 4, /^[0-9a-f]+/)) : undefined
    if (wide) return [String.fromCodePoint(parseInt(wide, 16)), at + wide.length]
    if (c === 'c' && at + 1 < s.length) return [String.fromCharCode(s.charCodeAt(at + 1) & 31), at + 1]
    return ['\\' + c, at]
  }
  // Past the rescan bound (or the brace budget), a string is judged by its tokens: an rm and a possible root operand
  // anywhere in it deny. Quote characters are dropped first, so r"m" is still rm; a path token with braces may expand to /.
  const looseRootDelete = (text: string) => {
    const tokens = text.replace(/["'\\]/g, '').split(/[\s;&|()\x60$]+/)
    return tokens.some(t => t === 'rm' || t.endsWith('/rm')) && tokens.some(t => isRoot(t) || (t.includes('/') && /[{}]/.test(t)))
  }
  // Bash brace expansion of one word ({a,b} lists, nested or glued to text), and nothing else: no {1..3} sequences, and
  // nothing inside parameter braces after a dollar sign. Only unquoted braces and commas count. Iterative and bounded:
  // past BRACE_WORDS words or BRACE_CHARS characters of work in this call it returns undefined.
  const BRACE_WORDS = 4096
  let braceChars = 1_000_000
  // The leftmost expandable group: an unquoted {...} with an unquoted comma at its own level, outside any dollar-brace parameter. One pass.
  const firstGroup = (text: string, marks: string): [number, number[], number] | undefined => {
    const stack: { open: number; commas: number[]; dollar: boolean }[] = []
    let dollars = 0
    let best: [number, number[], number] | undefined
    for (let k = 0; k < text.length; k++) {
      if (marks[k] !== 'u') continue
      const c = text[k]
      if (c === '{') {
        const dollar = k > 0 && text[k - 1] === '$' && marks[k - 1] === 'u'
        if (dollar) dollars++
        stack.push({ open: k, commas: [], dollar: dollar || dollars > 0 })
      } else if (c === ',' && stack.length > 0) stack[stack.length - 1].commas.push(k)
      else if (c === '}' && stack.length > 0) {
        const top = stack.pop()!
        if (top.dollar && text[top.open - 1] === '$' && marks[top.open - 1] === 'u') dollars--
        if (!top.dollar && top.commas.length > 0 && (best === undefined || top.open < best[0])) best = [top.open, top.commas, k]
      }
    }
    return best
  }
  const braceExpand = (text: string, marks: string): string[] | undefined => {
    const out: string[] = []
    const todo: [string, string][] = [[text, marks]]
    while (todo.length > 0) {
      const [t, m] = todo.pop()!
      if ((braceChars -= t.length) < 0) return undefined
      const group = firstGroup(t, m)
      if (group === undefined) {
        out.push(t)
        if (out.length > BRACE_WORDS) return undefined
        continue
      }
      const [open, commas, close] = group
      const cuts = [open, ...commas, close]
      // Pushed in reverse, so the words come out in bash's left-to-right order.
      for (let c = cuts.length - 2; c >= 0; c--) {
        const from = cuts[c] + 1, to = cuts[c + 1]
        todo.push([t.slice(0, open) + t.slice(from, to) + t.slice(close + 1), m.slice(0, open) + m.slice(from, to) + m.slice(close + 1)])
      }
      if (todo.length > BRACE_WORDS) return undefined
    }
    return out
  }
  const takeWord = (w: string) => {
    if (!inRm) inRm = w === 'rm' || w.endsWith('/rm')
    else if (!optionsEnded && w === '--') optionsEnded = true
    else if (!optionsEnded && w.startsWith('-')) {
      // GNU getopt accepts any unambiguous long-option prefix: --r, --recur, --forc.
      recursive = recursive || (w.length > 2 && '--recursive'.startsWith(w)) || (/^-[a-z]*$/.test(w) && w.includes('r'))
      force = force || (w.length > 2 && '--force'.startsWith(w)) || (/^-[a-z]*$/.test(w) && w.includes('f'))
    } else root = root || isRoot(w)
    return inRm && recursive && force && root
  }
  const finishWord = () => {
    if (!started) return false
    const text = word, marks = mask
    word = ''; mask = ''; started = false
    // Literal shell strings (e.g. sh -c 'rm -rf /', or sh -c '{rm,-rf,/}') also carried the old guard.
    // Bound rescanning to four levels; beyond that judge the string by its tokens.
    if (/[\s;&|()\x60{]/.test(text)) {
      if (depth < 4 ? hasRootDelete(text, depth + 1) : looseRootDelete(text)) return true
    }
    // An unquoted {a,b} becomes separate words, as bash expands it: rm -rf {/*,} is rm -rf /*.
    const words = text.includes('{') ? braceExpand(text, marks) : [text]
    if (words === undefined) {
      // Too many alternatives to check: one of them may be the root (an rm in progress fails closed), or the
      // list itself may spell the rm: judge its tokens.
      if (inRm) root = true
      if (looseRootDelete(text.replace(/[{},]/g, ' '))) return true
      return takeWord(text)
    }
    for (const w of words) if (w !== '' && takeWord(w)) return true
    return false
  }
  // A command substitution's body, from just after its opening backtick. Bash removes a
  // backslash only before $, a backtick or a backslash (and " inside double quotes) and
  // drops backslash-newline; any other backslash stays for the nested scan.
  const substitution = (from: number, inDouble: boolean): [number, boolean] => {
    let body = '', j = from
    for (; j < command.length && command[j] !== '\x60'; j++) {
      const next = command[j + 1]
      if (command[j] === '\\' && j + 1 < command.length) {
        if (next === '\n') { j++; continue }
        if (next === '$' || next === '\x60' || next === '\\' || (inDouble && next === '"')) { body += next; j++; continue }
      }
      body += command[j]
    }
    return [j, depth < 4 ? hasRootDelete(body, depth + 1) : looseRootDelete(body)]
  }
  const finishCommand = () => {
    const denied = inRm && recursive && force && root
    inRm = optionsEnded = recursive = force = root = false
    return denied
  }
  for (let i = 0; i < command.length; i++) {
    const char = command[i]
    const redirectionAmpersand = char === '&' && (redirect || command[i + 1] === '>')
    redirect = false
    if (quote) {
      if (quote === "$'") {
        if (char === "'") { quote = ''; ansiNul = false }
        else if (char === '\\' && i + 1 < command.length) {
          const [text, last] = ansiEscape(command, i + 1)
          i = last
          if (!ansiNul) { const nul = text.indexOf('\0'); const kept = nul < 0 ? text : text.slice(0, nul); word += kept; mask += 'q'.repeat(kept.length); if (nul >= 0) ansiNul = true }
        } else if (!ansiNul) { word += char; mask += 'q' }
        continue
      }
      if (char === quote) quote = ''
      else if (quote === '"' && char === '\x60' && command.indexOf('\x60', i + 1) > i) {
        const [end, denied] = substitution(i + 1, true)
        if (denied) return true
        // The substitution is gone from the word, as bash's empty output is (a quoted empty substitution glued to -rf leaves -rf).
        // A # right after it is still inside the word: a placeholder keeps a rescan (sh -c "...")
        // from reading it as the start of a comment.
        if (command[end + 1] === '#') { word += '\u0001'; mask += 'q' }
        i = end
      }
      else if (quote === '"' && char === '\\' && i + 1 < command.length &&
        (command[i + 1] === '"' || command[i + 1] === '\\' || command[i + 1] === '$' ||
          command.charCodeAt(i + 1) === 96 || command[i + 1] === '\n')) {
        const next = command[++i]
        if (next !== '\n') { word += next; mask += 'q' }
      } else { word += char; mask += 'q' }
      continue
    }
    if (char === '\\' && i + 1 < command.length) {
      const next = command[++i]
      if (next !== '\n') { word += next; mask += 'q'; started = true }
    } else if (char === '\x60' && command.indexOf('\x60', i + 1) > i) {
      // Command substitution: scan the body as its own command; the substitution
      // stays inside the enclosing word, so the rm being parsed keeps its state,
      // and the word has started (a # right after it is not a comment).
      const [end, denied] = substitution(i + 1, false)
      if (denied) return true
      i = end; started = true
    } else if (char === '$' && (command[i + 1] === "'" || command[i + 1] === '"')) {
      // ANSI-C ($'...': escapes decoded) and locale ($"...") quoting: the $ is not part of the word.
      quote = command[i + 1] === "'" ? "$'" : '"'; started = true; i++
    } else if (char === '"' || char === "'") {
      quote = char; started = true
    } else if (char === '#' && !started) {
      while (i < command.length && command[i] !== '\n') i++
      if (finishCommand()) return true
    } else if (char === ' ' || char === '\t' || char === '\r' || char === '\n' ||
      ';|&()<>'.includes(char)) {
      if (finishWord()) return true
      // Redirections separate words, but later operands still belong to rm.
      redirect = char === '<' || char === '>'
      if (!redirectionAmpersand && (char === '\n' || ';|&()'.includes(char)) && finishCommand()) return true
    } else {
      word += char; mask += 'u'; started = true
    }
  }
  return finishWord() || finishCommand()
}

// A fork bomb's definition as bash reads it, whatever the spacing or the name: f(){ f|f& }, function f { f|f& },
// function f(){ f|f& }. Defining one is the danger: the call may come anywhere later.
function hasForkBomb(command: string): boolean {
  const s = command.replace(/\s+/g, '')
  for (let brace = s.indexOf('{'); brace >= 0; brace = s.indexOf('{', brace + 1)) {
    const end = s.startsWith('()', brace - 2) ? brace - 2 : brace
    let start = end
    while (start > 0 && end - start < 72 && /[a-z0-9_:.-]/.test(s[start - 1])) start--
    const run = s.slice(start, end)
    for (const name of run.startsWith('function') && run.length > 8 ? [run, run.slice(8)] : [run]) {
      if (name && s.startsWith(name + '|' + name + '&}', brace + 1)) return true
    }
  }
  return false
}

/**
 * A deny for a Bash call whose command is on the list, else undefined.
 *
 * @param tool the tool name as the model calls it
 * @param input the tool's arguments, unvalidated
 */
export function dangerousCommandVerdict(tool: string, input: unknown): Verdict | undefined {
  if (tool !== 'Bash') return undefined
  const raw = input !== null && typeof input === 'object' ? (input as { command?: unknown }).command : undefined
  // Same belt-and-braces as #2017: a non-string command is checked as text,
  // never skipped.
  const command = String(raw ?? '').toLowerCase()
  const hit = DANGEROUS_COMMANDS.find(d => d === 'rm -rf /' ? hasRootDelete(command) : d === ':(){:|:&};:' ? hasForkBomb(command) : command.includes(d))
  return hit === undefined
    ? undefined
    : { decision: 'deny', reason: `ruflo: dangerous command blocked (${hit})` }
}