reallink-cli 0.1.15 → 0.1.17

package/README.md

@@ -2,6 +2,12 @@
 
 Rust-based CLI for Reallink authentication, token workflows, and workspace file CRUD.
 
+This package now includes an agent-oriented capability surface:
+
+- `reallink call` for direct authenticated API access
+- `reallink ops list/search/show/invoke` for capability discovery and invocation
+- explicit bearer token override support so agents can run without a saved interactive session
+
 ## Install
 
 ```bash
@@ -11,6 +17,13 @@ npm install -g reallink-cli
 On supported published platforms, npm installs a bundled prebuilt binary so install/update is fast.
 If a prebuilt binary is not available for your OS/arch, npm falls back to a one-time Rust release build during postinstall.
 After install, `reallink` runs the compiled binary directly (no per-command cargo compile step).
+Windows and Linux packaging should be validated through the package smoke test:
+
+```bash
+npm run smoke:install -- --mode prebuilt
+npm run smoke:install -- --mode build
+```
+
 CLI caches update metadata daily. To keep command startup fast, network update checks run during `reallink login` (or explicitly via `reallink self-update --check`) rather than every command.
 
 Output defaults to JSON for agent-friendly automation. You can switch to human text with `--format text`.
@@ -25,6 +38,27 @@ reallink self-update
 reallink whoami
 reallink logout
 
+reallink call GET /projects
+reallink call POST /tools/runs --body @run.json
+reallink call GET /projects --access-token <token> --base-url https://api.real-agent.link
+
+reallink ops list
+reallink ops search connect
+reallink ops show get_v1_projects_projectId_connect_clients
+reallink ops invoke get_v1_projects_projectId_connect_clients --project-id prj_xxx
+reallink ops invoke post_v1_projects_projectId_connect_ticket --project-id prj_xxx
+reallink ops invoke post_v1_tools_runs --org-id org_xxx --project-id prj_xxx --body @run.json
+reallink ops list --access-token <token> --base-url https://api.real-agent.link
+
+reallink call GET /projects/prj_xxx/connect/transports --access-token <token> --base-url https://api.real-agent.link
+reallink call POST /projects/prj_xxx/workspace/read --access-token <token> --base-url https://api.real-agent.link --body '{"path":"README.txt"}'
+reallink call POST /projects/prj_xxx/workspace/write --access-token <token> --base-url https://api.real-agent.link --body '{"path":"Docs/agent-note.txt","content":"hello from agent cli","createParents":true}'
+reallink call POST /projects/prj_xxx/workspace/list --access-token <token> --base-url https://api.real-agent.link --body '{"path":"Docs"}'
+
+node ./scripts/cli-connect-workspace-e2e.mjs --project-id prj_xxx
+node ./scripts/pull-connect-workspace-e2e.mjs --project-id prj_xxx
+node ./scripts/connect-transport-matrix-e2e.mjs --project-id prj_xxx --retries 2
+
 reallink org list
 reallink org create --name "My Org"
 reallink org get --org-id org_xxx
@@ -89,6 +123,10 @@ reallink link list
 reallink link use --project-id prj_xxx
 reallink link doctor --project-id prj_xxx
 reallink link doctor --project-id prj_xxx --verify-remote
+reallink link source --project-id prj_xxx --path ./game-source --label project
+reallink link connect --project-id prj_xxx
+reallink link connect --project-id prj_xxx --workspace-id dev-mac-main --transport websocket
+reallink link connect --project-id prj_xxx --access-token <token> --base-url https://api.real-agent.link
 reallink link paths --project-id prj_xxx
 reallink link open
 reallink link open --project-id prj_xxx --arg "-game" --arg "-log"
@@ -106,6 +144,7 @@ reallink link plugin install --project-id prj_xxx --name RealLinkUnreal --url ht
 - By default it requests core/assets/trace/scheduler/admin scopes plus `tools:*`.
 - If the server rejects `tools:*` as invalid, CLI automatically retries with compatible scopes.
 - You can always pass explicit scopes via repeated `--scope`.
+- Agent-oriented commands can bypass the saved login session by passing `--access-token <token>` together with `--base-url`.
 
 `tool register`, `tool enable/disable` metadata, `tool run --input-file`, and `tool prompt --input-file` accept JSONC.
 `tool context put --text-file` accepts plain UTF-8 text files and stores scoped context via API gateway.

package/bin/reallink.cjs

@@ -35,6 +35,10 @@ function runBinary(binaryPath) {
 }
 
 function resolvePreferredBinary() {
+  if (process.env.REALLINK_FORCE_BUILD === "1") {
+    return resolveExistingReleaseBinary();
+  }
+
   if (fs.existsSync(prebuiltBinaryPath)) {
     return prebuiltBinaryPath;
   }
@@ -42,7 +46,8 @@ function resolvePreferredBinary() {
 }
 
 function ensureBinary() {
-  if (resolvePreferredBinary()) {
+  const preferredBinary = resolvePreferredBinary();
+  if (preferredBinary && process.env.REALLINK_FORCE_BUILD !== "1") {
     return true;
   }
 
@@ -63,7 +68,7 @@ function ensureBinary() {
     return false;
   }
 
-  return build.status === 0 && !!resolvePreferredBinary();
+  return build.status === 0 && !!resolveExistingReleaseBinary();
 }
 
 if (!ensureBinary()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reallink-cli",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Rust-based CLI for Reallink auth and API operations",
   "bin": {
     "reallink": "bin/reallink.cjs"
@@ -17,11 +17,12 @@
   ],
   "scripts": {
     "contract:codegen": "node ./scripts/generate-contract.mjs",
-    "prepack": "pnpm run contract:codegen && node ./scripts/prepare-prebuilt.cjs",
+    "prepack": "node ./scripts/generate-contract.mjs && node ./scripts/prepare-prebuilt.cjs",
     "postinstall": "node ./scripts/postinstall.cjs",
-    "build": "pnpm run contract:codegen && cargo build --manifest-path ./rust/Cargo.toml --release",
+    "build": "node ./scripts/generate-contract.mjs && cargo build --manifest-path ./rust/Cargo.toml --release",
     "dev": "node ./bin/reallink.cjs --help",
-    "pack:local": "npm pack --json"
+    "pack:local": "npm pack --json",
+    "smoke:install": "node ./scripts/smoke-install.cjs"
   },
   "keywords": [
     "reallink",
@@ -30,6 +31,15 @@
     "oauth"
   ],
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/real-link-tech/ReallinkOS.git",
+    "directory": "packages/reallink-cli"
+  },
+  "bugs": {
+    "url": "https://github.com/real-link-tech/ReallinkOS/issues"
+  },
+  "homepage": "https://github.com/real-link-tech/ReallinkOS/tree/main/packages/reallink-cli",
   "publishConfig": {
     "access": "public"
   }

package/rust/Cargo.lock

@@ -8,6 +8,15 @@ version = "2.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "320119579fcad9c21884f5c4861d16174d0e06250625266f50fe6898340abefa"
 
+[[package]]
+name = "aho-corasick"
+version = "1.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ddd31a130427c27518df266943a5308ed92d4b226cc639f5a8f1002816174301"
+dependencies = [
+ "memchr",
+]
+
 [[package]]
 name = "anstream"
 version = "0.6.21"
@@ -1075,7 +1084,7 @@ dependencies = [
 
 [[package]]
 name = "reallink-cli"
-version = "0.1.15"
+version = "0.1.17"
 dependencies = [
  "anyhow",
  "clap",
@@ -1083,6 +1092,7 @@ dependencies = [
  "futures-util",
  "hostname",
  "json5",
+ "regex",
  "reqwest",
  "serde",
  "serde_json",
@@ -1106,6 +1116,35 @@ dependencies = [
  "thiserror 1.0.69",
 ]
 
+[[package]]
+name = "regex"
+version = "1.12.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e10754a14b9137dd7b1e3e5b0493cc9171fdd105e0ab477f51b72e7f3ac0e276"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-automata",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-automata"
+version = "0.4.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6e1dd4122fc1595e8162618945476892eefca7b88c52820e74af6262213cae8f"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-syntax"
+version = "0.8.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dc897dd8d9e8bd1ed8cdad82b5966c3e0ecae09fb1907d58efaa013543185d0a"
+
 [[package]]
 name = "reqwest"
 version = "0.12.28"

package/rust/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "reallink-cli"
-version = "0.1.15"
+version = "0.1.17"
 edition = "2021"
 description = "CLI for Reallink auth and token workflows"
 license = "MIT"
@@ -14,6 +14,7 @@ reqwest = { version = "0.12", default-features = false, features = ["json", "rus
 serde = { version = "1.0", features = ["derive"] }
 serde_json = "1.0"
 json5 = "0.4"
+regex = "1.11"
 sha2 = "0.10"
 tokio = { version = "1.42", features = ["macros", "rt-multi-thread", "time", "fs", "io-util", "signal"] }
 tokio-tungstenite = { version = "0.24", features = ["rustls-tls-webpki-roots"] }