@tianshu-ai/tianshu 0.3.0

package/packages/server/dist/setup/load-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-env.d.ts","sourceRoot":"","sources":["../../src/setup/load-env.ts"],"names":[],"mappings":"AA4BA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG;IACvD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CA8CA"}

package/packages/server/dist/setup/load-env.js

@@ -0,0 +1,88 @@
+// Load .env from the right place, regardless of CWD.
+//
+// Why this exists:
+// `import "dotenv/config"` only looks at process.cwd()/.env. That
+// works when you run `node packages/server/dist/index.js` from the
+// repo root, but breaks the moment you do anything that shifts
+// CWD — most importantly:
+//   - `npm run dev -w packages/server` (npm sets CWD = packages/server)
+//   - `npx tianshu doctor` from a checkout (CLI shim sits in bin/, but
+//     CWD is wherever the user invoked it from)
+//   - `tianshu start` after `npm install -g`
+// In each of those, the canonical .env that the user filled in
+// during `tianshu setup --wizard` lives at the *repo root* / install
+// root, not at CWD.
+//
+// We find the .env by walking up from this module's own location
+// (which is a stable anchor: it's always somewhere under the
+// install / checkout root). First .env hit wins. We also still
+// honour an explicit DOTENV_PATH or a CWD-local .env so the user
+// can override per invocation.
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import * as dotenv from "dotenv";
+let loaded = false;
+/**
+ * Load `.env` once per process. Idempotent.
+ *
+ * Search order:
+ *   1. `DOTENV_PATH` env var (explicit override).
+ *   2. `<cwd>/.env` (preserves the legacy behaviour for users
+ *      who run from the repo root).
+ *   3. Walking up from this file's directory until a `.env` is
+ *      found or we hit the filesystem root.
+ *
+ * Whichever is found first is loaded with `override: false`, so
+ * shell-level env vars still win over file values — that
+ * matches dotenv's default and lets ops override a key for a
+ * single run without editing the file.
+ */
+export function loadEnv(opts = {}) {
+    if (loaded && !opts.force)
+        return { source: null };
+    loaded = true;
+    const candidates = [];
+    const explicit = process.env.DOTENV_PATH;
+    if (explicit)
+        candidates.push(explicit);
+    candidates.push(path.resolve(process.cwd(), ".env"));
+    // Walk up from this file. In dev that's
+    //   <repo>/packages/server/src/setup/load-env.ts
+    // In a published install it's
+    //   <install>/packages/server/dist/setup/load-env.js
+    // Either way, walking up will reach the repo / install root
+    // before the filesystem root.
+    let dir = path.dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 12; i++) {
+        candidates.push(path.join(dir, ".env"));
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    for (const cand of candidates) {
+        if (fs.existsSync(cand)) {
+            // override: true on force-reload so a key the wizard just
+            // appended actually shows up in process.env (dotenv won't
+            // overwrite an already-set var by default).
+            //
+            // quiet: true suppresses dotenv v17's funding tip
+            // ("◇ injected env (N) from .env // tip: ..."). The tip
+            // is shown on every load by default — every
+            // `tianshu status` / `tianshu logs` / `tianshu doctor`
+            // invocation prints it, which is noisy enough to
+            // obscure the actual CLI output. We're not interested
+            // in the advertisement; the user already chose dotenv
+            // by running tianshu.
+            dotenv.config({
+                path: cand,
+                override: opts.force ?? false,
+                quiet: true,
+            });
+            return { source: cand };
+        }
+    }
+    return { source: null };
+}
+//# sourceMappingURL=load-env.js.map

