@skaft/octet 0.0.0 → 0.10.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Achuthan Mukundan and Skaft Software contributors
+
+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

@@ -1,3 +1,21 @@
-# @skaft/octet
+# octet npm launcher
 
-This `0.0.0` version only reserves the package name. It contains no Octet executable or runtime and is not an installation channel. Use the [official installation instructions](https://github.com/skaft-software/octet#installation) until a verified npm release is announced.
+`@skaft/octet` is a small Node.js launcher for the native octet runtime. npm
+selects one exact-version platform package through `optionalDependencies`; the
+`octet` and `octet-host` commands start the selected native binary directly.
+
+These scoped names are source packaging identities, not proof of registry rights
+or availability. Use the installation command only after an authorized release
+has published the packages.
+
+The launcher requires Node.js but does not access the network, download an
+archive, or execute an install lifecycle hook. Install it with scripts, audit,
+and funding requests disabled:
+
+```sh
+npm install --global --ignore-scripts --no-audit --no-fund @skaft/octet@0.10.4
+```
+
+GNU/Linux uses the glibc x64 package. macOS uses the arm64 or x64 package that
+matches the running executable. `octet doctor` reports a missing `rg`
+prerequisite.

package/bin/octet

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+'use strict';
+
+const { launch } = require('../lib/launch.js');
+launch('octet');

package/bin/octet-host

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+'use strict';
+
+const { launch } = require('../lib/launch.js');
+launch('octet-host');

package/lib/launch.js

@@ -0,0 +1,83 @@
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+
+const PLATFORMS = Object.freeze({
+  'darwin-arm64': '@skaft/octet-darwin-arm64',
+  'darwin-x64': '@skaft/octet-darwin-x64',
+  'linux-x64': '@skaft/octet-linux-x64-gnu',
+  'win32-x64': '@skaft/octet-win32-x64',
+});
+
+function selectedPackage(platform = process.platform, architecture = process.arch) {
+  if (platform === 'linux' && architecture === 'x64') {
+    const libc = process.report?.getReport?.().header?.glibcVersionRuntime;
+    if (!libc) throw new Error('octet npm package requires GNU libc on Linux; musl is not supported');
+  }
+  const key = `${platform}-${architecture}`;
+  const selected = PLATFORMS[key];
+  if (!selected) throw new Error(`octet npm package does not support this platform: ${key}`);
+  return selected;
+}
+
+function findPlatformRoot(launcherRoot, packageName) {
+  const packageLeaf = packageName.slice(packageName.indexOf('/') + 1);
+  const candidates = [
+    path.join(launcherRoot, 'node_modules', ...packageName.split('/')),
+    path.join(launcherRoot, '..', packageLeaf),
+  ];
+  for (const candidate of candidates) {
+    try {
+      if (fs.lstatSync(candidate).isDirectory() && !fs.lstatSync(candidate).isSymbolicLink()) return candidate;
+    } catch (error) {
+      if (error.code !== 'ENOENT') throw error;
+    }
+  }
+  throw new Error(`octet npm package is missing the selected platform runtime: ${packageName}`);
+}
+
+function launch(commandName, args = process.argv.slice(2)) {
+  if (commandName !== 'octet' && commandName !== 'octet-host') throw new Error('invalid native command');
+  const launcherRoot = path.resolve(__dirname, '..');
+  const packageName = selectedPackage();
+  const platformRoot = findPlatformRoot(launcherRoot, packageName);
+  const executableName = process.platform === 'win32' ? `${commandName}.exe` : commandName;
+  const executable = path.join(platformRoot, 'bin', executableName);
+  const versionPath = path.join(platformRoot, 'share', 'octet', '.octet-version');
+  const required = [
+    ...['package.json', 'README.md', 'LICENSE'].map((name) => path.join(platformRoot, name)), executable,
+    path.join(platformRoot, 'share', 'octet', 'README.md'),
+    path.join(platformRoot, 'share', 'octet', 'docs'),
+    path.join(platformRoot, 'share', 'octet', 'examples'),
+    path.join(platformRoot, 'share', 'octet', 'sdk'),
+  ];
+  for (const file of required) {
+    try {
+      const stat = fs.lstatSync(file);
+      if (stat.isSymbolicLink() || (file === executable ? !stat.isFile() : !stat.isFile() && !stat.isDirectory())) {
+        throw new Error(`octet npm platform package is incomplete: ${platformRoot}`);
+      }
+    } catch (error) {
+      if (error.code === 'ENOENT') throw new Error(`octet npm platform package is incomplete: ${platformRoot}`);
+      throw error;
+    }
+  }
+  if (process.platform !== 'win32' && (fs.statSync(executable).mode & 0o111) === 0) {
+    throw new Error(`octet npm platform executable is not executable: ${executable}`);
+  }
+  const version = fs.readFileSync(path.join(launcherRoot, 'package.json'), 'utf8').match(/"version"\s*:\s*"([^"]+)"/);
+  if (!version || fs.readFileSync(versionPath, 'utf8').trim() !== version[1]) {
+    throw new Error('octet npm platform version does not match launcher version');
+  }
+  const result = spawnSync(executable, args, { cwd: process.cwd(), env: process.env, stdio: 'inherit' });
+  if (result.error) throw result.error;
+  if (result.signal) {
+    process.kill(process.pid, result.signal);
+    return;
+  }
+  process.exitCode = result.status === null ? 1 : result.status;
+}
+
+module.exports = { PLATFORMS, selectedPackage, findPlatformRoot, launch };

package/package.json

@@ -1,18 +1,24 @@
 {
   "name": "@skaft/octet",
-  "version": "0.0.0",
-  "description": "Reserved package name for the Octet npm distribution; no runtime is included.",
+  "version": "0.10.4",
+  "description": "Native octet coding agent launcher",
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/skaft-software/octet.git"
-  },
-  "publishConfig": {
-    "access": "public",
-    "tag": "reserved",
-    "registry": "https://registry.npmjs.org/"
-  },
+  "repository": "https://github.com/skaft-software/octet",
+  "homepage": "https://octet.skaft.org",
   "files": [
-    "README.md"
-  ]
+    "README.md",
+    "LICENSE",
+    "bin/",
+    "lib/"
+  ],
+  "bin": {
+    "octet": "bin/octet",
+    "octet-host": "bin/octet-host"
+  },
+  "optionalDependencies": {
+    "@skaft/octet-darwin-arm64": "0.10.4",
+    "@skaft/octet-darwin-x64": "0.10.4",
+    "@skaft/octet-linux-x64-gnu": "0.10.4",
+    "@skaft/octet-win32-x64": "0.10.4"
+  }
 }