@nanhara/hara 0.0.2 → 0.48.0

package/package.json

@@ -1,17 +1,18 @@
 {
   "name": "@nanhara/hara",
-  "version": "0.0.2",
-  "description": "hara — a coding agent CLI that runs like an engineering org. Placeholder; under active development.",
+  "version": "0.48.0",
+  "description": "hara — a coding agent CLI that runs like an engineering org.",
   "bin": {
-    "hara": "bin/hara.mjs"
+    "hara": "dist/index.js"
   },
   "type": "module",
   "files": [
-    "bin",
+    "dist",
     "README.md",
-    "LICENSE-MIT",
-    "LICENSE-APACHE",
-    "CLA.md"
+    "CHANGELOG.md",
+    "LICENSE",
+    "CLA.md",
+    "plugins"
   ],
   "keywords": [
     "ai",
@@ -20,9 +21,11 @@
     "coding-agent",
     "llm",
     "agent-orchestration",
-    "multi-agent"
+    "multi-agent",
+    "anthropic",
+    "claude"
   ],
-  "license": "MIT OR Apache-2.0",
+  "license": "Apache-2.0",
   "author": "Nanhara",
   "homepage": "https://hara.run",
   "repository": {
@@ -32,7 +35,29 @@
   "engines": {
     "node": ">=20"
   },
+  "scripts": {
+    "build": "tsc",
+    "prepare": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "test": "tsc && node --test test/*.test.mjs"
+  },
   "publishConfig": {
     "access": "public"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.104.2",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "commander": "^15.0.0",
+    "ink": "^6.8.0",
+    "openai": "^6.44.0",
+    "react": "^19.2.7"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.3",
+    "@types/react": "^19.2.17",
+    "ink-testing-library": "^4.0.0",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3"
   }
 }

package/plugins/browser/.hara-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "browser",
+  "version": "0.1.0",
+  "description": "Reliable web automation for hara via the Playwright MCP — acts on the DOM/accessibility tree (selectors, auto-wait), not pixels. navigate / click / type / fill / snapshot.",
+  "skills": ["skills"],
+  "mcpServers": {
+    "browser": { "command": "npx", "args": ["-y", "@playwright/mcp@latest"] }
+  }
+}

package/plugins/browser/skills/web/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: web-automation
+description: Operate web pages reliably — navigate, click, fill forms, log in, extract — via the Playwright MCP. Acts on the DOM/accessibility tree by selector/role (deterministic, auto-waiting), NOT screenshots or pixel coordinates. Far more reliable than desktop screen control.
+when_to_use: when the user wants to do anything on a website — open a page, click, fill/submit a form, log in, scrape data, automate a web flow.
+---
+
+# Web automation (Playwright MCP)
+
+Reliable browser tools are available as `mcp__browser__*` (navigate, snapshot, click, type, fill_form,
+select_option, evaluate, …). They act on the page's **accessibility tree by element ref/role/text** — not
+screenshots or pixel coordinates — so they're deterministic and auto-wait for elements. This is the reliable
+counterpart to the fragile desktop `computer` tool: prefer it for anything on the web.
+
+## Workflow
+1. `browser_navigate` to the URL.
+2. `browser_snapshot` — read the accessibility tree (elements + their `ref`s). This is your "eyes": use the
+   refs to act precisely. Prefer it over a screenshot.
+3. Act by ref/role/text: `browser_click`, `browser_type`, `browser_fill_form`, `browser_select_option`.
+4. `browser_snapshot` again to verify before the next step.
+
+## Notes
+- First run downloads a browser once: `npx playwright install chromium`.
+- The Playwright MCP uses its **own** browser (no logins). For tasks needing your **real logged-in Chrome**, use
+  `chrome-devtools-mcp` instead (drives your actual Chrome via CDP) — swap the mcpServers command to
+  `npx chrome-devtools-mcp@latest`. (This is what openclaw/cc-haha use.)
+- **Confirm before irreversible actions** — purchases, posting, sending messages, deleting. Verify the page/state
+  with a snapshot first.

package/plugins/chrome/.hara-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "chrome",
+  "version": "0.1.0",
+  "description": "Drive a real, persistent-login Chrome from hara via chrome-devtools-mcp (CDP) — for web tasks on sites you're already signed into (logins persist across runs). Alternative to the `browser` plugin's isolated Playwright browser — enable one, not both.",
+  "skills": ["skills"],
+  "mcpServers": {
+    "chrome": { "command": "npx", "args": ["-y", "chrome-devtools-mcp@latest"] }
+  }
+}

package/plugins/chrome/skills/chrome/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: chrome-control
+description: Operate a REAL Chrome (with your persistent logins) for web tasks on signed-in sites — via chrome-devtools-mcp (Chrome DevTools Protocol). Use instead of the isolated Playwright `browser` plugin when the task needs your existing accounts/sessions.
+when_to_use: when a web task must run on a site you're logged into (your dashboards, accounts, web apps) rather than a fresh anonymous browser.
+---
+
+# Chrome (real, logged-in) via chrome-devtools-mcp
+
+Tools appear as `mcp__chrome__*` (navigate, click, fill, snapshot, network, performance…). Same
+DOM/accessibility-tree reliability as the `browser` plugin, but it drives a **real Chrome with a persistent
+profile** — log into a site once and the session is remembered across runs.
+
+## Modes
+- **Persistent profile (default):** `npx chrome-devtools-mcp@latest` launches Chrome with a saved profile at
+  `~/.cache/chrome-devtools-mcp/chrome-profile`. Log in once; it persists. Good default.
+- **Attach to YOUR running Chrome:** launch Chrome with `--remote-debugging-port=9222`, then set the MCP command
+  to `npx chrome-devtools-mcp@latest --browserUrl http://127.0.0.1:9222` — hara then drives your actual browser
+  and all its logins.
+
+## Enable (alternative to `browser`, not both)
+Running two browser MCPs at once is confusing. To switch from the default Playwright `browser`:
+`hara plugin add file:<repo>/plugins/chrome && hara plugin disable browser`.
+
+## Caution
+This controls a **real** browser session. Confirm before destructive/irreversible actions (purchases, posting,
+sending, deleting); take a snapshot to verify the page/state first.

package/LICENSE-MIT

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Nanhara
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/bin/hara.mjs

@@ -1,25 +0,0 @@
-#!/usr/bin/env node
-// hara — placeholder CLI. Real agent coming soon.
-import { readFileSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import { dirname, join } from "node:path";
-
-const __dir = dirname(fileURLToPath(import.meta.url));
-let version = "0.0.1";
-try {
-  version = JSON.parse(readFileSync(join(__dir, "..", "package.json"), "utf8")).version;
-} catch {}
-
-const args = process.argv.slice(2);
-if (args[0] === "-v" || args[0] === "--version") {
-  console.log(version);
-  process.exit(0);
-}
-
-console.log(`hara v${version}
-A coding agent CLI that runs like an engineering org.
-
-This is an early placeholder — the real thing is under active development.
-Track it:  https://github.com/hara-cli/hara
-Site:      https://hara.run
-`);