faces-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Headwaters Lab Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+# faces-cli
+
+Command-line interface for the [Faces](https://faces.sh) platform.
+
+## Installation
+
+```bash
+npm install -g faces-cli
+```
+
+Requires Node.js ≥ 18.
+
+## Quick start
+
+```bash
+faces auth login
+faces face list
+faces chat chat myface -m "Hello"
+```
+
+## Commands
+
+```
+faces auth login / logout / register / whoami / refresh
+faces face create / list / get / update / delete / stats / upload
+faces chat chat / messages / responses
+faces compile doc create / list / get / prepare / sync / delete
+faces compile thread create / list / message / sync
+faces keys create / list / revoke / update
+faces billing balance / subscription / quota / usage / topup / checkout / card-setup / llm-costs
+faces account state
+faces config set / show / clear
+```
+
+Run `faces <command> --help` for details on any command.
+
+## Authentication
+
+Login stores a JWT at `~/.faces/config.json` (shared with the Python `faces-cli`).
+You can also authenticate via environment variables:
+
+```bash
+export FACES_API_KEY=your_api_key
+export FACES_TOKEN=your_jwt
+export FACES_BASE_URL=https://api.faces.sh   # optional override
+```
+
+## License
+
+MIT — Copyright (c) 2026 Headwaters Lab Inc.

package/bin/dev.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env -S node --loader ts-node/esm --no-warnings=ExperimentalWarning
+
+import {execute} from '@oclif/core'
+
+await execute({development: true, dir: import.meta.url})

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import {execute} from '@oclif/core'
+
+await execute({development: false, dir: import.meta.url})

package/dist/base.d.ts

@@ -0,0 +1,16 @@
+import { Command } from '@oclif/core';
+import { FacesClient } from './client.js';
+export declare abstract class BaseCommand extends Command {
+    static enableJsonFlag: boolean;
+    static baseFlags: {
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    protected makeClient(flags: {
+        'base-url'?: string;
+        token?: string;
+        'api-key'?: string;
+    }, _requireJwt?: boolean): FacesClient;
+    protected printHuman(data: unknown, indent?: number): void;
+}

package/dist/base.js

@@ -0,0 +1,53 @@
+import { Command, Flags } from '@oclif/core';
+import { FacesClient } from './client.js';
+import { resolveBaseUrl, resolveToken, resolveApiKey } from './config.js';
+export class BaseCommand extends Command {
+    static enableJsonFlag = true;
+    static baseFlags = {
+        'base-url': Flags.string({
+            description: 'API base URL',
+            env: 'FACES_BASE_URL',
+        }),
+        token: Flags.string({
+            description: 'JWT bearer token',
+            env: 'FACES_TOKEN',
+        }),
+        'api-key': Flags.string({
+            description: 'API key',
+            env: 'FACES_API_KEY',
+        }),
+    };
+    makeClient(flags, _requireJwt = false) {
+        const baseUrl = resolveBaseUrl(flags['base-url']);
+        const token = resolveToken(flags.token);
+        const apiKey = resolveApiKey(flags['api-key']);
+        return new FacesClient(baseUrl, token, apiKey);
+    }
+    printHuman(data, indent = 0) {
+        const prefix = '  '.repeat(indent);
+        if (Array.isArray(data)) {
+            if (data.length === 0) {
+                this.log(`${prefix}(empty)`);
+                return;
+            }
+            for (const [i, item] of data.entries()) {
+                this.log(`${prefix}[${i}]`);
+                this.printHuman(item, indent + 1);
+            }
+        }
+        else if (data !== null && typeof data === 'object') {
+            for (const [k, v] of Object.entries(data)) {
+                if (v !== null && typeof v === 'object') {
+                    this.log(`${prefix}${k}:`);
+                    this.printHuman(v, indent + 1);
+                }
+                else {
+                    this.log(`${prefix}${k}: ${v}`);
+                }
+            }
+        }
+        else {
+            this.log(`${prefix}${data}`);
+        }
+    }
+}

package/dist/client.d.ts

@@ -0,0 +1,36 @@
+export declare class FacesAPIError extends Error {
+    statusCode: number;
+    constructor(statusCode: number, message: string);
+}
+export declare class FacesClient {
+    private baseUrl;
+    private token?;
+    private apiKey?;
+    constructor(baseUrl: string, token?: string, apiKey?: string);
+    private url;
+    authHeader(requireJwt?: boolean): Record<string, string>;
+    private wrapNetworkError;
+    private parseError;
+    get(path: string, opts?: {
+        requireJwt?: boolean;
+        params?: Record<string, string>;
+    }): Promise<unknown>;
+    post(path: string, opts?: {
+        requireJwt?: boolean;
+        body?: unknown;
+    }): Promise<unknown>;
+    postNoAuth(path: string, body: unknown): Promise<unknown>;
+    patch(path: string, opts?: {
+        requireJwt?: boolean;
+        body?: unknown;
+    }): Promise<unknown>;
+    delete(path: string, opts?: {
+        requireJwt?: boolean;
+    }): Promise<unknown>;
+    postForm(path: string, formData: FormData, opts?: {
+        requireJwt?: boolean;
+    }): Promise<unknown>;
+    stream(path: string, body: unknown, opts?: {
+        requireJwt?: boolean;
+    }): AsyncGenerator<string>;
+}

package/dist/client.js

@@ -0,0 +1,191 @@
+export class FacesAPIError extends Error {
+    statusCode;
+    constructor(statusCode, message) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = 'FacesAPIError';
+    }
+}
+export class FacesClient {
+    baseUrl;
+    token;
+    apiKey;
+    constructor(baseUrl, token, apiKey) {
+        this.baseUrl = baseUrl.replace(/\/$/, '');
+        this.token = token;
+        this.apiKey = apiKey;
+    }
+    url(p) {
+        return `${this.baseUrl}${p}`;
+    }
+    authHeader(requireJwt = false) {
+        if (requireJwt) {
+            if (!this.token) {
+                process.stderr.write('Error: JWT login required. Run: faces auth login\n');
+                process.exit(1);
+            }
+            return { Authorization: `Bearer ${this.token}` };
+        }
+        if (this.token)
+            return { Authorization: `Bearer ${this.token}` };
+        if (this.apiKey)
+            return { Authorization: `Bearer ${this.apiKey}` };
+        process.stderr.write('Error: Authentication required. Run: faces auth login or set FACES_API_KEY\n');
+        process.exit(1);
+    }
+    wrapNetworkError(err, path) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new FacesAPIError(0, `Connection failed to ${this.baseUrl}${path}: ${msg}`);
+    }
+    async parseError(resp) {
+        let msg = resp.statusText;
+        try {
+            const body = await resp.json();
+            msg = String(body.detail ?? body.error ?? body.message ?? msg);
+        }
+        catch {
+            // use statusText
+        }
+        if (resp.status === 402)
+            msg = `Payment required: ${msg}`;
+        if (resp.status === 403)
+            msg = `Forbidden: ${msg}`;
+        return new FacesAPIError(resp.status, msg);
+    }
+    async get(path, opts = {}) {
+        let url = this.url(path);
+        if (opts.params && Object.keys(opts.params).length > 0) {
+            url += '?' + new URLSearchParams(opts.params).toString();
+        }
+        let resp;
+        try {
+            resp = await fetch(url, { headers: { ...this.authHeader(opts.requireJwt) } });
+        }
+        catch (err) {
+            this.wrapNetworkError(err, path);
+        }
+        if (!resp.ok)
+            throw await this.parseError(resp);
+        return resp.json();
+    }
+    async post(path, opts = {}) {
+        let resp;
+        try {
+            resp = await fetch(this.url(path), {
+                method: 'POST',
+                headers: { ...this.authHeader(opts.requireJwt), 'Content-Type': 'application/json' },
+                body: opts.body !== undefined ? JSON.stringify(opts.body) : undefined,
+            });
+        }
+        catch (err) {
+            this.wrapNetworkError(err, path);
+        }
+        if (!resp.ok)
+            throw await this.parseError(resp);
+        return resp.json();
+    }
+    async postNoAuth(path, body) {
+        let resp;
+        try {
+            resp = await fetch(this.url(path), {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(body),
+            });
+        }
+        catch (err) {
+            this.wrapNetworkError(err, path);
+        }
+        if (!resp.ok)
+            throw await this.parseError(resp);
+        return resp.json();
+    }
+    async patch(path, opts = {}) {
+        let resp;
+        try {
+            resp = await fetch(this.url(path), {
+                method: 'PATCH',
+                headers: { ...this.authHeader(opts.requireJwt), 'Content-Type': 'application/json' },
+                body: opts.body !== undefined ? JSON.stringify(opts.body) : undefined,
+            });
+        }
+        catch (err) {
+            this.wrapNetworkError(err, path);
+        }
+        if (!resp.ok)
+            throw await this.parseError(resp);
+        return resp.json();
+    }
+    async delete(path, opts = {}) {
+        let resp;
+        try {
+            resp = await fetch(this.url(path), {
+                method: 'DELETE',
+                headers: { ...this.authHeader(opts.requireJwt) },
+            });
+        }
+        catch (err) {
+            this.wrapNetworkError(err, path);
+        }
+        if (!resp.ok)
+            throw await this.parseError(resp);
+        // DELETE may return 204 with no body
+        const text = await resp.text();
+        if (!text)
+            return {};
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return {};
+        }
+    }
+    async postForm(path, formData, opts = {}) {
+        let resp;
+        try {
+            resp = await fetch(this.url(path), {
+                method: 'POST',
+                headers: { ...this.authHeader(opts.requireJwt) },
+                body: formData,
+            });
+        }
+        catch (err) {
+            this.wrapNetworkError(err, path);
+        }
+        if (!resp.ok)
+            throw await this.parseError(resp);
+        return resp.json();
+    }
+    async *stream(path, body, opts = {}) {
+        let resp;
+        try {
+            resp = await fetch(this.url(path), {
+                method: 'POST',
+                headers: { ...this.authHeader(opts.requireJwt), 'Content-Type': 'application/json' },
+                body: JSON.stringify(body),
+            });
+        }
+        catch (err) {
+            this.wrapNetworkError(err, path);
+        }
+        if (!resp.ok || !resp.body) {
+            throw await this.parseError(resp);
+        }
+        const reader = resp.body.getReader();
+        const dec = new TextDecoder();
+        let buf = '';
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buf += dec.decode(value, { stream: true });
+            const lines = buf.split('\n');
+            buf = lines.pop() ?? '';
+            for (const line of lines)
+                if (line.trim())
+                    yield line;
+        }
+        if (buf.trim())
+            yield buf;
+    }
+}