package/packages/server/dist/setup/load-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-env.js","sourceRoot":"","sources":["../../src/setup/load-env.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,mBAAmB;AACnB,kEAAkE;AAClE,mEAAmE;AACnE,+DAA+D;AAC/D,0BAA0B;AAC1B,wEAAwE;AACxE,uEAAuE;AACvE,gDAAgD;AAChD,6CAA6C;AAC7C,+DAA+D;AAC/D,qEAAqE;AACrE,oBAAoB;AACpB,EAAE;AACF,iEAAiE;AACjE,6DAA6D;AAC7D,+DAA+D;AAC/D,iEAAiE;AACjE,+BAA+B;AAE/B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,IAAI,MAAM,GAAG,KAAK,CAAC;AAEnB;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,OAAO,CAAC,OAA4B,EAAE;IAGpD,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACnD,MAAM,GAAG,IAAI,CAAC;IAEd,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACzC,IAAI,QAAQ;QAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAErD,wCAAwC;IACxC,iDAAiD;IACjD,8BAA8B;IAC9B,qDAAqD;IACrD,4DAA4D;IAC5D,8BAA8B;IAC9B,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,0DAA0D;YAC1D,0DAA0D;YAC1D,4CAA4C;YAC5C,EAAE;YACF,kDAAkD;YAClD,wDAAwD;YACxD,4CAA4C;YAC5C,uDAAuD;YACvD,iDAAiD;YACjD,sDAAsD;YACtD,sDAAsD;YACtD,sBAAsB;YACtB,MAAM,CAAC,MAAM,CAAC;gBACZ,IAAI,EAAE,IAAI;gBACV,QAAQ,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK;gBAC7B,KAAK,EAAE,IAAI;aACZ,CAAC,CAAC;YACH,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC"}

package/packages/server/dist/setup/probe-default-model.d.ts

@@ -0,0 +1,28 @@
+export interface ProbeResult {
+    /** Convenience: was the call successful end-to-end? */
+    ok: boolean;
+    /** What we tried — useful for logging / wizard pre-fill. */
+    modelId?: string;
+    baseUrl?: string;
+    /** When `ok=false`, why. */
+    error?: {
+        /**
+         * Categorical reason. The wizard branches on this:
+         *   no-config / no-default-model → ask everything from scratch.
+         *   bad-key                       → re-prompt for key only.
+         *   network / timeout             → re-prompt for baseUrl.
+         *   unknown                       → drop into the full wizard.
+         */
+        kind: "no-config" | "no-default-model" | "no-api-key" | "bad-key" | "model-not-found" | "network" | "timeout" | "unknown";
+        message: string;
+    };
+    /** Wall time. Quick bonus for the doctor. */
+    durationMs: number;
+}
+export interface ProbeOpts {
+    home?: string;
+    /** Default 6s; bumpable for slow corp gateways. */
+    timeoutMs?: number;
+}
+export declare function probeDefaultModel(opts?: ProbeOpts): Promise<ProbeResult>;
+//# sourceMappingURL=probe-default-model.d.ts.map

package/packages/server/dist/setup/probe-default-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-default-model.d.ts","sourceRoot":"","sources":["../../src/setup/probe-default-model.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,EAAE,EAAE,OAAO,CAAC;IACZ,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,KAAK,CAAC,EAAE;QACN;;;;;;WAMG;QACH,IAAI,EACA,WAAW,GACX,kBAAkB,GAClB,YAAY,GACZ,SAAS,GACT,iBAAiB,GACjB,SAAS,GACT,SAAS,GACT,SAAS,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,iBAAiB,CACrC,IAAI,GAAE,SAAc,GACnB,OAAO,CAAC,WAAW,CAAC,CAgGtB"}

package/packages/server/dist/setup/probe-default-model.js

