golem-bridge 1.0.2 → 1.0.3

package/README.md

@@ -15,7 +15,7 @@ Connect to my Roblox Studio, Run: npx golem-bridge connect <channelId>
 ```
 
 The line is a session token: Studio mints a fresh channel on every start
-and wipes the old one. After a restart, re-run connect with the new line.
+and wipes the old one.
 
 The user sends that line to their AI. It downloads this package, which asks
 the plugin for its two connection files and stores them under `./.golem/`:
@@ -28,6 +28,18 @@ python3 ./.golem/golem.py ping
 `ping` should return `"ok": true` plus the open place name. Then the agent
 reads `./.golem/golem.md` for the full tool reference.
 
+After a Studio restart, relink with the new line:
+
+```sh
+npx golem-bridge reconnect <newChannelId>
+```
+
+Done with a session? Forget it locally (Studio is unaffected):
+
+```sh
+npx golem-bridge disconnect
+```
+
 ## Files
 
 - `cli.js` - source of the `golem-bridge` package
@@ -62,5 +74,3 @@ theater rather than security.
 - Socket.dev flags the "URL strings" in this package (the relay address).
 That is informational: the relay address is the product. The setup payload
 is validated as described above before anything is written.
-npm publish
-```

package/cli.js

@@ -31,13 +31,20 @@ function printHelp() {
 
 Usage:
   golem-bridge connect <channelId> [--print]
+  golem-bridge reconnect <channelId> [--print]
+  golem-bridge disconnect
   golem-bridge --help
   golem-bridge --version
 
   <channelId>  shown in the Golem plugin widget inside Roblox Studio.
-               Fresh on every Studio start; re-run connect after a restart.
+               Fresh on every Studio start.
   --print      audit mode: fetch and print both files without writing anything.
 
+connect     link this folder to a Studio session (writes ./.golem/).
+reconnect   same, for a rotated token: replaces the old session files.
+            Use after a Studio restart, with the new line from the widget.
+disconnect  forget this session (removes ./.golem/). Studio is unaffected.
+
 connect writes ./.golem/golem.py and ./.golem/golem.md, fetched over HTTPS
 from your own Studio session. Review both files before running anything.`);
 }
@@ -169,6 +176,41 @@ function sha256(text) {
   return crypto.createHash("sha256").update(text, "utf8").digest("hex");
 }
 
+function readSavedChannel() {
+  try {
+    const src = fs.readFileSync(path.join(process.cwd(), ".golem", "golem.py"), "utf8");
+    const m = src.match(/CHANNEL = os\.environ\.get\("AIB_CHANNEL", "([0-9a-fA-F]+)"\)/);
+    return m ? m[1] : null;
+  } catch {
+    return null;
+  }
+}
+
+function disconnectLocal() {
+  const dir = path.join(process.cwd(), ".golem");
+  if (!fs.existsSync(dir)) {
+    console.log("Not connected (no .golem/ in this folder).");
+    return;
+  }
+  const old = readSavedChannel();
+  fs.rmSync(dir, { recursive: true, force: true });
+  console.log(old ? `Disconnected from channel ${old} (removed .golem/).` : "Disconnected (removed .golem/).");
+  console.log("Studio is unaffected. To link again: npx golem-bridge connect <channelId>");
+}
+
+async function reconnect(channelId, printOnly) {
+  validateChannel(channelId);
+  const old = readSavedChannel();
+  if (!printOnly && old && old.toLowerCase() === channelId.toLowerCase()) {
+    console.log(`Already linked to channel ${channelId} — nothing to do.`);
+    return;
+  }
+  if (!printOnly && old) {
+    console.log(`Replacing session files for channel ${old}.`);
+  }
+  await connect(channelId, printOnly);
+}
+
 async function connect(channelId, printOnly) {
   validateChannel(channelId);
   console.log(`Contacting Golem plugin on channel ${channelId} ...`);
@@ -225,7 +267,12 @@ async function main() {
     console.log(VERSION);
     return;
   }
-  if (args[0] !== "connect") {
+  if (args[0] === "disconnect") {
+    disconnectLocal();
+    return;
+  }
+  const isReconnect = args[0] === "reconnect";
+  if (args[0] !== "connect" && !isReconnect) {
     printHelp();
     process.exit(2);
   }
@@ -236,7 +283,11 @@ async function main() {
     process.exit(2);
   }
   try {
-    await connect(channelId, printOnly);
+    if (isReconnect) {
+      await reconnect(channelId, printOnly);
+    } else {
+      await connect(channelId, printOnly);
+    }
   } catch (err) {
     fail(err.message, 1);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "golem-bridge",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Connects an AI coding agent to a running Roblox Studio session via the Golem plugin.",
   "bin": {
     "golem-bridge": "./cli.js"