package/dist/commands/account/state.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../base.js';
+export default class AccountState extends BaseCommand {
+    static description: string;
+    static flags: {
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/account/state.js

@@ -0,0 +1,24 @@
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class AccountState extends BaseCommand {
+    static description = 'Full account routing state (plan, balance, onboarding)';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(AccountState);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.get('/v1/account/state');
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

package/dist/commands/auth/login.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base.js';
+export default class AuthLogin extends BaseCommand {
+    static description: string;
+    static flags: {
+        email: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        password: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/auth/login.js

@@ -0,0 +1,40 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+import { saveConfig, resolveBaseUrl } from '../../config.js';
+export default class AuthLogin extends BaseCommand {
+    static description = 'Login and save JWT credentials';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        email: Flags.string({ description: 'Account email', required: true }),
+        password: Flags.string({ description: 'Account password', required: true }),
+    };
+    async run() {
+        const { flags } = await this.parse(AuthLogin);
+        const baseUrl = resolveBaseUrl(flags['base-url']);
+        const { FacesClient } = await import('../../client.js');
+        const client = new FacesClient(baseUrl);
+        let data;
+        try {
+            data = (await client.postNoAuth('/v1/auth/login', {
+                email: flags.email,
+                password: flags.password,
+            }));
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError) {
+                this.error(`Login failed (${err.statusCode}): ${err.message}`);
+            }
+            throw err;
+        }
+        const token = (data.access_token ?? data.token);
+        const userId = data.user_id ?? data.id ?? data.user?.id;
+        if (!token)
+            this.error(`Unexpected response: ${JSON.stringify(data)}`);
+        saveConfig({ token, user_id: userId ? String(userId) : undefined });
+        const result = { status: 'logged_in', user_id: userId };
+        if (!this.jsonEnabled())
+            this.printHuman(result);
+        return result;
+    }
+}

package/dist/commands/auth/logout.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../base.js';
+export default class AuthLogout extends BaseCommand {
+    static description: string;
+    static flags: {
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/auth/logout.js

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../base.js';
+import { clearConfig } from '../../config.js';
+export default class AuthLogout extends BaseCommand {
+    static description = 'Clear saved credentials';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        await this.parse(AuthLogout);
+        clearConfig();
+        this.log('Logged out. Credentials cleared.');
+        return { status: 'logged_out' };
+    }
+}

package/dist/commands/auth/refresh.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../base.js';
+export default class AuthRefresh extends BaseCommand {
+    static description: string;
+    static flags: {
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/auth/refresh.js

@@ -0,0 +1,30 @@
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+import { saveConfig } from '../../config.js';
+export default class AuthRefresh extends BaseCommand {
+    static description = 'Exchange current JWT for a fresh one';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(AuthRefresh);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = (await client.post('/v1/auth/refresh', { requireJwt: true }));
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Refresh failed (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        const token = (data.access_token ?? data.token);
+        if (token) {
+            saveConfig({ token });
+            this.log('Token refreshed and saved.');
+        }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

package/dist/commands/auth/register.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../base.js';
+export default class AuthRegister extends BaseCommand {
+    static description: string;
+    static flags: {
+        email: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        password: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        username: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'invite-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/auth/register.js

@@ -0,0 +1,45 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+import { saveConfig, resolveBaseUrl } from '../../config.js';
+export default class AuthRegister extends BaseCommand {
+    static description = 'Create a new Faces account';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        email: Flags.string({ description: 'Email address', required: true }),
+        password: Flags.string({ description: 'Password', required: true }),
+        name: Flags.string({ description: 'Display name', required: true }),
+        username: Flags.string({ description: 'Username (lowercase, dashes, numbers)', required: true }),
+        'invite-key': Flags.string({ description: 'Invite key (if required)' }),
+    };
+    async run() {
+        const { flags } = await this.parse(AuthRegister);
+        const baseUrl = resolveBaseUrl(flags['base-url']);
+        const { FacesClient } = await import('../../client.js');
+        const client = new FacesClient(baseUrl);
+        const payload = {
+            email: flags.email,
+            password: flags.password,
+            name: flags.name,
+            username: flags.username,
+        };
+        if (flags['invite-key'])
+            payload.invite_key = flags['invite-key'];
+        let data;
+        try {
+            data = (await client.postNoAuth('/v1/auth/register', payload));
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError) {
+                this.error(`Registration failed (${err.statusCode}): ${err.message}`);
+            }
+            throw err;
+        }
+        const token = (data.access_token ?? data.token);
+        if (token)
+            saveConfig({ token });
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

package/dist/commands/auth/whoami.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../base.js';
+export default class AuthWhoami extends BaseCommand {
+    static description: string;
+    static flags: {
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/auth/whoami.js

@@ -0,0 +1,24 @@
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class AuthWhoami extends BaseCommand {
+    static description = 'Print current user profile';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(AuthWhoami);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.get('/v1/auth/me', { requireJwt: true });
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

package/dist/commands/billing/balance.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../base.js';
+export default class BillingBalance extends BaseCommand {
+    static description: string;
+    static flags: {
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}