@@ -0,0 +1,133 @@
+// Probe the configured default model with a minimal LLM call.
+//
+// Used by the setup wizard's "smart" flow: if the user already
+// has a working config, we skip the wizard and go straight to
+// `tianshu doctor`. If the probe fails we drop into the wizard.
+//
+// The probe is a 1-token "hi" completion with a 6-second timeout.
+// We catch every conceivable error path (config malformed,
+// provider unreachable, key wrong, model id wrong, network
+// flaking) and surface it as a structured `ProbeResult`. Callers
+// branch on that, never on raw exceptions.
+import { completeSimple } from "@earendil-works/pi-ai";
+import { buildModel, getDefaultModel, resolveApiKey, } from "../core/llm.js";
+import { loadGlobalConfig } from "../core/config.js";
+export async function probeDefaultModel(opts = {}) {
+    const start = Date.now();
+    let config;
+    try {
+        config = loadGlobalConfig(opts.home);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            durationMs: Date.now() - start,
+            error: {
+                kind: "no-config",
+                message: err instanceof Error ? err.message : String(err),
+            },
+        };
+    }
+    const info = getDefaultModel(config);
+    if (!info) {
+        return {
+            ok: false,
+            durationMs: Date.now() - start,
+            error: {
+                kind: "no-default-model",
+                message: "no providers configured (or defaultModel doesn't resolve to one).",
+            },
+        };
+    }
+    const apiKey = resolveApiKey(info);
+    if (!apiKey || apiKey === "test-key-1") {
+        // resolveApiKey() falls back to test-key-1 when nothing is
+        // set; that's a sentinel for "the user didn't actually set
+        // a key" rather than something we should try to call with.
+        return {
+            ok: false,
+            modelId: info.id,
+            baseUrl: info.baseUrl,
+            durationMs: Date.now() - start,
+            error: {
+                kind: "no-api-key",
+                message: `apiKey for ${info.providerId} resolved to empty/sentinel; set ${info.apiKeyTemplate ?? `the provider's API key`} in .env.`,
+            },
+        };
+    }
+    let model;
+    try {
+        model = buildModel(info);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            modelId: info.id,
+            baseUrl: info.baseUrl,
+            durationMs: Date.now() - start,
+            error: {
+                kind: "unknown",
+                message: `buildModel failed: ${err instanceof Error ? err.message : String(err)}`,
+            },
+        };
+    }
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(), opts.timeoutMs ?? 6000);
+    try {
+        // 1-token "hi" — cheapest possible round-trip that exercises
+        // the auth + endpoint + model id end-to-end.
+        const ctx = {
+            messages: [
+                {
+                    role: "user",
+                    content: [{ type: "text", text: "hi" }],
+                    timestamp: Date.now(),
+                },
+            ],
+        };
+        await completeSimple(model, ctx, { signal: ac.signal, apiKey });
+        clearTimeout(timer);
+        return {
+            ok: true,
+            modelId: info.id,
+            baseUrl: info.baseUrl,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        clearTimeout(timer);
+        return {
+            ok: false,
+            modelId: info.id,
+            baseUrl: info.baseUrl,
+            durationMs: Date.now() - start,
+            error: classifyError(err),
+        };
+    }
+}
+function classifyError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    const lower = msg.toLowerCase();
+    if (err instanceof Error && err.name === "AbortError") {
+        return { kind: "timeout", message: msg };
+    }
+    if (lower.includes("401") ||
+        lower.includes("unauthorized") ||
+        lower.includes("invalid api key") ||
+        lower.includes("authentication")) {
+        return { kind: "bad-key", message: msg };
+    }
+    if (lower.includes("404") ||
+        lower.includes("model not found") ||
+        lower.includes("does not exist")) {
+        return { kind: "model-not-found", message: msg };
+    }
+    if (lower.includes("econnrefused") ||
+        lower.includes("enotfound") ||
+        lower.includes("network") ||
+        lower.includes("fetch failed")) {
+        return { kind: "network", message: msg };
+    }
+    return { kind: "unknown", message: msg };
+}
+//# sourceMappingURL=probe-default-model.js.map

