@ccmsg/cli 0.3.0 → 0.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ccmsg/cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "The ccmsg daemon, CLI and agent plugins for one instance (= one config home)",
   "license": "MIT",
   "author": "kawaz",
@@ -20,7 +20,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ccmsg/protocol": "1.9.0"
+    "@ccmsg/protocol": "1.10.0"
   },
   "devDependencies": {
     "@types/bun": "^1.3.0",

package/src/instance/config.ts

@@ -286,6 +286,21 @@ function endpointOf(file: string, at: string, raw: unknown): Endpoint {
   return raw as Endpoint;
 }
 
+/** `terminal_gateway`'s shape, matched to the contract's `HelloResult` so a
+ * value this instance would refuse to report is refused here instead, at
+ * startup, rather than on the first `hello`. */
+const TERMINAL_GATEWAY = /^https?:\/\/[^/?#\s]+(\/[^?#\s]*[^/?#\s])?$/;
+
+function terminalGatewayOf(file: string, raw: string): string {
+  if (!TERMINAL_GATEWAY.test(raw)) {
+    throw new ConfigError(
+      file,
+      `upstream.terminal_gateway must be an http:// or https:// base URL with no trailing slash, got ${raw}`,
+    );
+  }
+  return raw;
+}
+
 function peersOf(file: string, raw: unknown): readonly Endpoint[] {
   if (raw === undefined) return [];
   if (!Array.isArray(raw)) throw new ConfigError(file, "peers must be an array of endpoint URLs");
@@ -334,6 +349,9 @@ function upstreamOf(file: string, raw: unknown): UpstreamConfig {
     }
     config[name] = value;
   }
+  if (config["terminal_gateway"] !== undefined) {
+    config["terminal_gateway"] = terminalGatewayOf(file, config["terminal_gateway"]);
+  }
   const launcher = fields["launcher"];
   return {
     ...(config as UpstreamConfig),

package/src/instance/instance.ts

@@ -469,6 +469,9 @@ export class Instance {
       transcript: this.#transcripts,
       gateway: this.#gateway,
       terminals: hostTerminalReader(),
+      ...(config.upstream.terminal_gateway === undefined
+        ? {}
+        : { terminalGateway: config.upstream.terminal_gateway }),
       log: (msg, fields) => {
         this.log.write(msg, fields);
       },

package/src/sessions/registry.ts

@@ -98,6 +98,12 @@ export interface SessionsDeps {
    * domain cannot judge: a peer's, whose claim is settled by an exchange of its
    * own rather than by anything a session says (§7.2). */
   readonly mesh?: MeshSource;
+  /** Where a person opens the terminal a session runs in, which `hello` states
+   * as `terminal_gateway`. The same value that gates the `terminal` capability
+   * (`sessionCapabilities`), so a client told the capability is on is told
+   * where to reach it in the same greeting. Absent on an instance with no
+   * gateway configured. */
+  readonly terminalGateway?: string;
 }
 
 /** What `hello` needs of the mesh: verify the greeting of a peer, and say which
@@ -291,6 +297,9 @@ export class Sessions implements UpstreamResource {
       capabilities: [...this.deps.capabilities],
       version: this.deps.version,
       started_at: this.deps.startedAt,
+      ...(this.deps.terminalGateway === undefined
+        ? {}
+        : { terminal_gateway: this.deps.terminalGateway }),
       ...(expiresAt === undefined ? {} : { auth_expires_at: expiresAt }),
     };
   }