@lotics/cli 0.30.1 → 0.31.0

package/dist/src/app_commands.d.ts

@@ -78,6 +78,14 @@ export declare function appCreate(client: LoticsClient, args: {
  *   6. (TODO) Generate `.lotics/types.ts` with workspace tables augmentation —
  *      pending a `client.getWorkspaceSchema()` endpoint.
  */
+/**
+ * `lotics app subdomain <new>` — rename the current app's public address.
+ * The app_id comes from the local `package.json` manifest. The old
+ * `<slug>.lotics.app` stops resolving once the change lands.
+ */
+export declare function appSetSubdomain(client: LoticsClient, args: {
+    subdomain: string;
+}): Promise<void>;
 export declare function appPull(client: LoticsClient, args: {
     app_id: string;
     targetPath?: string;

package/dist/src/app_commands.js

@@ -66,6 +66,10 @@ function readAppMeta(projectDir) {
         version_number: pkg.lotics.version_number ?? null,
         workflows: pkg.lotics.workflows ?? {},
         queries: pkg.lotics.queries ?? {},
+        // Left as `undefined` when absent so the deploy omits them and the
+        // App row's icon/theme is preserved.
+        icon: pkg.lotics.icon,
+        theme: pkg.lotics.theme,
     };
 }
 function writeAppMeta(projectDir, meta) {
@@ -189,6 +193,16 @@ export async function appCreate(client, args) {
  *   6. (TODO) Generate `.lotics/types.ts` with workspace tables augmentation —
  *      pending a `client.getWorkspaceSchema()` endpoint.
  */
+/**
+ * `lotics app subdomain <new>` — rename the current app's public address.
+ * The app_id comes from the local `package.json` manifest. The old
+ * `<slug>.lotics.app` stops resolving once the change lands.
+ */
+export async function appSetSubdomain(client, args) {
+    const meta = readAppMeta(process.cwd());
+    const result = await client.setAppSubdomain(meta.app_id, args.subdomain);
+    console.error(`Public address set: https://${result.public_subdomain}.lotics.app`);
+}
 export async function appPull(client, args) {
     const app = await client.getApp(args.app_id);
     if (!app.current_version_id) {
@@ -283,6 +297,10 @@ export async function appDeploy(client, args) {
                 // Sync apps.queries from the manifest. Server validates each query
                 // template (parseQueryNode, table access, param coverage).
                 queries: meta.queries ?? {},
+                // Optional icon/theme overrides — only sent when the manifest
+                // declares them (undefined ⇒ omitted ⇒ App row left untouched).
+                icon: meta.icon,
+                theme: meta.theme,
                 // Opt into destructive workflow removal. Default false — the server
                 // rejects deploys whose manifest is missing aliases the App row has.
                 force_workflow_sync: args.forceWorkflowSync,

package/dist/src/cli.js

@@ -5,7 +5,7 @@ import readline from "node:readline";
 import { LoticsClient, API_BASE_URL } from "./client.js";
 import { resolveAuth, loadConfig, saveConfig, deleteConfig, getConfigPath, checkForUpdate } from "./config.js";
 import { VERSION } from "./version.js";
-import { appCreate, appPull, appDeploy, appDev } from "./app_commands.js";
+import { appCreate, appPull, appDeploy, appDev, appSetSubdomain } from "./app_commands.js";
 import { parseArgs } from "./args.js";
 function printHelp() {
     console.log(`Lotics CLI v${VERSION} — AI agent interface for Lotics
@@ -51,6 +51,7 @@ COMMANDS
                                        Build + upload current dir as a new version
                                        (--force-workflow-sync wipes server-only
                                        workflow aliases; default refuses)
+  lotics app subdomain <new-subdomain> Rename the app's public <slug>.lotics.app address
   lotics app dev [path]                Run the app locally with HMR (RPC forwarded to prod)
 
 FLAGS
@@ -359,6 +360,7 @@ async function main() {
         console.error("  lotics app pull <app_id> [path]      Pull an existing app for local editing");
         console.error("  lotics app deploy [-m <message>] [--force-workflow-sync]");
         console.error("                                       Build + upload the current directory");
+        console.error("  lotics app subdomain <new-subdomain> Rename the app's public <slug>.lotics.app address");
         console.error("  lotics app dev [path]                Run the app locally with HMR + RPC forwarding");
         process.exit(1);
     }
@@ -481,6 +483,16 @@ async function main() {
             await appDeploy(client, { message, forceWorkflowSync: flags.forceWorkflowSync });
             return;
         }
+        if (subcommand === "subdomain") {
+            const newSubdomain = toolArgs;
+            if (!newSubdomain) {
+                console.error("Usage: lotics app subdomain <new-subdomain>");
+                console.error("Renames the app's public address — https://<slug>.lotics.app");
+                process.exit(1);
+            }
+            await appSetSubdomain(client, { subdomain: newSubdomain });
+            return;
+        }
         if (subcommand === "dev") {
             // First positional is an optional project path (defaults to cwd).
             // --port and --vite-port can override the wrapper / Vite ports.

package/dist/src/client.d.ts

@@ -105,6 +105,15 @@ export declare class LoticsClient {
         workspace_id: string;
         current_version_id: string | null;
     }>;
+    /**
+     * Rename an app's public subdomain — its `<slug>.lotics.app` address.
+     * Mirrors PUT /v1/apps/{app_id}/subdomain. The old subdomain stops
+     * resolving once the change lands.
+     */
+    setAppSubdomain(app_id: string, public_subdomain: string): Promise<{
+        app_id: string;
+        public_subdomain: string;
+    }>;
     getAppVersion(app_id: string, version_id: string): Promise<{
         id: string;
         app_id: string;
@@ -188,6 +197,14 @@ export declare class LoticsClient {
             ast: unknown;
             params?: Record<string, unknown>;
         }>;
+        /**
+         * App icon (Lucide name) + theme `{ color }` from `package.json#lotics`.
+         * `undefined` ⇒ not sent ⇒ the deploy leaves the App row's icon/theme
+         * as-is. A present value is applied authoritatively. `icon` rides as a
+         * raw form field; `theme` is an object, so it's JSON-encoded.
+         */
+        icon?: string;
+        theme?: Record<string, unknown>;
         /**
          * Opt into destructive workflow removal. When false/absent, the server
          * rejects a deploy whose `workflows` map is missing aliases that exist

package/dist/src/client.js

@@ -149,6 +149,14 @@ export class LoticsClient {
     async createApp(body) {
         return this.request("POST", "/v1/apps", { ...body, ui: { type: "custom_code" } });
     }
+    /**
+     * Rename an app's public subdomain — its `<slug>.lotics.app` address.
+     * Mirrors PUT /v1/apps/{app_id}/subdomain. The old subdomain stops
+     * resolving once the change lands.
+     */
+    async setAppSubdomain(app_id, public_subdomain) {
+        return this.request("PUT", `/v1/apps/${encodeURIComponent(app_id)}/subdomain`, { public_subdomain });
+    }
     async getAppVersion(app_id, version_id) {
         return this.request("GET", `/v1/apps/${encodeURIComponent(app_id)}/versions/${encodeURIComponent(version_id)}`);
     }
@@ -208,6 +216,16 @@ export class LoticsClient {
         // Always send queries — empty object clears any previously-declared
         // named queries. Server validates each template.
         formData.append("queries", JSON.stringify(args.queries ?? {}));
+        // icon/theme are optional overrides — only sent when the manifest
+        // declares them, so a deploy never clobbers a value set in the UI.
+        // `icon` is a plain string → raw field, like `message`. `theme` is an
+        // object → JSON-encoded, like `workflows`/`queries`.
+        if (args.icon !== undefined) {
+            formData.append("icon", args.icon);
+        }
+        if (args.theme !== undefined) {
+            formData.append("theme", JSON.stringify(args.theme));
+        }
         // Only post the override flag when the user explicitly opts in. The
         // server defaults to "honor the guard" — opt-in is loud, opt-out
         // requires intent.

package/dist/src/dev/server.js

@@ -31,10 +31,19 @@ export async function startDevServer(args) {
     });
     // ── Vite child ──────────────────────────────────────────────────────────
     // `npx vite` resolves to the project's installed Vite (devDependency in
-    // the starter). Inherit stdio so the dev sees Vite's own banner + HMR logs.
+    // the starter). stdout/stderr are inherited so the dev sees Vite's banner
+    // + HMR logs.
+    //
+    // stdin is inherited ONLY under a TTY. Vite's dev server quits when a
+    // non-interactive stdin (a backgrounded launch, `</dev/null`, a closing
+    // pipe) reaches EOF — so inheriting it would kill the dev server the moment
+    // `lotics app dev` runs under an agent, CI, or `nohup`. A non-TTY launch
+    // gets `/dev/null` (`"ignore"`) instead, decoupling Vite's lifetime from
+    // however the wrapper was started. Vite's CLI shortcuts (`r`/`q`/`u`) are
+    // only meaningful under a TTY anyway.
     const viteChild = spawn("npx", ["vite", "--port", String(vitePort), "--strictPort"], {
         cwd: args.projectDir,
-        stdio: "inherit",
+        stdio: [process.stdin.isTTY ? "inherit" : "ignore", "inherit", "inherit"],
         env: { ...process.env, FORCE_COLOR: "1" },
     });
     let stopped = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/cli",
-  "version": "0.30.1",
+  "version": "0.31.0",
   "description": "Lotics SDK and CLI for AI agents",
   "type": "module",
   "bin": {