@softacus-software/elwis-docs-mcp 0.1.1 → 0.2.0

package/README.md

@@ -1,39 +1,118 @@
 # @softacus-software/elwis-docs-mcp
 
-A read-only [Model Context Protocol](https://modelcontextprotocol.io) server that teaches your chat client the ELWIS REST API. Ask about endpoints, parameters, schemas, and examples in plain words. Everything is generated from the OpenAPI specification, so the answers cannot disagree with the documented API.
-
-It serves knowledge about the API only. It never connects to a live ELWIS and cannot read or write any data.
+A read-only [Model Context Protocol](https://modelcontextprotocol.io) server for ELWIS. It teaches your chat client the ELWIS REST API and lets it read your live ELWIS data: applications, folders, types, attributes, records, links, and pages. It can never create, change, or delete anything. There are no write tools inside at all.
 
 ```
-+-------------------+        +---------------------+        +-------------+
-|  Your chat client |  <-->  |  elwis-docs-mcp     |  <---  |  OpenAPI    |
-|  (Claude Desktop, |        |  (this server,      |        |  spec       |
-|  Codex, Gemini)   |        |  runs on your       |        |  (bundled)  |
-|                   |        |  computer)          |        |             |
-+-------------------+        +---------------------+        +-------------+
++-------------------+        +---------------------+        +-----------+
+|  Your chat client |  <-->  |  elwis-docs-mcp     |  <-->  |  ELWIS    |
+|  (Claude Desktop, |        |  (this server,      |        |  (reads   |
+|  Codex, Gemini)   |        |  runs on your       |        |  only)    |
+|                   |        |  computer)          |        |           |
++-------------------+        +---------------------+        +-----------+
 ```
 
-## Set up in three minutes
+## Set up in five minutes
+
+You need three things before you start:
+
+- your ELWIS domain (copy it from your browser)
+- your own ELWIS email and password (the same ones you use to sign in)
+- an npm account invited to the softacus organization (ask your administrator)
 
 ### Step 1. Install Node.js (one time)
 
-Go to [nodejs.org](https://nodejs.org), download the LTS installer, run it, accept the defaults. Check it in a terminal:
+Go to [nodejs.org](https://nodejs.org), download the LTS installer, run it, accept the defaults.
+
+Check it worked. Open a terminal (macOS: the Terminal app, Windows: PowerShell) and type:
 
 ```bash
 node --version
 ```
 
+You should see a version number like `v22.x.x`.
+
 ### Step 2. Sign in to npm (one time)
 
-The package is private to the Softacus team. Ask your administrator to invite you to the softacus organization on npmjs.com (you need a free npm account), then run:
+The package is private to the Softacus team. Create a free account at npmjs.com if you do not have one, ask your administrator to invite it to the softacus organization, then run:
 
 ```bash
 npm login
 ```
 
-A browser window opens; sign in with your npm account and return to the terminal.
+A browser window opens; sign in and return to the terminal.
+
+### Step 3. Run the setup and answer its questions
+
+```bash
+npx -y @softacus-software/elwis-docs-mcp@latest setup
+```
+
+It asks, in order:
+
+1. Your ELWIS domain, like elwis.your-company.com. Copy it from your browser.
+2. Your email and password. The password is never shown while you type and never stored. Only the resulting session stays, on this computer only.
+3. Which client do you use? It writes the configuration for Claude Desktop, Codex, or Gemini by itself and backs up anything it touches.
+
+### Step 4. Check it works
+
+Fully quit your chat client (on a Mac press Cmd+Q, closing the window is not enough), open it again, and ask:
+
+```
+Are you connected to ELWIS?
+```
+
+It should answer with your name and your tenant. Done.
+
+## What to ask
+
+About your live data (it sees what your account sees, and only reads):
+
+```
+List the applications I can see in ELWIS.
+Show me the records of type Product.
+What attributes does the Task artifact type have?
+Show me the links of this artifact.
+```
+
+About the API itself:
+
+```
+Which ELWIS endpoint creates an attribute?
+What fields does the artifact type update request take?
+Show me an example request for creating a link type.
+```
+
+You stay signed in about as long as a normal ELWIS browser login (around two weeks) and the session refreshes itself while you use it. When it runs out, sign in again:
+
+```bash
+npx -y @softacus-software/elwis-docs-mcp@latest login
+```
+
+To sign out on this computer:
+
+```bash
+npx -y @softacus-software/elwis-docs-mcp@latest logout
+```
+
+If anything fails, send your administrator the exact text of the error.
+
+## Updating
+
+New versions install themselves. The configuration written by the setup points at the latest release, so every time you fully quit and reopen your chat client you are on the newest version. There is nothing to run.
+
+Installed before this behaviour existed, or wrote the configuration by hand? Run the setup once more and restart your client:
+
+```bash
+npx -y @softacus-software/elwis-docs-mcp@latest setup
+```
+
+Your saved sign-in stays, the setup only rewrites the client configuration.
 
-### Step 3. Add the server to your client
+## For administrators
+
+### Manual client configuration
+
+The setup wizard writes these for you; use the blocks below only if you prefer to do it by hand. Without any `env` at all the server still works, it then answers questions about the API only and never contacts a live system.
 
 Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS, `%APPDATA%\Claude\claude_desktop_config.json` on Windows) and Claude Code (`.mcp.json` in the project root, same shape):
 
@@ -42,7 +121,12 @@ Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json
   "mcpServers": {
     "elwis-docs": {
       "command": "npx",
-      "args": ["-y", "@softacus-software/elwis-docs-mcp"]
+      "args": ["-y", "@softacus-software/elwis-docs-mcp@latest"],
+      "env": {
+        "ELWIS_API_URL": "https://<your-elwis-host>",
+        "ELWIS_TENANT": "<24-char tenant id>",
+        "ELWIS_ALLOWED_APPS": "<AppName1,AppName2>"
+      }
     }
   }
 }
@@ -53,47 +137,42 @@ Codex (`~/.codex/config.toml`):
 ```toml
 [mcp_servers.elwis-docs]
 command = "npx"
-args = ["-y", "@softacus-software/elwis-docs-mcp"]
+args = ["-y", "@softacus-software/elwis-docs-mcp@latest"]
+
+[mcp_servers.elwis-docs.env]
+ELWIS_API_URL = "https://<your-elwis-host>"
+ELWIS_TENANT = "<24-char tenant id>"
+ELWIS_ALLOWED_APPS = "<AppName1,AppName2>"
 ```
 
 Gemini CLI (`~/.gemini/settings.json`): same JSON shape as Claude Desktop.
 
-No ELWIS address, no ELWIS login. There is nothing else to configure because it never talks to a live system.
-
-### Step 4. Check it works
+Any other MCP client: register a STDIO server with `command: "npx"`, `args: ["-y", "@softacus-software/elwis-docs-mcp@latest"]` and the same `env`. After connecting, call `explain_elwis_access` to verify identity and tenant.
 
-Fully quit your client (on a Mac press Cmd+Q), open it again, and ask:
+### Configuration
 
-```
-Which ELWIS endpoint creates an attribute?
-```
+| Variable | Required | What it does |
+|---|---|---|
+| `ELWIS_API_URL` | for live reads | Domain of the ELWIS backend, e.g. `https://your-elwis-host`. Without it only the API documentation tools are available. |
+| `ELWIS_TENANT` | for live reads | The 24-character tenant id this connection is locked to. The wizard fills it automatically, `explain_elwis_access` shows it. |
+| `ELWIS_SESSION_JWT` | no | Long-lived access token for automation. When omitted, the saved login from the setup or `login` command is used and refreshed automatically. |
+| `ELWIS_ALLOWED_APPS` | no | Comma-separated application allowlist (names or ids). Everything outside the list is rejected before touching the backend. Default: all applications the user can access. |
 
-You should get the exact endpoint with its method, parameters, and a worked example.
-
-## What to ask
-
-```
-How do I create an application through the ELWIS API?
-What fields does the artifact type update request take?
-Show me an example request for creating a link type.
-What does the data type schema look like?
-```
+The reads run as the signed-in user, so ELWIS access control applies as usual: the server sees exactly what that account sees. For the narrowest possible connection, sign in with a dedicated restricted user and set `ELWIS_ALLOWED_APPS`.
 
 ## Tools
 
-| Tool | What it does |
-|---|---|
-| `search_elwis_api` | Find endpoints by intent, like "create an attribute" |
-| `list_elwis_api_groups` | Browse the API area by area |
-| `get_elwis_endpoint` | Full detail of one endpoint: method, path, parameters, schemas |
-| `get_elwis_schema` | One request or response schema, depth-bounded |
-| `get_elwis_examples` | Verified worked examples for an endpoint |
+| Group | Tools | What they do |
+|---|---|---|
+| Check | `explain_elwis_access` | Who am I, which tenant, what is visible. Call this first. |
+| Live reads | `list_elwis_apps`, `list_elwis_entities`, `resolve_elwis_entity`, `get_elwis_entity`, `list_elwis_artifacts`, `get_elwis_artifact`, `list_elwis_artifact_links`, `get_elwis_page` | Browse applications, configuration, records, links, and pages of a live ELWIS. |
+| API documentation | `search_elwis_api`, `list_elwis_api_groups`, `get_elwis_endpoint`, `get_elwis_schema`, `get_elwis_examples` | Endpoints, parameters, schemas, and worked examples, generated from the OpenAPI specification. |
 
-Every response is size-bounded (typically 1 to 6 KB), so it stays friendly to the client's context. Unknown names return clean errors with near-miss suggestions instead of guesses.
+There are no write tools. The HTTP layer of this package cannot even send an update or delete request.
 
-## Keeping it up to date
+## Keeping the API data up to date
 
-The data is generated deterministically from the ELWIS OpenAPI spec:
+The documentation data is generated deterministically from the ELWIS OpenAPI spec:
 
 ```bash
 npm run export-spec   # fetch the current spec from a running ELWIS

package/dist/app-scope.js

@@ -0,0 +1,92 @@
+import { IsObjectId } from './resolve.js';
+export class AppScopeError extends Error {
+    constructor(ref) {
+        super(`Application "${ref}" is outside the MCP application allowlist (ELWIS_ALLOWED_APPS)`);
+        this.name = 'AppScopeError';
+    }
+}
+export function FilterApplicationId(filter) {
+    const value = filter.applicationId;
+    if (typeof value === 'string')
+        return value;
+    if (value && typeof value === 'object' && typeof value.$oid === 'string')
+        return value.$oid;
+    return undefined;
+}
+export class TenantMismatchError extends Error {
+    constructor(expected, actual) {
+        super(`No data was read or written. This connection is locked to tenant ${expected}, but the access token belongs to a different tenant (${actual ?? 'unknown'}). The saved connection settings are stale or mixed up. Re-run the setup, or fix ELWIS_TENANT if you configured it by hand.`);
+        this.name = 'TenantMismatchError';
+    }
+}
+export class NoTenantError extends Error {
+    constructor() {
+        super('No tenant is set, so I do not know which ELWIS environment to work in, and ELWIS has many (dev, pre-prod, prod). Set ELWIS_TENANT to the tenant you mean before reading or changing anything. Run explain_elwis_access to see the tenant id this connection\'s login belongs to, or re-run the setup wizard, which fills it in for you.');
+        this.name = 'NoTenantError';
+    }
+}
+export class AppScope {
+    api;
+    entries;
+    expectedTenant;
+    ids = null;
+    tenantVerified = false;
+    cachedIdentity = null;
+    constructor(api, entries, expectedTenant) {
+        this.api = api;
+        this.entries = entries;
+        this.expectedTenant = expectedTenant;
+    }
+    identity() {
+        this.cachedIdentity = this.cachedIdentity ?? this.api.whoAmI().catch(() => null);
+        return this.cachedIdentity;
+    }
+    async assertTenant() {
+        if (!this.expectedTenant || this.tenantVerified)
+            return;
+        const identity = await this.identity();
+        if (identity?.tenantId !== this.expectedTenant)
+            throw new TenantMismatchError(this.expectedTenant, identity?.tenantId ?? null);
+        this.tenantVerified = true;
+    }
+    get restricted() {
+        return this.entries.length > 0;
+    }
+    describe() {
+        return { restricted: this.restricted, entries: [...this.entries] };
+    }
+    async allowedIds() {
+        if (!this.restricted)
+            return null;
+        if (this.ids)
+            return this.ids;
+        const ids = new Set();
+        for (const entry of this.entries) {
+            if (IsObjectId(entry)) {
+                ids.add(entry);
+                continue;
+            }
+            const rows = await this.api.list('application', { name: entry });
+            for (const row of rows)
+                ids.add(row.id);
+        }
+        this.ids = ids;
+        return ids;
+    }
+    async assertAllowed(applicationId) {
+        await this.assertTenant();
+        const ids = await this.allowedIds();
+        if (ids && !ids.has(applicationId))
+            throw new AppScopeError(applicationId);
+    }
+    async assertListAllowed(kind, filter) {
+        await this.assertTenant();
+        if (!this.restricted || kind === 'application')
+            return;
+        const applicationId = FilterApplicationId(filter);
+        if (!applicationId)
+            throw new AppScopeError('unspecified, when ELWIS_ALLOWED_APPS is set, list calls require an applicationId filter');
+        await this.assertAllowed(applicationId);
+    }
+}
+//# sourceMappingURL=app-scope.js.map

package/dist/app-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-scope.js","sourceRoot":"","sources":["../src/app-scope.ts"],"names":[],"mappings":"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"}

package/dist/artifact-read.js

@@ -0,0 +1,114 @@
+import { AmbiguityError, IsObjectId } from './resolve.js';
+const VALUE_CHAR_LIMIT = 4000;
+const ARRAY_ELEMENT_LIMIT = 50;
+const MAP_FETCH_LIMIT = 500;
+export async function LoadAttributeMap(api, applicationId) {
+    const rows = await api.list('attribute', { applicationId: { $oid: applicationId } }, MAP_FETCH_LIMIT + 1);
+    if (rows.length > MAP_FETCH_LIMIT)
+        throw new Error(`The application has more than ${MAP_FETCH_LIMIT} attributes; pass explicit attribute ids instead of names`);
+    const byId = new Map();
+    const byName = new Map();
+    for (const r of rows) {
+        byId.set(r.id, r.name);
+        const key = r.name.toLowerCase();
+        byName.set(key, [...(byName.get(key) ?? []), { id: r.id, name: r.name }]);
+    }
+    return { byId, byName };
+}
+export function ResolveAttributeId(map, ref) {
+    if (IsObjectId(ref))
+        return ref;
+    const matches = map.byName.get(ref.toLowerCase()) ?? [];
+    if (matches.length === 1)
+        return matches[0].id;
+    if (matches.length === 0)
+        throw new Error(`No attribute named "${ref}" in the application`);
+    throw new AmbiguityError(`Multiple attributes named "${ref}"; pass an explicit id`, matches);
+}
+export async function ResolveUnknownAttributeNames(api, map, ids) {
+    const unknown = [...new Set(ids)].filter(id => !map.byId.has(id));
+    await Promise.all(unknown.map(async (id) => {
+        try {
+            const doc = await api.getOne('attribute', id);
+            map.byId.set(id, doc.name);
+        }
+        catch {
+            map.byId.set(id, id);
+        }
+    }));
+}
+const WHERE_OPS = {
+    equals: (v) => v,
+    contains: (v) => ({ $regex: EscapeRegex(String(v)), $options: 'i' }),
+    gt: (v) => ({ $gt: v }),
+    gte: (v) => ({ $gte: v }),
+    lt: (v) => ({ $lt: v }),
+    lte: (v) => ({ $lte: v }),
+    in: (v) => ({ $in: Array.isArray(v) ? v : [v] }),
+};
+export function EscapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+export function BuildWhereClauses(map, where) {
+    return where.map(clause => {
+        const attrId = ResolveAttributeId(map, clause.attribute);
+        return { [`attributes.${attrId}.value`]: WHERE_OPS[clause.op ?? 'equals'](clause.value) };
+    });
+}
+export function TruncateValue(value) {
+    if (typeof value === 'string' && value.length > VALUE_CHAR_LIMIT) {
+        return `${value.slice(0, VALUE_CHAR_LIMIT)}…[truncated ${value.length - VALUE_CHAR_LIMIT} chars]`;
+    }
+    if (Array.isArray(value)) {
+        const head = value.slice(0, ARRAY_ELEMENT_LIMIT).map(TruncateValue);
+        if (value.length > ARRAY_ELEMENT_LIMIT)
+            head.push(`…[+${value.length - ARRAY_ELEMENT_LIMIT} more]`);
+        return head;
+    }
+    return value;
+}
+export function SummarizeArtifact(artifact, nameAttributeId) {
+    return {
+        id: artifact.id,
+        name: TruncateValue(artifact.attributes?.[nameAttributeId]?.value ?? null),
+        artifactTypeId: artifact.artifactTypeId,
+        format: artifact.format,
+        folderPath: artifact.folderData?.path,
+        created: artifact.created?.on,
+        updated: artifact.updated?.on,
+    };
+}
+export function TranslateArtifact(artifact, map) {
+    const values = {};
+    const unmappedValuesById = {};
+    const nameCollisions = [];
+    for (const [attrId, entry] of Object.entries(artifact.attributes ?? {})) {
+        const value = TruncateValue(entry?.value ?? null);
+        const name = map.byId.get(attrId);
+        if (name !== undefined && !Object.hasOwn(values, name))
+            values[name] = value;
+        else if (name !== undefined) {
+            nameCollisions.push(name);
+            unmappedValuesById[attrId] = value;
+        }
+        else {
+            unmappedValuesById[attrId] = value;
+        }
+    }
+    return {
+        id: artifact.id,
+        artifactTypeId: artifact.artifactTypeId,
+        format: artifact.format,
+        folderPath: artifact.folderData?.path,
+        folderId: artifact.folderData?.folderId ?? artifact.folderData?.id,
+        values,
+        ...(Object.keys(unmappedValuesById).length ? { unmappedValuesById } : {}),
+        ...(nameCollisions.length ? { nameCollisions } : {}),
+        created: artifact.created?.on,
+        updated: artifact.updated?.on,
+    };
+}
+export function PageMeta(meta, returned) {
+    return { total: meta.totalCount, returned, skip: meta.skip, hasMore: meta.skip + returned < meta.totalCount };
+}
+//# sourceMappingURL=artifact-read.js.map

package/dist/artifact-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-read.js","sourceRoot":"","sources":["../src/artifact-read.ts"],"names":[],"mappings":"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"}

package/dist/cli/client-configs.js

@@ -0,0 +1,86 @@
+import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir, platform } from 'node:os';
+import { dirname, join } from 'node:path';
+export function BuildEnv(choices) {
+    const env = { ELWIS_API_URL: choices.host };
+    if (choices.tenantId)
+        env.ELWIS_TENANT = choices.tenantId;
+    if (choices.allowedApps.length)
+        env.ELWIS_ALLOWED_APPS = choices.allowedApps.join(',');
+    return env;
+}
+export function ServerCommand() {
+    const self = process.argv[1] ?? '';
+    if (self.endsWith(join('dist', 'index.js')))
+        return { command: process.execPath, args: [self] };
+    return { command: 'npx', args: ['-y', '@softacus-software/elwis-docs-mcp@latest'] };
+}
+export function UpsertJsonClientConfig(text, entry) {
+    let root;
+    try {
+        root = text ? JSON.parse(text) : {};
+    }
+    catch {
+        throw new Error('the existing configuration file is not valid JSON; fix or remove it first');
+    }
+    if (typeof root !== 'object' || root === null || Array.isArray(root))
+        throw new Error('the existing configuration file has an unexpected shape');
+    if (root.mcpServers !== undefined && (typeof root.mcpServers !== 'object' || root.mcpServers === null || Array.isArray(root.mcpServers))) {
+        throw new Error('the existing configuration file has an unexpected mcpServers shape');
+    }
+    root.mcpServers = { ...(root.mcpServers ?? {}), 'elwis-docs': entry };
+    return `${JSON.stringify(root, null, 2)}\n`;
+}
+const OUR_TOML_HEADERS = new Set(['[mcp_servers.elwis-docs]', '[mcp_servers.elwis-docs.env]']);
+export function UpsertCodexToml(text, entry) {
+    const kept = [];
+    let skipping = false;
+    for (const rawLine of (text ?? '').split(/\r?\n/)) {
+        const trimmed = rawLine.trim();
+        if (OUR_TOML_HEADERS.has(trimmed)) {
+            skipping = true;
+            continue;
+        }
+        if (skipping && /^\s*\[/.test(rawLine))
+            skipping = false;
+        if (!skipping)
+            kept.push(rawLine);
+    }
+    const base = kept.join('\n').replace(/\n{3,}/g, '\n\n').trimEnd();
+    const block = [
+        '[mcp_servers.elwis-docs]',
+        `command = ${JSON.stringify(entry.command)}`,
+        `args = [${entry.args.map(a => JSON.stringify(a)).join(', ')}]`,
+        '',
+        '[mcp_servers.elwis-docs.env]',
+        ...Object.entries(entry.env).map(([k, v]) => `${k} = ${JSON.stringify(v)}`),
+        '',
+    ].join('\n');
+    return base.length ? `${base}\n\n${block}` : block;
+}
+export function DetectClients(home = homedir()) {
+    const claudeDesktopPath = platform() === 'win32'
+        ? join(process.env.APPDATA ?? join(home, 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json')
+        : join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+    const targets = [
+        { id: 'claude-desktop', label: 'Claude Desktop', path: claudeDesktopPath, format: 'json', exists: false },
+        { id: 'codex', label: 'Codex', path: join(home, '.codex', 'config.toml'), format: 'toml', exists: false },
+        { id: 'gemini', label: 'Gemini CLI', path: join(home, '.gemini', 'settings.json'), format: 'json', exists: false },
+    ];
+    for (const target of targets)
+        target.exists = existsSync(target.path) || existsSync(dirname(target.path));
+    return targets;
+}
+export function WriteClientConfig(target, entry) {
+    const current = existsSync(target.path) ? readFileSync(target.path, 'utf8') : null;
+    let backup = null;
+    if (current !== null) {
+        backup = `${target.path}.backup-${new Date().toISOString().replace(/[:.]/g, '-')}`;
+        copyFileSync(target.path, backup);
+    }
+    const next = target.format === 'json' ? UpsertJsonClientConfig(current, entry) : UpsertCodexToml(current, entry);
+    mkdirSync(dirname(target.path), { recursive: true });
+    writeFileSync(target.path, next);
+    return { path: target.path, backup };
+}
+//# sourceMappingURL=client-configs.js.map

package/dist/cli/client-configs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-configs.js","sourceRoot":"","sources":["../../src/cli/client-configs.ts"],"names":[],"mappings":"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"}

package/dist/cli/login.js

@@ -0,0 +1,64 @@
+import { stdout } from 'node:process';
+import { CookieToken } from '../http-client.js';
+import { SaveSession } from '../session-store.js';
+import { Prompter } from './prompter.js';
+export function NormalizeHost(raw) {
+    let host = raw.trim().replace(/\/+$/, '');
+    if (!/^https?:\/\//.test(host)) {
+        const local = /^(localhost|127\.0\.0\.1)([:/]|$)/.test(host);
+        host = `${local ? 'http' : 'https'}://${host}`;
+    }
+    try {
+        return new URL(host).origin.toLowerCase();
+    }
+    catch {
+        return host.toLowerCase();
+    }
+}
+export async function PerformLogin(host, email, password) {
+    const response = await fetch(`${host}/api/auth/login`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', Origin: host },
+        body: JSON.stringify({ email, password }),
+    });
+    const token = CookieToken(response.headers.getSetCookie());
+    if (!response.ok || !token) {
+        throw new Error(response.status === 401 || response.status === 400
+            ? 'Sign-in failed, the email or password is not right. Try again.'
+            : `Sign-in failed, ELWIS answered with status ${response.status}. Check the domain and try again.`);
+    }
+    const info = await fetch(`${host}/api/tenant/user/info`, { headers: { Origin: host, Cookie: `session-jwt=${token}` } });
+    const parsed = info.ok ? (await info.json()) : {};
+    const user = parsed.sessionUser;
+    return { host, token, tenantId: user?.tenant?.id ?? null, email: user?.email ?? email };
+}
+export async function LoginFlow(prompter, hostArg) {
+    const host = NormalizeHost(hostArg ?? (await prompter.ask('What is your ELWIS domain? (like elwis.your-company.com): ')));
+    const email = (await prompter.ask('Your ELWIS email: ')).trim();
+    const password = await prompter.askHidden('Your ELWIS password (not shown while typing): ');
+    const result = await PerformLogin(host, email, password);
+    const record = {
+        host: result.host,
+        token: result.token,
+        tenantId: result.tenantId,
+        email: result.email,
+        updatedAt: new Date().toISOString(),
+    };
+    SaveSession(record);
+    return result;
+}
+export async function RunLogin(hostArg) {
+    const prompter = new Prompter();
+    try {
+        if (process.env.ELWIS_SESSION_JWT) {
+            process.stderr.write('Note: ELWIS_SESSION_JWT is set in this environment and takes priority over saved logins, the server will keep using that token until it is removed.\n');
+        }
+        const result = await LoginFlow(prompter, hostArg);
+        stdout.write(`\nSigned in as ${result.email}${result.tenantId ? ` (tenant ${result.tenantId})` : ''}.\n`);
+        stdout.write("You'll stay signed in about as long as a normal ELWIS browser login (typically two weeks). When it runs out, just sign in again.\n");
+    }
+    finally {
+        prompter.close();
+    }
+}
+//# sourceMappingURL=login.js.map

package/dist/cli/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/cli/login.ts"],"names":[],"mappings":"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"}