nyte-ai 0.0.16-dev.4 → 0.0.18

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nyte 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/bin/nyte.js

@@ -3,7 +3,7 @@
 import { launch } from "../src/launcher.js";
 
 try {
-  process.exitCode = await launch();
+  process.exitCode = await launch(process.argv.slice(2));
 } catch (error) {
   process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
   process.exitCode = 1;

package/docs/README.md

@@ -4,7 +4,6 @@ This guide and its source examples ship with the Nyte release you installed.
 The npm package records its version in `package.json`; a native archive records
 it in `VERSION` beside the executable.
 
-- [Run a conversation or one prompt](usage.md)
 - [Source examples](examples/README.md)
 
 For npm installs, this guide is inside `nyte-ai/docs`. For native installs it is

package/docs/examples/README.md

@@ -1,7 +1,6 @@
 # Source examples
 
-Run these from the workspace you want Nyte to inspect, after login and workspace
-trust setup. Put `nyte` on `PATH`. Each script starts one prompt run and
+Run these from the workspace you want Nyte to inspect, after login. Put `nyte` on `PATH`. Each script starts one prompt run and
 returns Nyte's exit status. Neither script changes your shell settings.
 
 - [ask.sh](ask.sh) passes prompt arguments without shell evaluation.
@@ -15,4 +14,4 @@ sh /path/to/docs/examples/prompt-file.sh ./prompt.txt
 ```
 
 These are ordinary shell source files you can copy and adapt. See the
-[usage guide](../usage.md) for setup and the [front door](../README.md) for locations.
+[front door](../README.md) for locations.

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "nyte-ai",
-  "version": "0.0.16-dev.4",
+  "version": "0.0.18",
   "private": false,
-  "description": "Headless agent runner and terminal client for Nyte",
+  "description": "Installs the nyte command: downloads, verifies and runs the native Nyte terminal client",
   "keywords": [
     "agent",
     "ai",
@@ -27,17 +27,18 @@
   ],
   "type": "module",
   "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "clean": "rm -rf node_modules .turbo dist",
-    "package": "pnpm pack --pack-destination dist",
-    "test": "vitest --run"
+    "access": "public",
+    "provenance": true
   },
   "devDependencies": {
-    "vitest": "^5.0.2"
+    "vitest": "^5.0.5"
   },
   "engines": {
     "node": ">=26"
+  },
+  "scripts": {
+    "clean": "rm -rf node_modules .turbo dist",
+    "package": "pnpm pack --pack-destination dist",
+    "test": "vitest --run"
   }
-}
+}

package/src/launcher.js

@@ -1,27 +1,37 @@
 import { spawn } from "node:child_process";
 import { createHash } from "node:crypto";
-import { chmod, mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
+import {
+  chmod,
+  mkdir,
+  readFile,
+  readlink,
+  rename,
+  rm,
+  stat,
+  symlink,
+  writeFile,
+} from "node:fs/promises";
 import { homedir } from "node:os";
-import { dirname, join } from "node:path";
+import { dirname, join, relative } from "node:path";
 import process from "node:process";
 
 import packageJson from "../package.json" with { type: "json" };
 
-export const REPOSITORY = "interfaces-lab/nyte";
+const REPOSITORY = "interfaces-lab/nyte";
+
+const RELEASE_TARGETS = ["darwin-arm64", "linux-arm64", "linux-x64"];
 
 export function platformTarget(platform = process.platform, arch = process.arch) {
-  if ((platform !== "darwin" && platform !== "linux") || (arch !== "arm64" && arch !== "x64")) {
-    return undefined;
-  }
+  const target = `${platform}-${arch}`;
 
-  return `${platform}-${arch}`;
+  return RELEASE_TARGETS.includes(target) ? target : undefined;
 }
 
 export function releaseAssetName(version, target) {
   return `nyte-v${version.replace(/^v/u, "")}-${target}`;
 }
 
-export function cacheRoot(env = process.env) {
+function cacheRoot(env = process.env) {
   return env["NYTE_BIN_DIR"] ?? join(homedir(), ".nyte", "bin");
 }
 
@@ -56,7 +66,11 @@ export async function ensureBinary(options = {}) {
   const root = options.root ?? cacheRoot(options.env);
   const binary = join(root, version, "nyte");
 
-  if ((await stat(binary).catch(() => undefined))?.isFile()) return binary;
+  if ((await stat(binary).catch(() => undefined))?.isFile()) {
+    await linkCurrent(root, binary);
+
+    return binary;
+  }
 
   const fetchFn = options.fetchFn ?? globalThis.fetch;
   const asset = releaseAssetName(version, target);
@@ -97,14 +111,27 @@ export async function ensureBinary(options = {}) {
     }
 
     await chmod(binary, 0o755);
-
-    return binary;
   } catch (error) {
     await rm(binary, { force: true });
     throw error;
   } finally {
     await rm(archive, { force: true });
   }
+
+  await linkCurrent(root, binary);
+
+  return binary;
+}
+
+async function linkCurrent(root, binary) {
+  const link = join(root, "nyte");
+  const target = relative(root, binary);
+
+  if ((await readlink(link).catch(() => undefined)) === target) return;
+  const temporary = `${link}.${process.pid}.tmp`;
+  await rm(temporary, { force: true });
+  await symlink(target, temporary);
+  await rename(temporary, link);
 }
 
 export async function launch(args = process.argv.slice(2), options = {}) {

package/docs/usage.md

@@ -1,46 +0,0 @@
-# Run Nyte
-
-Log in once, then start a conversation from your project directory:
-
-```sh
-nyte login
-nyte
-```
-
-`nyte login` lists the providers you can sign in to. `nyte login github-copilot` signs in with a
-GitHub device code: open the URL it prints, enter the code, and Nyte loads the models your Copilot
-account can use. This uses the GitHub Copilot OAuth app used by Pi, not a Nyte or OpenCode app.
-Nyte exchanges the GitHub token for a short-lived Copilot session token and refreshes it as needed.
-Existing direct-token Copilot logins need a fresh sign-in after upgrading. Nyte is not an officially
-supported Copilot client; the account needs Copilot access.
-
-Nyte asks whether you trust the directory. A trusted workspace lets tools read,
-edit, and run commands with your process's access. There are no per-tool prompts.
-Use an isolated environment when the workspace needs stronger boundaries.
-
-To send one prompt and exit:
-
-```sh
-nyte --print -- "Summarize this project's README"
-```
-
-Use `--provider <provider>` and `--model <model>` before `--` to select a model.
-These requests use your configured provider and may incur charges. Run `nyte login`
-interactively before using scripts. A script must also run in a trusted workspace.
-
-Use `nyte --resume` in a terminal to continue the latest conversation.
-Installed copies can update with `nyte update`. Run `nyte update --models` to refresh the model catalog without updating Nyte. The update command installs the new
-release's docs beside the executable when the release archive carries them.
-
-## Delegated tasks
-
-The agent waits for a delegated task by default. It can start independent work in the
-background, then use `wait_task` with that job's ID when it needs the report. The parent
-continues after the existing task finishes; it does not launch a replacement or poll.
-`stop_task` cancels the task. These are agent tools, not terminal commands.
-
-A background report cannot restart a finished or stopped conversation. If the parent
-already finished, the report stays queued for your next message.
-
-The [source examples](examples/README.md) demonstrate quoted arguments and stdin.
-Return to the [guide](README.md).