package/packages/server/dist/setup/probe-default-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-default-model.js","sourceRoot":"","sources":["../../src/setup/probe-default-model.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,EAAE;AACF,+DAA+D;AAC/D,8DAA8D;AAC9D,gEAAgE;AAChE,EAAE;AACF,kEAAkE;AAClE,2DAA2D;AAC3D,2DAA2D;AAC3D,iEAAiE;AACjE,2CAA2C;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EACL,UAAU,EACV,eAAe,EACf,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAsCrD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAkB,EAAE;IAEpB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;YAC9B,KAAK,EAAE;gBACL,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aAC1D;SACF,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,EAAE,EAAE,KAAK;YACT,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;YAC9B,KAAK,EAAE;gBACL,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EACL,mEAAmE;aACtE;SACF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;QACvC,2DAA2D;QAC3D,2DAA2D;QAC3D,2DAA2D;QAC3D,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;YAC9B,KAAK,EAAE;gBACL,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,cAAc,IAAI,CAAC,UAAU,oCACpC,IAAI,CAAC,cAAc,IAAI,wBACzB,WAAW;aACZ;SACF,CAAC;IACJ,CAAC;IAED,IAAI,KAAiB,CAAC;IACtB,IAAI,CAAC;QACH,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;YAC9B,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,sBAAsB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;aAClF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC;IACnE,IAAI,CAAC;QACH,6DAA6D;QAC7D,6CAA6C;QAC7C,MAAM,GAAG,GAAY;YACnB,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;oBACvC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACtB;aACF;SACF,CAAC;QACF,MAAM,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAChE,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC/B,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;YAC9B,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC;SAC1B,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,GAAY;IACjC,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACtD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAC3C,CAAC;IACD,IACE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;QACrB,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC9B,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QACjC,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAChC,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAC3C,CAAC;IACD,IACE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;QACrB,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QACjC,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAChC,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IACnD,CAAC;IACD,IACE,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC9B,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC3B,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;QACzB,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,EAC9B,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;AAC3C,CAAC"}

package/packages/server/dist/setup/render.d.ts

@@ -0,0 +1,28 @@
+export type CheckSeverity = "ok" | "warning" | "blocker";
+export interface CheckLine {
+    severity: CheckSeverity;
+    /** One-line summary, rendered as the bullet's headline. */
+    text: string;
+    /** Optional dim sub-line for paths, durations, version numbers. */
+    detail?: string;
+}
+export interface CheckGroup {
+    /** Section heading shown in the rendered note (e.g. "Runtime"). */
+    title: string;
+    lines: CheckLine[];
+}
+/** Render one CheckGroup as a clack note. */
+export declare function renderGroup(group: CheckGroup): void;
+/** Summary helpers used by `tianshu doctor` and the startup hook. */
+export interface CheckTally {
+    ok: number;
+    warning: number;
+    blocker: number;
+}
+export declare function tallyGroups(groups: readonly CheckGroup[]): CheckTally;
+export declare function summaryLine(tally: CheckTally): string;
+/** Render the "checks complete" outro line. Tally is appended in
+ *  parens so an operator skimming the trailing line of the report
+ *  immediately knows whether action is required. */
+export declare function renderOutro(tally: CheckTally, suggestion?: string): void;
+//# sourceMappingURL=render.d.ts.map

package/packages/server/dist/setup/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/setup/render.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC;AAEzD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,aAAa,CAAC;IACxB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAQD,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAYnD;AAED,qEAAqE;AACrE,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,CAQrE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAMrD;AAED;;oDAEoD;AACpD,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAUxE"}

package/packages/server/dist/setup/render.js

@@ -0,0 +1,60 @@
+// Rendering helpers for the doctor + setup CLI commands.
+//
+// These wrap @clack/prompts' note/log helpers so each check group
+// renders consistently across the suite. The doctor and wizard
+// surfaces stay free of @clack imports beyond *.intro/outro/cancel
+// — this file owns the visual style.
+import * as p from "@clack/prompts";
+const SYMBOLS = {
+    ok: "✓",
+    warning: "⚠",
+    blocker: "✗",
+};
+/** Render one CheckGroup as a clack note. */
+export function renderGroup(group) {
+    if (group.lines.length === 0) {
+        p.note("(nothing to report)", group.title);
+        return;
+    }
+    const body = group.lines
+        .map((l) => {
+        const head = `${SYMBOLS[l.severity]} ${l.text}`;
+        return l.detail ? `${head}\n  ${l.detail}` : head;
+    })
+        .join("\n");
+    p.note(body, group.title);
+}
+export function tallyGroups(groups) {
+    const tally = { ok: 0, warning: 0, blocker: 0 };
+    for (const g of groups) {
+        for (const l of g.lines) {
+            tally[l.severity] += 1;
+        }
+    }
+    return tally;
+}
+export function summaryLine(tally) {
+    const parts = [];
+    if (tally.blocker > 0)
+        parts.push(`${tally.blocker} blocker(s)`);
+    if (tally.warning > 0)
+        parts.push(`${tally.warning} warning(s)`);
+    if (tally.ok > 0)
+        parts.push(`${tally.ok} ok`);
+    return parts.length === 0 ? "no checks ran" : parts.join(", ");
+}
+/** Render the "checks complete" outro line. Tally is appended in
+ *  parens so an operator skimming the trailing line of the report
+ *  immediately knows whether action is required. */
+export function renderOutro(tally, suggestion) {
+    const verdict = tally.blocker > 0
+        ? "Setup is incomplete"
+        : tally.warning > 0
+            ? "Setup is usable, with caveats"
+            : "Setup looks healthy";
+    const lines = [`${verdict} (${summaryLine(tally)}).`];
+    if (suggestion)
+        lines.push(suggestion);
+    p.outro(lines.join("\n"));
+}
+//# sourceMappingURL=render.js.map

