@normahq/acp-repl 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alexey Samoylov
+
+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/README.md

@@ -0,0 +1,61 @@
+# acp-repl
+
+`acp-repl` runs an interactive REPL against any stdio ACP server command.
+
+## Installation
+
+Global install (distributed via npm):
+
+```bash
+npm install -g @normahq/acp-repl@latest
+```
+
+One-off run with npx (no global install):
+
+```bash
+npx @normahq/acp-repl@latest -- <acp-server-cmd> [args...]
+```
+
+## Run
+
+```bash
+acp-repl -- <acp-server-cmd> [args...]
+```
+
+Examples:
+
+```bash
+acp-repl -- opencode acp
+acp-repl --model opencode/big-pickle --mode plan -- opencode acp
+acp-repl --debug -- opencode acp
+```
+
+## Flags
+
+- `--model <id>`: call ACP `session/set_model` after session creation (unsupported servers are ignored).
+- `--mode <id>`: call ACP `session/set_mode` after session creation (unsupported servers are ignored).
+- `--debug`: enable debug logs.
+
+## Interaction
+
+- Type prompts and press Enter to run a turn.
+- Type `exit` or `quit` to close the REPL.
+- If ACP permission requests arrive, choose from the numbered options.
+
+## Notes
+
+- `--` is required. Arguments before `--` are rejected.
+- Default logging is quiet for REPL lifecycle messages; use `--debug` to see them.
+
+## Repository
+
+- Norma GitHub: <https://github.com/normahq/norma>
+
+## Contact
+
+- Issues: <https://github.com/normahq/norma/issues>
+- Maintainer: [@metalagman](https://github.com/metalagman)
+
+## License
+
+MIT. See the repository [LICENSE](https://github.com/normahq/norma/blob/main/LICENSE).

package/acp-repl.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+const path = require('path');
+const os = require('os');
+
+const platform = os.platform();
+const arch = os.arch();
+
+const platformMap = {
+	'darwin': { x64: 'darwin-x64', arm64: 'darwin-arm64' },
+	'linux': { x64: 'linux-x64', arm64: 'linux-arm64' },
+	'win32': { x64: 'win32-x64' }
+};
+
+const archMap = { x64: 'x64', arm64: 'arm64', ia32: 'x86' };
+const cpu = archMap[arch] || arch;
+
+const osKey = platform === 'win32' ? 'win32' : platform;
+const platformKey = platformMap[osKey]?.[cpu];
+
+if (!platformKey) {
+	console.error('Unsupported platform: ' + platform + '/' + cpu);
+	console.error('Expected package: acp-repl-<os>-<cpu>');
+	process.exit(1);
+}
+
+const platformPkgName = '@normahq/acp-repl-' + platformKey;
+const binaryName = platform === 'win32' ? 'acp-repl.exe' : 'acp-repl';
+
+try {
+	const { execFileSync } = require('child_process');
+	const platformPkgJSON = require.resolve(platformPkgName + '/package.json', { paths: [__dirname] });
+	const platformPkgDir = path.dirname(platformPkgJSON);
+	const binaryPath = path.join(platformPkgDir, 'bin', binaryName);
+	process.exit(execFileSync(binaryPath, process.argv.slice(2), { stdio: 'inherit' }));
+} catch (e) {
+	if (e.code === 'ENOENT') {
+		console.error('Binary not found in package: ' + platformPkgName);
+		console.error('Expected platform package: ' + '@normahq/acp-repl-' + platformKey);
+		console.error('This may be an unsupported platform or installation issue.');
+		process.exit(1);
+	}
+	if (e.code === 'MODULE_NOT_FOUND') {
+		console.error('Platform package not installed: ' + platformPkgName);
+		console.error('Expected platform package: ' + '@normahq/acp-repl-' + platformKey);
+		console.error('Try reinstalling the package, and ensure optional dependencies are enabled.');
+		process.exit(1);
+	}
+	process.exit(e.status || 1);
+}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "bin": {
+    "acp-repl": "acp-repl.js"
+  },
+  "description": "Meta package for acp-repl",
+  "engines": {
+    "node": "\u003e=16"
+  },
+  "files": [
+    "acp-repl.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "name": "@normahq/acp-repl",
+  "optionalDependencies": {
+    "@normahq/acp-repl-darwin-arm64": "0.0.2",
+    "@normahq/acp-repl-darwin-x64": "0.0.2",
+    "@normahq/acp-repl-linux-arm64": "0.0.2",
+    "@normahq/acp-repl-linux-x64": "0.0.2",
+    "@normahq/acp-repl-win32-x64": "0.0.2"
+  },
+  "version": "0.0.2"
+}