@beifengfeng66/hapi 0.3.4

package/LICENSE

@@ -0,0 +1,157 @@
+# GNU LESSER GENERAL PUBLIC LICENSE
+
+Version 3, 29 June 2007
+
+Copyright (C) 2007 Free Software Foundation, Inc.
+<https://fsf.org/>
+
+Everyone is permitted to copy and distribute verbatim copies of this
+license document, but changing it is not allowed.
+
+This version of the GNU Lesser General Public License incorporates the
+terms and conditions of version 3 of the GNU General Public License,
+supplemented by the additional permissions listed below.
+
+## 0. Additional Definitions.
+
+As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the
+GNU General Public License.
+
+"The Library" refers to a covered work governed by this License, other
+than an Application or a Combined Work as defined below.
+
+An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+A "Combined Work" is a work produced by combining or linking an
+Application with the Library. The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+## 1. Exception to Section 3 of the GNU GPL.
+
+You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+## 2. Conveying Modified Versions.
+
+If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+-   a) under this License, provided that you make a good faith effort
+    to ensure that, in the event an Application does not supply the
+    function or data, the facility still operates, and performs
+    whatever part of its purpose remains meaningful, or
+-   b) under the GNU GPL, with none of the additional permissions of
+    this License applicable to that copy.
+
+## 3. Object Code Incorporating Material from Library Header Files.
+
+The object code form of an Application may incorporate material from a
+header file that is part of the Library. You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+-   a) Give prominent notice with each copy of the object code that
+    the Library is used in it and that the Library and its use are
+    covered by this License.
+-   b) Accompany the object code with a copy of the GNU GPL and this
+    license document.
+
+## 4. Combined Works.
+
+You may convey a Combined Work under terms of your choice that, taken
+together, effectively do not restrict modification of the portions of
+the Library contained in the Combined Work and reverse engineering for
+debugging such modifications, if you also do each of the following:
+
+-   a) Give prominent notice with each copy of the Combined Work that
+    the Library is used in it and that the Library and its use are
+    covered by this License.
+-   b) Accompany the Combined Work with a copy of the GNU GPL and this
+    license document.
+-   c) For a Combined Work that displays copyright notices during
+    execution, include the copyright notice for the Library among
+    these notices, as well as a reference directing the user to the
+    copies of the GNU GPL and this license document.
+-   d) Do one of the following:
+    -   0) Convey the Minimal Corresponding Source under the terms of
+        this License, and the Corresponding Application Code in a form
+        suitable for, and under terms that permit, the user to
+        recombine or relink the Application with a modified version of
+        the Linked Version to produce a modified Combined Work, in the
+        manner specified by section 6 of the GNU GPL for conveying
+        Corresponding Source.
+    -   1) Use a suitable shared library mechanism for linking with
+        the Library. A suitable mechanism is one that (a) uses at run
+        time a copy of the Library already present on the user's
+        computer system, and (b) will operate properly with a modified
+        version of the Library that is interface-compatible with the
+        Linked Version.
+-   e) Provide Installation Information, but only if you would
+    otherwise be required to provide such information under section 6
+    of the GNU GPL, and only to the extent that such information is
+    necessary to install and execute a modified version of the
+    Combined Work produced by recombining or relinking the Application
+    with a modified version of the Linked Version. (If you use option
+    4d0, the Installation Information must accompany the Minimal
+    Corresponding Source and Corresponding Application Code. If you
+    use option 4d1, you must provide the Installation Information in
+    the manner specified by section 6 of the GNU GPL for conveying
+    Corresponding Source.)
+
+## 5. Combined Libraries.
+
+You may place library facilities that are a work based on the Library
+side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+-   a) Accompany the combined library with a copy of the same work
+    based on the Library, uncombined with any other library
+    facilities, conveyed under the terms of this License.
+-   b) Give prominent notice with the combined library that part of it
+    is a work based on the Library, and explaining where to find the
+    accompanying uncombined form of the same work.
+
+## 6. Revised Versions of the GNU Lesser General Public License.
+
+The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Library
+as you received it specifies that a certain numbered version of the
+GNU Lesser General Public License "or any later version" applies to
+it, you have the option of following the terms and conditions either
+of that published version or of any later version published by the
+Free Software Foundation. If the Library as you received it does not
+specify a version number of the GNU Lesser General Public License, you
+may choose any version of the GNU Lesser General Public License ever
+published by the Free Software Foundation.
+
+If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