package/packages/server/dist/setup/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/setup/render.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,EAAE;AACF,kEAAkE;AAClE,+DAA+D;AAC/D,mEAAmE;AACnE,qCAAqC;AAErC,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAkBpC,MAAM,OAAO,GAAkC;IAC7C,EAAE,EAAE,GAAG;IACP,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,GAAG;CACb,CAAC;AAEF,6CAA6C;AAC7C,MAAM,UAAU,WAAW,CAAC,KAAiB;IAC3C,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,CAAC,CAAC,IAAI,CAAC,qBAAqB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK;SACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,IAAI,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAChD,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACpD,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AASD,MAAM,UAAU,WAAW,CAAC,MAA6B;IACvD,MAAM,KAAK,GAAe,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAC5D,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;YACxB,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAiB;IAC3C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;IACjE,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;IACjE,IAAI,KAAK,CAAC,EAAE,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC;AAED;;oDAEoD;AACpD,MAAM,UAAU,WAAW,CAAC,KAAiB,EAAE,UAAmB;IAChE,MAAM,OAAO,GACX,KAAK,CAAC,OAAO,GAAG,CAAC;QACf,CAAC,CAAC,qBAAqB;QACvB,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC;YACjB,CAAC,CAAC,+BAA+B;YACjC,CAAC,CAAC,qBAAqB,CAAC;IAC9B,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,KAAK,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5B,CAAC"}

package/packages/server/dist/setup/repo-root.d.ts

@@ -0,0 +1,3 @@
+export declare function findRepoRoot(): string;
+export declare function isTianshuCheckout(repoRoot: string): boolean;
+//# sourceMappingURL=repo-root.d.ts.map

package/packages/server/dist/setup/repo-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-root.d.ts","sourceRoot":"","sources":["../../src/setup/repo-root.ts"],"names":[],"mappings":"AAoBA,wBAAgB,YAAY,IAAI,MAAM,CASrC;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAW3D"}

package/packages/server/dist/setup/repo-root.js

