@techsologic/unolock-agent 0.1.32 → 0.1.33

package/bin/unolock-agent.js

@@ -7,9 +7,48 @@ const path = require("path");
 const https = require("https");
 const { spawn } = require("child_process");
 
-const PACKAGE_VERSION = "0.1.32";
-const FALLBACK_BINARY_VERSION = "0.1.32";
+const PACKAGE_VERSION = "0.1.33";
+const FALLBACK_BINARY_VERSION = "0.1.33";
 const REPO = "TechSologic/unolock-agent";
+const TOP_LEVEL_USAGE = `usage: unolock-agent [-h] [--version] {link-agent-key,set-agent-pin,list-spaces,get-current-space,set-current-space,list-records,list-notes,list-checklists,get-record,create-note,update-note,append-note,rename-record,create-checklist,set-checklist-item-done,add-checklist-item,remove-checklist-item,list-files,get-file,download-file,upload-file,rename-file,replace-file,delete-file,tpm-diagnose,tpm-check,self-test,mcp} ...
+
+UnoLock Agent commands.
+
+positional arguments:
+  link-agent-key         Link a one-time UnoLock Agent Key URL and PIN to this device.
+  set-agent-pin          Set the in-memory UnoLock agent PIN.
+  list-spaces            List accessible UnoLock spaces.
+  get-current-space      Show the current UnoLock space.
+  set-current-space      Set the current UnoLock space.
+  list-records           List notes and checklists in the current space.
+  list-notes             List notes in the current space.
+  list-checklists        List checklists in the current space.
+  get-record             Get one note or checklist by record_ref.
+  create-note            Create a note in the current space.
+  update-note            Update an existing note.
+  append-note            Append text to an existing note.
+  rename-record          Rename a note or checklist.
+  create-checklist       Create a checklist in the current space.
+  set-checklist-item-done
+                         Set one checklist item's done state.
+  add-checklist-item     Add an item to a checklist.
+  remove-checklist-item  Remove an item from a checklist.
+  list-files             List Cloud files in the current space.
+  get-file               Get metadata for one Cloud file.
+  download-file          Download a Cloud file to the local filesystem.
+  upload-file            Upload a local file into the current space.
+  rename-file            Rename a Cloud file.
+  replace-file           Replace a Cloud file with local content.
+  delete-file            Delete a Cloud file.
+  tpm-diagnose           Diagnose TPM/vTPM readiness for the UnoLock agent MCP.
+  tpm-check              Fail-fast check for production-ready TPM/vTPM/platform-backed key access.
+  self-test              Run a one-shot UnoLock Agent readiness check.
+  mcp                    Run the UnoLock stdio MCP server.
+
+options:
+  -h, --help             show this help message and exit
+  --version              show program's version number and exit
+`;
 
 function platformAssetInfo() {
   const platform = process.platform;
@@ -173,12 +212,26 @@ function writeReleaseMetadata(releaseVersion) {
   );
 }
 
-async function resolveReleaseVersion() {
+function cachedReleaseVersion() {
   const override = normalizeVersion(process.env.UNOLOCK_AGENT_BINARY_VERSION);
   if (override) {
     return override;
   }
   const metadata = readReleaseMetadata();
+  if (metadata && typeof metadata.releaseVersion === "string" && fs.existsSync(binaryPath(metadata.releaseVersion))) {
+    return metadata.releaseVersion;
+  }
+  if (fs.existsSync(binaryPath(FALLBACK_BINARY_VERSION))) {
+    return FALLBACK_BINARY_VERSION;
+  }
+  return null;
+}
+
+async function resolveReleaseVersion() {
+  const cached = cachedReleaseVersion();
+  if (cached) {
+    return cached;
+  }
   try {
     const payload = await fetchJson(`https://api.github.com/repos/${REPO}/releases/latest`);
     const latest = normalizeVersion(payload && payload.tag_name);
@@ -187,9 +240,6 @@ async function resolveReleaseVersion() {
       return latest;
     }
   } catch (error) {
-    if (metadata && typeof metadata.releaseVersion === "string" && fs.existsSync(binaryPath(metadata.releaseVersion))) {
-      return metadata.releaseVersion;
-    }
     process.stderr.write(`Warning: ${error.message}. Falling back to bundled release ${FALLBACK_BINARY_VERSION}.\n`);
   }
   writeReleaseMetadata(FALLBACK_BINARY_VERSION);
@@ -209,8 +259,16 @@ async function ensureBinary() {
 }
 
 async function main() {
-  const { dest, releaseVersion } = await ensureBinary();
   const forwardedArgs = process.argv.length > 2 ? process.argv.slice(2) : [];
+  if (forwardedArgs.length === 0 || forwardedArgs[0] === "-h" || forwardedArgs[0] === "--help") {
+    process.stdout.write(TOP_LEVEL_USAGE);
+    return;
+  }
+  if (forwardedArgs[0] === "--version") {
+    process.stdout.write(`${PACKAGE_VERSION}\n`);
+    return;
+  }
+  const { dest, releaseVersion } = await ensureBinary();
   const child = spawn(dest, forwardedArgs, {
     stdio: "inherit",
     env: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@techsologic/unolock-agent",
-  "version": "0.1.32",
+  "version": "0.1.33",
   "description": "npx wrapper for the official UnoLock Agent release binaries",
   "license": "UNLICENSED",
   "homepage": "https://unolock.ai",