@clawlabz/clawarena-cli 0.3.0

package/lib/action-parser.mjs

@@ -0,0 +1,63 @@
+// Parse action JSON from agent/LLM responses
+// Handles: raw JSON, markdown code blocks, embedded JSON objects
+
+/**
+ * Parse an action from text input (e.g. from stdin or LLM output).
+ * Tries multiple extraction strategies for robustness.
+ *
+ * @param {string} text - Raw text that should contain an action JSON
+ * @param {Array<{action: string}>} availableActions - Valid actions for validation
+ * @returns {object|null} Parsed action object, or null if unparseable
+ */
+export function parseAction(text, availableActions) {
+  if (!text || typeof text !== 'string') return null
+
+  const trimmed = text.trim()
+  if (!trimmed) return null
+
+  // Strategy 1: Direct JSON.parse
+  const direct = tryParse(trimmed)
+  if (direct && isValidAction(direct, availableActions)) return direct
+
+  // Strategy 2: Extract from markdown ```json ... ``` blocks
+  const codeBlockMatch = trimmed.match(/```(?:json)?\s*\n?([\s\S]*?)```/)
+  if (codeBlockMatch) {
+    const parsed = tryParse(codeBlockMatch[1].trim())
+    if (parsed && isValidAction(parsed, availableActions)) return parsed
+  }
+
+  // Strategy 3: Find first { ... } in the text
+  const braceMatch = trimmed.match(/\{[^{}]*\}/)
+  if (braceMatch) {
+    const parsed = tryParse(braceMatch[0])
+    if (parsed && isValidAction(parsed, availableActions)) return parsed
+  }
+
+  // Strategy 4: Find nested { ... { ... } ... }
+  const nestedMatch = trimmed.match(/\{[^}]*\{[^}]*\}[^}]*\}/)
+  if (nestedMatch) {
+    const parsed = tryParse(nestedMatch[0])
+    if (parsed && isValidAction(parsed, availableActions)) return parsed
+  }
+
+  return null
+}
+
+function tryParse(text) {
+  try {
+    const parsed = JSON.parse(text)
+    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed) && typeof parsed.action === 'string') {
+      return parsed
+    }
+    return null
+  } catch {
+    return null
+  }
+}
+
+function isValidAction(parsed, availableActions) {
+  if (!Array.isArray(availableActions) || availableActions.length === 0) {
+    return typeof parsed.action === 'string' && parsed.action.length > 0
+  }
+  return availableActions.some(a => a.action === parsed.action)
+}

package/lib/fallback-strategy.mjs

@@ -0,0 +1,59 @@
+// Fallback strategy: pick a random valid action from availableActions
+// Used when no LLM / agent-mode decision is available
+
+/**
+ * Pick a random valid action from the available actions list.
+ * Prefers actions marked as isFallback=true.
+ * For params: default → use it, enum → random value, number → min value,
+ * string with validTargets → random target, string without → '(auto)'.
+ *
+ * @param {Array<{action: string, params?: Record<string, object>, isFallback?: boolean}>} availableActions
+ * @returns {object|null} An action object ready to submit, or null if no actions available
+ */
+export function pickFallbackAction(availableActions) {
+  if (!Array.isArray(availableActions) || availableActions.length === 0) return null
+
+  // Prefer fallback-marked actions
+  const fallbacks = availableActions.filter(a => a.isFallback)
+  const candidates = fallbacks.length > 0 ? fallbacks : availableActions
+
+  const chosen = candidates[Math.floor(Math.random() * candidates.length)]
+  const action = { action: chosen.action }
+
+  if (chosen.params) {
+    for (const [key, constraint] of Object.entries(chosen.params)) {
+      action[key] = resolveParam(constraint)
+    }
+  }
+
+  return action
+}
+
+function resolveParam(constraint) {
+  if (!constraint || typeof constraint !== 'object') return null
+
+  // If a default is explicitly provided, prefer it
+  if (constraint.default !== undefined && constraint.default !== null) {
+    return constraint.default
+  }
+
+  switch (constraint.type) {
+    case 'enum': {
+      const values = Array.isArray(constraint.values) ? constraint.values : []
+      return values.length > 0 ? values[Math.floor(Math.random() * values.length)] : null
+    }
+    case 'number': {
+      const min = typeof constraint.min === 'number' ? constraint.min : 0
+      // Use min value as safest default
+      return min
+    }
+    case 'string': {
+      const targets = Array.isArray(constraint.validTargets) ? constraint.validTargets : []
+      return targets.length > 0 ? targets[Math.floor(Math.random() * targets.length)] : '(auto)'
+    }
+    case 'boolean':
+      return false
+    default:
+      return null
+  }
+}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@clawlabz/clawarena-cli",
+  "version": "0.3.0",
+  "description": "ClawArena CLI for AI agents (Claude Code / Codex CLI / Gemini CLI)",
+  "type": "module",
+  "license": "MIT",
+  "private": false,
+  "bin": {
+    "clawarena-cli": "./bin/arena-runner.mjs",
+    "clawarena": "./bin/arena-runner.mjs"
+  },
+  "files": [
+    "bin",
+    "lib"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "echo 'no build step'",
+    "lint": "node -e \"process.exit(0)\""
+  }
+}