@@ -0,0 +1,43 @@
+// Resolve the tianshu checkout the CLI is running from.
+//
+// Users typically run `tianshu` from their home dir (or
+// anywhere — the `bin/tianshu.mjs` shim is global-installable),
+// so process.cwd() is rarely the repo. We walk *up* from this
+// module's filesystem location until we find a package.json
+// named '@tianshu-ai/tianshu'. That's the dir we treat as the
+// checkout root.
+//
+// Why this is a tiny module on its own:
+//   - start-server.ts (wizard install) needs it
+//   - service.ts (`tianshu start|stop|...`) needs it
+//   - both must agree, otherwise they'd derive different
+//     launchd labels and the wizard would install one agent
+//     while `tianshu start` operates on another.
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+export function findRepoRoot() {
+    let dir = path.dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 12; i++) {
+        if (isTianshuCheckout(dir))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return process.cwd();
+}
+export function isTianshuCheckout(repoRoot) {
+    const pkgPath = path.join(repoRoot, "package.json");
+    if (!fs.existsSync(pkgPath))
+        return false;
+    try {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+        return pkg.name === "@tianshu-ai/tianshu";
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=repo-root.js.map

package/packages/server/dist/setup/repo-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-root.js","sourceRoot":"","sources":["../../src/setup/repo-root.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,wDAAwD;AACxD,gEAAgE;AAChE,8DAA8D;AAC9D,4DAA4D;AAC5D,8DAA8D;AAC9D,iBAAiB;AACjB,EAAE;AACF,wCAAwC;AACxC,gDAAgD;AAChD,qDAAqD;AACrD,yDAAyD;AACzD,4DAA4D;AAC5D,iDAAiD;AAEjD,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,YAAY;IAC1B,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,iBAAiB,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IACpD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAEtD,CAAC;QACF,OAAO,GAAG,CAAC,IAAI,KAAK,qBAAqB,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/packages/server/dist/setup/service.d.ts

@@ -0,0 +1,60 @@
+interface ServiceCmdOpts {
+    /** Override repo root (used by tests). */
+    repoRoot?: string;
+    /** Wait for /api/health after start/restart. */
+    wait?: boolean;
+    /** Health-check deadline in ms. Default 60s. */
+    waitMs?: number;
+    /** When set, emit machine-readable JSON instead of human text. */
+    json?: boolean;
+}
+export interface LogsCmdOpts extends ServiceCmdOpts {
+    /** stream: follow new lines (`tail -f`) until Ctrl-C. */
+    follow?: boolean;
+    /** how many trailing lines to print up front. Default 50. */
+    lines?: number;
+    /** which stream(s) to read. Default "both" (interleaved by
+     *  modification — we just print err then out). */
+    stream?: "out" | "err" | "both";
+}
+/**
+ * `tianshu status` — print whether the service is installed,
+ * loaded, running, and responding to /api/health.
+ *
+ * Exit codes:
+ *   0 → installed AND loaded AND health OK
+ *   1 → installed but not loaded / not responding
+ *   2 → not installed
+ */
+export declare function runStatus(opts?: ServiceCmdOpts): Promise<number>;
+/**
+ * `tianshu start` — bootstrap the launchd agent.
+ * No-op (with friendly message) if already loaded.
+ */
+export declare function runStart(opts?: ServiceCmdOpts): Promise<number>;
+/**
+ * `tianshu stop` — bootout the launchd agent. Plist stays put;
+ * use the wizard's uninstall path (TODO) to fully remove.
+ */
+export declare function runStop(opts?: ServiceCmdOpts): Promise<number>;
+/**
+ * `tianshu restart` — `launchctl kickstart -k`. Faster than
+ * stop-then-start because it doesn't rebootstrap the plist.
+ */
+/**
+ * `tianshu logs` — print the launchd agent's stdout / stderr
+ * logs. Default: last 50 lines from both streams. With
+ * `--follow`, we exec `tail -f` so the user gets streaming
+ * output (and Ctrl-C falls through naturally).
+ *
+ * Why this command exists: when `tianshu start` says "Server
+ * didn't respond within 120s", the next thing both the user
+ * and a debugging agent want is the actual error from the
+ * failed boot. Without `tianshu logs`, you have to know the
+ * label *and* the convention that logs live in $TMPDIR. Now
+ * it's just `tianshu logs` (or `tianshu logs --follow`).
+ */
+export declare function runLogs(opts?: LogsCmdOpts): Promise<number>;
+export declare function runRestart(opts?: ServiceCmdOpts): Promise<number>;
+export {};
+//# sourceMappingURL=service.d.ts.map

package/packages/server/dist/setup/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/setup/service.ts"],"names":[],"mappings":"AAiCA,UAAU,cAAc;IACtB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;sDACkD;IAClD,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;CACjC;AAkCD;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,MAAM,CAAC,CAmEjB;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,MAAM,CAAC,CA4CjB;AA8BD;;;GAGG;AACH,wBAAsB,OAAO,CAAC,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBxE;AAED;;;GAGG;AACH;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsErE;AAWD,wBAAsB,UAAU,CAC9B,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,MAAM,CAAC,CAmCjB"}