package/NOTICE

@@ -0,0 +1,52 @@
+hapi CLI
+Copyright (c) 2024-2025 weishu
+
+This software contains code derived from happy-cli
+(https://github.com/slopus/happy-cli), which is licensed
+under the MIT License:
+
+---
+
+MIT License
+
+Copyright (c) 2024 Kirill Dubovitskiy
+
+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.
+
+---
+
+The following files/directories are derived from happy-cli:
+- src/api/
+- src/claude/
+- src/codex/
+- src/daemon/
+- src/commands/
+- src/ui/
+- src/utils/
+- src/modules/ripgrep/
+- src/modules/difftastic/
+- src/modules/watcher/
+- src/modules/common/registerCommonHandlers.ts
+- src/modules/common/pathSecurity.ts
+- src/parsers/
+- src/configuration.ts
+- src/persistence.ts
+- src/projectPath.ts
+- src/lib.ts
+- src/index.ts

package/README.md

@@ -0,0 +1,127 @@
+# hapi CLI
+
+Run Claude Code, Codex, or Gemini sessions from your terminal and control them remotely through the hapi server.
+
+## What it does
+
+- Starts Claude Code sessions and registers them with hapi-server.
+- Starts Codex mode for OpenAI-based sessions.
+- Starts Gemini mode via ACP (Anthropic Code Plugins).
+- Provides an MCP stdio bridge for external tools.
+- Manages a background daemon for long-running sessions.
+- Includes diagnostics and auth helpers.
+
+## Typical flow
+
+1. Start the server and set env vars (see ../server/README.md).
+2. Set the same CLI_API_TOKEN on this machine or run `hapi auth login`.
+3. Run `hapi` to start a session.
+4. Use the web app or Telegram Mini App to monitor and control.
+
+## Commands
+
+### Session commands
+
+- `hapi` - Start a Claude Code session (passes through Claude CLI flags). See `src/index.ts`.
+- `hapi codex` - Start Codex mode. See `src/codex/runCodex.ts`.
+- `hapi gemini` - Start Gemini mode via ACP. See `src/agent/runners/runAgentSession.ts`.
+  Note: Gemini runs in remote mode only; it waits for messages from the server UI/Telegram.
+
+### Authentication
+
+- `hapi auth status` - Show authentication configuration and token source.
+- `hapi auth login` - Interactively enter and save CLI_API_TOKEN.
+- `hapi auth logout` - Clear saved credentials.
+
+See `src/commands/auth.ts`.
+
+### Daemon management
+
+- `hapi daemon start` - Start daemon as detached process.
+- `hapi daemon stop` - Stop daemon gracefully.
+- `hapi daemon status` - Show daemon diagnostics.
+- `hapi daemon list` - List active sessions managed by daemon.
+- `hapi daemon stop-session <sessionId>` - Terminate specific session.
+- `hapi daemon logs` - Print path to latest daemon log file.
+- `hapi daemon install` - Install daemon as system service.
+- `hapi daemon uninstall` - Remove daemon system service.
+
+See `src/daemon/run.ts`.
+
+### Diagnostics
+
+- `hapi doctor` - Show full diagnostics (version, daemon status, logs, processes).
+- `hapi doctor clean` - Kill runaway HAPI processes.
+
+See `src/ui/doctor.ts`.
+
+### Other
+
+- `hapi mcp` - Start MCP stdio bridge. See `src/codex/happyMcpStdioBridge.ts`.
+- `hapi server` - Start the bundled server (single binary workflow).
+
+## Configuration
+
+See `src/configuration.ts` for all options.
+
+### Required
+
+- `CLI_API_TOKEN` - Shared secret; must match the server. Can be set via env or `~/.hapi/settings.json` (env wins).
+- `HAPI_SERVER_URL` - Server base URL (default: http://localhost:3006).
+
+### Optional
+
+- `HAPI_HOME` - Config/data directory (default: ~/.hapi).
+- `HAPI_EXPERIMENTAL` - Enable experimental features (true/1/yes).
+- `HAPI_CLAUDE_PATH` - Path to a specific `claude` executable.
+- `HAPI_HTTP_MCP_URL` - Default MCP target for `hapi mcp`.
+
+### Daemon
+
+- `HAPI_DAEMON_HEARTBEAT_INTERVAL` - Heartbeat interval in ms (default: 60000).
+- `HAPI_DAEMON_HTTP_TIMEOUT` - HTTP timeout for daemon control in ms (default: 10000).
+
+## Storage
+
+Data is stored in `~/.hapi/` (or `$HAPI_HOME`):
+
+- `settings.json` - User settings (machineId, token, onboarding flag). See `src/persistence.ts`.
+- `daemon.state.json` - Daemon state (pid, port, version, heartbeat).
+- `logs/` - Log files.
+
+## Requirements
+
+- Claude CLI installed and logged in (`claude` on PATH).
+- Bun for building from source.
+
+## Build from source
+
+From the repo root:
+
+```bash
+bun install
+bun run build:cli
+bun run build:cli:exe
+```
+
+For an all-in-one binary that also embeds the web app:
+
+```bash
+bun run build:single-exe
+```
+
+## Source structure
+
+- `src/api/` - Bot communication (Socket.IO + REST).
+- `src/claude/` - Claude Code integration.
+- `src/codex/` - Codex mode integration.
+- `src/agent/` - Multi-agent support (Gemini via ACP).
+- `src/daemon/` - Background service.
+- `src/commands/` - CLI command handlers.
+- `src/ui/` - User interface and diagnostics.
+- `src/modules/` - Tool implementations (ripgrep, difftastic, git).
+
+## Related docs
+
+- `../server/README.md`
+- `../web/README.md`

package/bin/hapi.cjs

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+
+const { execFileSync } = require('child_process');
+const path = require('path');
+
+const platform = process.platform;
+const arch = process.arch;
+
+function getSelfPackageName() {
+    const pkg = require(path.join(__dirname, '..', 'package.json'));
+    return pkg.name;
+}
+
+function splitScopeAndBase(name) {
+    if (typeof name !== 'string') return { scope: null, base: 'hapi' };
+    if (name.startsWith('@')) {
+        const [scope, base] = name.split('/');
+        return { scope, base: base || 'hapi' };
+    }
+    return { scope: null, base: name };
+}
+
+function getPlatformPackageName() {
+    const selfName = getSelfPackageName(); // e.g. "@beifengfeng66/hapi" or "hapi"
+    const { scope, base } = splitScopeAndBase(selfName);
+    const platformSuffix = `${base}-${platform}-${arch}`; // e.g. "hapi-darwin-arm64"
+    return scope ? `${scope}/${platformSuffix}` : platformSuffix;
+}
+
+const pkgName = getPlatformPackageName();
+
+function getBinaryPath() {
+    try {
+        // Try to find the platform-specific package
+        const pkgPath = require.resolve(`${pkgName}/package.json`);
+        const binName = platform === 'win32' ? 'hapi.exe' : 'hapi';
+        return path.join(path.dirname(pkgPath), 'bin', binName);
+    } catch (e) {
+        return null;
+    }
+}
+
+const binPath = getBinaryPath();
+
+if (!binPath) {
+    console.error(`Unsupported platform: ${platform}-${arch}`);
+    console.error('');
+    console.error('Supported platforms:');
+    console.error('  - darwin-arm64 (macOS Apple Silicon)');
+    console.error('  - darwin-x64 (macOS Intel)');
+    console.error('  - linux-arm64');
+    console.error('  - linux-x64');
+    console.error('  - win32-x64');
+    console.error('');
+    console.error('You can download the binary manually from:');
+    console.error('  https://github.com/deijing/hapi/releases');
+    process.exit(1);
+}
+
+try {
+    execFileSync(binPath, process.argv.slice(2), { stdio: 'inherit' });
+} catch (e) {
+    // If the binary execution fails, exit with the same code
+    if (e.status !== undefined) {
+        process.exit(e.status);
+    }
+    // For other errors (e.g., binary not found), print and exit
+    console.error(`Failed to execute ${binPath}:`, e.message);
+    process.exit(1);
+}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@beifengfeng66/hapi",
+  "version": "0.3.4",
+  "description": "App for agentic coding - access coding agent anywhere",
+  "author": "Kirill Dubovitskiy & weishu",
+  "license": "LGPL-3.0-or-later",
+  "type": "module",
+  "homepage": "https://github.com/deijing/hapi",
+  "bugs": "https://github.com/deijing/hapi/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/deijing/hapi",
+    "directory": "cli"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "hapi": "bin/hapi.cjs"
+  },
+  "files": [
+    "bin/hapi.cjs",
+    "NOTICE"
+  ],
+  "imports": {
+    "#embedded-assets": {
+      "bun": "./src/runtime/embeddedAssets.bun.ts",
+      "default": "./src/runtime/embeddedAssets.stub.ts"
+    }
+  },
+  "optionalDependencies": {
+    "@beifengfeng66/hapi-darwin-arm64": "0.3.4",
+    "@beifengfeng66/hapi-darwin-x64": "0.3.4",
+    "@beifengfeng66/hapi-linux-arm64": "0.3.4",
+    "@beifengfeng66/hapi-linux-x64": "0.3.4",
+    "@beifengfeng66/hapi-win32-x64": "0.3.4"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build:exe": "bun run scripts/build-executable.ts",
+    "build:exe:all": "bun run scripts/build-executable.ts --all",
+    "build:exe:allinone": "bun run scripts/build-executable.ts --with-web-assets",
+    "build:exe:allinone:all": "bun run scripts/build-executable.ts --with-web-assets --all",
+    "prepare-npm-packages": "bun run scripts/prepare-npm-packages.ts",
+    "prepack": "bun run prepare-npm-packages",
+    "tools:unpack": "bun run scripts/unpack-tools.ts",
+    "update-homebrew-formula": "bun run scripts/update-homebrew-formula.ts",
+    "test": "bun run tools:unpack && vitest run",
+    "test:win": "vitest run",
+    "dev": "bun src/index.ts",
+    "dev:local-server": "bun --env-file .env.dev-local-server src/index.ts",
+    "dev:integration-test-env": "bun --env-file .env.integration-test src/index.ts",
+    "release-all": "bun run scripts/release-all.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "@types/cross-spawn": "^6.0.6",
+    "@types/ps-list": "^6.2.1",
+    "@types/react": "^19.2.7",
+    "axios": "^1.13.2",
+    "chalk": "^5.6.2",
+    "cross-spawn": "^7.0.6",
+    "fastify": "^5.6.2",
+    "fastify-type-provider-zod": "6.1.0",
+    "ink": "^6.6.0",
+    "ps-list": "^9.0.0",
+    "react": "^19.2.3",
+    "socket.io-client": "^4.8.3",
+    "tar": "^7.5.2",
+    "zod": "^4.2.1"
+  },
+  "devDependencies": {
+    "@types/node": ">=25",
+    "bun-types": "^1.3.5",
+    "dotenv": "^17.2.3",
+    "typescript": "^5",
+    "vitest": "^4.0.16"
+  },
+  "resolutions": {
+    "whatwg-url": "14.2.0",
+    "parse-path": "7.0.3",
+    "@types/parse-path": "7.0.3"
+  },
+  "packageManager": "bun@1.3.5"
+}