nylorun 0.1.2-beta → 0.2.1-beta

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # nylorun
 
+## 0.2.1-beta
+
+### Patch Changes
+
+- db956bc: Studio creates Tenants. While the Host has none, Studio asks for a name and creates the first one. A Tenant with no agents shows **Connect your code**: its model provider, the `npx @nylorun/cli tenant use <id>` command, and `npm run dev`. It switches to the agent list when the first agent registers.
+
+  Every Tenant Studio creates registers the derived principal `project` (`PROJECT_PRINCIPAL_ID` in `@nylorun/admin`). `nylo tenant use` now falls back to that key, derived from the local admin key, so a Project links a Studio-created Tenant with no stored key. When it replaces a one-time application key, it keeps that key as `.nylorun/credentials.<tenantId>.json`, and `nylo tenant use <that id>` switches back. `nylorun up` again offers Studio for creating the first Tenant.
+
+- Pin studio to the tested release.
+
+## 0.2.0-beta
+
+### Minor Changes
+
+- c82aa6f: `nylorun up` prints Studio as `http://localhost:<port>`, with no login token in it, and in a terminal opens Studio in the browser already signed in (`--no-open` keeps the browser closed). The Studio sign-in lasts 30 days and survives Studio restarts: the session cookie is signed with a key derived from the admin key instead of being held in memory. `nylorun studio` prints the plain URL when it opens the browser; `nylorun studio --no-open` still prints the single-use login URL.
+
+### Patch Changes
+
+- 5e4947a: `nylorun up` no longer says a Tenant can be created in Studio, which has no way to create one. While the Host has no Tenant, it names `npx @nylorun/cli tenant create` alone.
+- Pin studio to the tested release.
+
 ## 0.1.2-beta
 
 ### Patch Changes

package/README.md

@@ -29,11 +29,11 @@ npx nylorun doctor                 # Node 24+, Docker, Compose v2, and the stack
 ## Commands
 
 ```sh
-nylorun up|start [--no-studio]     # set up (first run) and start the stack; print the Runtime URL and a Studio login URL
+nylorun up|start [--no-studio] [--no-open]  # set up (first run) and start the stack; print the Runtime and Studio URLs; open Studio signed in
 nylorun down|stop                  # stop the containers; keep volumes
 nylorun status [--json]            # services, endpoints, Runtime health
 nylorun logs [service] [-f] [--tail <n>]   # postgres, restate, s2, runtime, studio
-nylorun studio [--no-open]         # fresh Studio login (on the linked Project's Tenant); starts the stack if needed
+nylorun studio [--no-open]         # sign a browser in to Studio (on the linked Project's Tenant); starts the stack if needed
 nylorun reset [--yes]              # delete the stack's volumes and every Tenant
 nylorun doctor [--json]            # prerequisites and stack health
 ```
@@ -57,12 +57,16 @@ CI). Ports publish on loopback only: the Runtime on `8787`, Studio on `4161`
 and the Restate UI on `9070`, or free ports chosen on the first start and kept
 in `.env`. While the Host has no Tenant, `up` says how to create one.
 
-Studio has no password: nylorun asks the Studio container for a single-use
-login token with the admin key (`POST /_studio/login-tokens`) and opens
-`http://localhost:<port>/login?token=…`, which sets a session cookie. The
-token expires after two minutes; `nylorun studio` mints a fresh one. Inside a
-linked project, `nylorun studio` reads `.nylorun/link.json` (never writes it)
-and lands on that project's Tenant.
+`up` prints Studio as `http://localhost:<port>`. Studio has no password: in a
+terminal (not in CI, and not with `--no-open`), `up` asks the Studio container
+for a single-use login token with the admin key (`POST /_studio/login-tokens`)
+and opens `http://localhost:<port>/login?token=…` in the browser. That sets a
+session cookie for 30 days, which survives Studio restarts, so the printed URL
+keeps working in that browser. The token itself is never printed unless no
+browser starts. Otherwise `up` says to run `nylorun studio`, which signs a
+browser in the same way; `nylorun studio --no-open` prints the login URL (it
+works once, for two minutes) instead. Inside a linked project, `nylorun studio`
+reads `.nylorun/link.json` (never writes it) and lands on that project's Tenant.
 
 ## Host root
 

package/dist/cli.js

@@ -8,7 +8,7 @@ const usage = `nylorun <up|down|start|stop|status|logs|studio|reset|doctor>
 
 Local stack (Docker Compose):
 ${stackUsage}
-  doctor [--json]                   check Node, Docker and Compose v2, and the stack's health
+  doctor [--json]                     check Node, Docker and Compose v2, and the stack's health
 
 nylorun sets up and runs the local stack. Tenants, Project links and model
 providers belong to the Runtime client: npx @nylorun/cli --help`;

package/dist/stack/commands.d.ts

@@ -17,7 +17,10 @@ export interface StackDeps {
     err(line: string): void;
     /** Ask a yes/no question on the terminal; undefined when not interactive. */
     confirm?(question: string): Promise<boolean>;
-    openBrowser(url: string): Promise<void>;
+    /** A developer is at a terminal: `start` may open a browser. */
+    interactive?: boolean;
+    /** Open `url` in a browser; false when no browser could be started. */
+    openBrowser(url: string): Promise<boolean>;
     /** Is this process id alive? (launcher-managed Runtime detection) */
     pidAlive(pid: number): boolean;
     /** Delay between health polls; tests shorten it. */
@@ -38,6 +41,8 @@ export declare function parseStackFlags(args: readonly string[], allowed: {
     values?: readonly string[];
     aliases?: Record<string, string>;
 }, usage: string): Flags;
+/** Printed by `start` when it does not open Studio itself. */
+export declare const STUDIO_SIGN_IN_HINT = "To sign a browser in to Studio, run \"npx nylorun studio\".";
 /** Printed by `start` while the Host has no Tenant: nylorun never creates one. */
 export declare const TENANT_HINT = "No Tenant yet. Create one in Studio, or run `npx @nylorun/cli tenant create` in your project.";
 export interface StackStatus {

package/dist/stack/commands.js

@@ -12,12 +12,12 @@ import { mintStudioLogin, studioOrigin } from "./studio-login.js";
 export const STACK_SERVICES = ["postgres", "restate", "s2", "runtime", "studio"];
 const CORE_SERVICES = ["postgres", "restate", "s2", "runtime"];
 const DEFAULT_PROJECT = "nylorun";
-export const stackUsage = `  up|start [--no-studio]            set up the stack on first run, then start it; print the Runtime URL and a Studio login URL
-  down|stop                         stop the stack's containers; keep volumes
-  status [--json] [--env]           services, endpoints and Runtime health (--env: the linked Project's variables)
-  logs [service] [-f] [--tail <n>]  stack logs (${STACK_SERVICES.join(", ")})
-  studio [--no-open]                open a fresh Studio login (on the linked Project's Tenant); start the stack if it is stopped
-  reset [--yes]                     delete the stack's volumes and Tenant directories`;
+export const stackUsage = `  up|start [--no-studio] [--no-open]  set up the stack on first run, then start it; print the Runtime and Studio URLs and open Studio signed in (in a terminal)
+  down|stop                           stop the stack's containers; keep volumes
+  status [--json] [--env]             services, endpoints and Runtime health (--env: the linked Project's variables)
+  logs [service] [-f] [--tail <n>]    stack logs (${STACK_SERVICES.join(", ")})
+  studio [--no-open]                  sign a browser in to Studio (on the linked Project's Tenant); --no-open prints the login URL; start the stack if it is stopped
+  reset [--yes]                       delete the stack's volumes and Tenant directories`;
 const usageError = (message) => new CliError(message, 2);
 export function stackProject(env) {
     const project = env.NYLORUN_STACK_PROJECT?.trim() || DEFAULT_PROJECT;
@@ -188,19 +188,39 @@ async function tryStudioLogin(ctx, studioPort, adminKey) {
     ctx.deps.err(`Warning: Studio at ${studioOrigin(studioPort)} is not reachable for a login (${lastError}).`);
     return undefined;
 }
+/** Printed by `start` when it does not open Studio itself. */
+export const STUDIO_SIGN_IN_HINT = 'To sign a browser in to Studio, run "npx nylorun studio".';
+/** `start` opens Studio only for a developer at a terminal, outside CI. */
+function opensBrowser(deps, flags) {
+    return Boolean(deps.interactive) && !deps.env.CI && !flags.booleans.has("--no-open");
+}
+/**
+ * Open a Studio login in the browser, or print it when no browser starts.
+ * The login URL carries a single-use token, so it is printed only as a fallback.
+ */
+async function openLogin(ctx, login) {
+    if (!(await ctx.deps.openBrowser(login)))
+        ctx.deps.out(`Sign in   ${login}`);
+}
 /** Printed by `start` while the Host has no Tenant: nylorun never creates one. */
 export const TENANT_HINT = "No Tenant yet. Create one in Studio, or run `npx @nylorun/cli tenant create` in your project.";
 async function start(ctx, args) {
-    const flags = parseStackFlags(args, { booleans: ["--no-studio"] }, "nylorun start [--no-studio]");
+    const usage = "nylorun start [--no-studio] [--no-open]";
+    const flags = parseStackFlags(args, { booleans: ["--no-studio", "--no-open"] }, usage);
     if (flags.rest.length)
-        throw usageError("Usage: nylorun start [--no-studio]");
+        throw usageError(`Usage: ${usage}`);
     await dockerPreflight(ctx.deps.docker);
     const started = await bringUp(ctx, { studio: !flags.booleans.has("--no-studio") });
     ctx.deps.out(`Runtime   ${started.runtimeUrl}`);
     if (started.studioStarted) {
-        const login = await tryStudioLogin(ctx, started.studioPort, started.adminKey);
-        if (login)
-            ctx.deps.out(`Studio    ${login}`);
+        ctx.deps.out(`Studio    ${studioOrigin(started.studioPort)}`);
+        if (opensBrowser(ctx.deps, flags)) {
+            const login = await tryStudioLogin(ctx, started.studioPort, started.adminKey);
+            if (login)
+                await openLogin(ctx, login);
+        }
+        else
+            ctx.deps.err(STUDIO_SIGN_IN_HINT);
     }
     if ((await adminTenantCount(ctx.deps, started.runtimeUrl, started.adminKey)) === 0)
         ctx.deps.err(TENANT_HINT);
@@ -446,9 +466,13 @@ async function studio(ctx, args, options = {}) {
     const login = await studioLoginUrl(ctx.deps, stack, options.next);
     if (!login)
         return 1;
-    ctx.deps.out(`Studio    ${login}`);
-    if (!flags.booleans.has("--no-open"))
-        await ctx.deps.openBrowser(login);
+    if (flags.booleans.has("--no-open")) {
+        ctx.deps.out(`Studio    ${login}`);
+        return 0;
+    }
+    const origin = studioOrigin(stack.studioPort);
+    ctx.deps.out(`Studio    ${options.next ? new URL(options.next, origin).toString() : origin}`);
+    await openLogin(ctx, login);
     return 0;
 }
 /** `nylorun studio`, landing on `next` (the linked Project's Tenant) when given. */

package/dist/stack/index.js

@@ -40,17 +40,18 @@ export function defaultStackDeps(env) {
                 },
             }
             : {}),
+        interactive,
         openBrowser: async (url) => {
             const command = browserCommand(env);
-            await new Promise((resolve) => {
+            return await new Promise((resolve) => {
                 const child = spawn(command, [url], { detached: true, stdio: "ignore" });
                 child.once("error", () => {
-                    console.error(`Could not start ${command} to open a browser; open the Studio URL above.`);
-                    resolve();
+                    console.error(`Could not start ${command} to open a browser.`);
+                    resolve(false);
                 });
                 child.once("spawn", () => {
                     child.unref();
-                    resolve();
+                    resolve(true);
                 });
             });
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nylorun",
-  "version": "0.1.2-beta",
+  "version": "0.2.1-beta",
   "type": "module",
   "license": "Apache-2.0",
   "description": "Set up and run the local Nylorun stack (Runtime and Studio) with Docker Compose",
@@ -42,6 +42,6 @@
   },
   "nylorun": {
     "runtime": "0.13.0-beta",
-    "studio": "0.11.0-beta"
+    "studio": "0.13.0-beta"
   }
 }