@brass-build/cli 0.1.0

package/dist/args.js.map

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

package/dist/auth.d.ts

@@ -0,0 +1,5 @@
+export interface AuthProvider {
+    headers(): Promise<Record<string, string>>;
+}
+export declare function serviceTokenAuth(token: string): AuthProvider;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC5C;AAGD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAI5D"}

package/dist/auth.js

@@ -0,0 +1,12 @@
+// How a command authenticates each request. Two kinds resolve to the same
+// interface so `BrassApi` is agnostic: a service token is a static bearer;
+// a login session refreshes a short-lived access token on demand (see
+// `sessionAuth` in session.ts). The provider returns the exact headers to
+// merge onto a data-API request.
+// A service token (`brass_sk_...`) is presented verbatim as the bearer.
+export function serviceTokenAuth(token) {
+    return {
+        headers: () => Promise.resolve({ authorization: `Bearer ${token}` }),
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,2EAA2E;AAC3E,sEAAsE;AACtE,0EAA0E;AAC1E,iCAAiC;AAMjC,wEAAwE;AACxE,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,CAAC;KACrE,CAAC;AACJ,CAAC"}

package/dist/bin/brass.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=brass.d.ts.map

package/dist/bin/brass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brass.d.ts","sourceRoot":"","sources":["../../src/bin/brass.ts"],"names":[],"mappings":""}

package/dist/bin/brass.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { run } from '../cli.js';
+run(process.argv.slice(2))
+    .then((code) => {
+    process.exitCode = code;
+})
+    .catch((err) => {
+    process.stderr.write(`error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=brass.js.map

package/dist/bin/brass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brass.js","sourceRoot":"","sources":["../../src/bin/brass.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KACvB,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;IACb,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+import { VERSION } from './version.js';
+export { VERSION };
+export declare function run(argv: readonly string[]): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAoCA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,OAAO,EAAE,CAAC;AA2CnB,wBAAsB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA0DlE"}

package/dist/cli.js

@@ -0,0 +1,364 @@
+// Argv dispatch: resolve the target environment + credential, build the API
+// client, and route to a command. Kept thin over `commands.ts` (which holds
+// the workflow logic) so the wiring here is easy to read end to end.
+import { parseArgs, stringFlag, boolFlag, unknownFlags, valuelessFlags, } from './args.js';
+import { resolveOrigins, resolveCredential, profileForOrigins, } from './config.js';
+import { readCredentialsFile, readPendingLogin, writeStoredCredential } from './store.js';
+import { BrassApi, BrassApiError } from './api.js';
+import { serviceTokenAuth } from './auth.js';
+import { loginDevice, sessionAuth } from './session.js';
+import { loginStart, loginCheck } from './login.js';
+import { createLogger } from './log.js';
+import { publish, schemaPull, agentsPull, whoami, status, } from './commands.js';
+import { readProjectState, resolveAppId, readManifest } from './project.js';
+import { VERSION } from './version.js';
+export { VERSION };
+const USAGE = `brass ${VERSION} - publish Brass apps and pull schemas
+
+Usage:
+  brass login                Sign in with your browser (opens the approval page; approve, done).
+  brass login --start        Start a sign-in and exit: prints the approval URL + code to relay.
+                             Resumes the code already waiting; --new forces a fresh one.
+  brass login --check        Check a started sign-in once; stores the session when approved.
+                             --wait [seconds] polls until approved (default 120s), renewing
+                             an expired code in place and printing the new one.
+  brass logout               Forget the stored sign-in for this environment.
+  brass status [dir]         Report the credential + app state and the one command to run next.
+  brass publish [dir]        Build output in [dir] (default: dist) is deployed to the app's hosting.
+  brass schema pull --doc <docId> [--out brass-app.json]
+                             Fetch a document's schema and write it into a manifest, verbatim.
+  brass agents pull [--out AGENTS.md | --stdout] [--org <organizationId>]
+                             Write your organization's agent instructions (its
+                             AGENTS.md / CLAUDE.md) to a file, or --stdout to print
+                             them (an agent reads them inline). Needs 'brass login';
+                             --org is optional when you belong to one organization.
+  brass whoami               Verify the current credential authenticates.
+
+Authentication:
+  Run 'brass login' to sign in with your browser (needed for schema pull),
+  or set BRASS_SERVICE_TOKEN to a service token minted in the dashboard
+  (org Settings -> Service tokens) for CI, or pass --token <token>.
+
+Common flags:
+  --token <token>            Service token to authenticate with.
+  --json                     Emit the machine-readable result on stdout.
+
+Publish flags:
+  --app <appId>             Publish to a specific app (else .brass/project.json / BRASS_APP_ID).
+  --name <name>             Name for the app when creating one on first publish.
+  --org <organizationId>    Organization to own a newly created app (a signed-in user defaults to their own org; a service token to the token's org).
+  --client-token <key>      Stable key that makes a first create idempotent (else brass-app.json "client_token").
+  --slug <slug>             Preferred hosting subdomain on first enable.
+  --visibility <v>          Set the app's visibility (private | invitee_visible | public).
+  --gate <on|off>           Set the hosted load gate (on = audience-gated, off = world-loadable).
+  --manifest <path>         Served manifest to read a create name from (default: brass-app.json).
+`;
+export async function run(argv) {
+    const parsed = parseArgs(argv);
+    const command = parsed.positionals[0];
+    if (boolFlag(parsed, 'version') && command === undefined) {
+        process.stdout.write(`${VERSION}\n`);
+        return 0;
+    }
+    if (command === undefined || boolFlag(parsed, 'help') || command === 'help') {
+        process.stdout.write(USAGE);
+        return command === undefined && !boolFlag(parsed, 'help') ? 1 : 0;
+    }
+    // Checked after --help / --version so a caller reaching for usage still gets
+    // it, and before any command runs so an unrecognised flag never reaches a
+    // request. Ignoring one would silently target production, since that is what
+    // the origin flags default to.
+    const unknown = unknownFlags(parsed);
+    if (unknown.length > 0) {
+        const names = unknown.map((n) => `--${n}`).join(', ');
+        process.stderr.write(`error: unknown ${unknown.length === 1 ? 'flag' : 'flags'} ${names}\n\n${USAGE}`);
+        return 1;
+    }
+    const json = boolFlag(parsed, 'json');
+    const log = createLogger(json);
+    try {
+        // login / logout run before any credential is required (login is how
+        // one is obtained); everything else needs a resolved credential.
+        if (command === 'login')
+            return await runLogin(parsed, log);
+        if (command === 'logout')
+            return await runLogout(parsed, log);
+        // status runs before a credential is required: reporting "no credential"
+        // (and the next step to obtain one) is a first-class outcome, not an error.
+        if (command === 'status')
+            return await runStatus(parsed, log);
+        const ctx = await buildContext(parsed);
+        switch (command) {
+            case 'publish':
+                log.result(await runPublish(ctx, parsed));
+                return 0;
+            case 'schema':
+                log.result(await runSchema(ctx, parsed));
+                return 0;
+            case 'agents':
+                log.result(await runAgents(ctx, parsed));
+                return 0;
+            case 'whoami':
+                log.result(await whoami(ctx));
+                return 0;
+            default:
+                process.stderr.write(`Unknown command "${command}".\n\n${USAGE}`);
+                return 1;
+        }
+    }
+    catch (err) {
+        process.stderr.write(`${formatError(err)}\n`);
+        return 1;
+    }
+}
+// The flags that name the target stack. Production is the default, so every
+// other stack is reached through these.
+const ORIGIN_FLAGS = ['api-url', 'auth-url', 'dashboard-url'];
+// Resolve the target origins + profile from the origin flags, shared by every
+// command (login and the credential-bearing ones).
+function resolveBase(parsed) {
+    const valueless = valuelessFlags(parsed, ORIGIN_FLAGS);
+    if (valueless.length > 0) {
+        throw new Error(`Missing value for ${valueless.map((name) => `--${name}`).join(', ')}`);
+    }
+    const overrides = {};
+    const apiUrl = stringFlag(parsed, 'api-url');
+    if (apiUrl !== undefined)
+        overrides.apiBaseUrl = apiUrl;
+    const authUrl = stringFlag(parsed, 'auth-url');
+    if (authUrl !== undefined)
+        overrides.authBaseUrl = authUrl;
+    const dashUrl = stringFlag(parsed, 'dashboard-url');
+    if (dashUrl !== undefined)
+        overrides.dashboardBaseUrl = dashUrl;
+    const origins = resolveOrigins(overrides);
+    return { origins, profile: profileForOrigins(origins) };
+}
+async function buildContext(parsed) {
+    const { origins, profile } = resolveBase(parsed);
+    const { auth, credentialKind } = await resolveAuth(parsed, origins, profile);
+    return {
+        api: new BrassApi(origins.apiBaseUrl, auth),
+        cwd: process.cwd(),
+        profile,
+        credentialKind,
+        log: createLogger(boolFlag(parsed, 'json')),
+    };
+}
+// Build the request auth from the resolved credential: a service token is a
+// static bearer; a login session refreshes short-lived access tokens. Returns
+// the credential kind alongside, so a create can resolve the owning org from a
+// human's membership but skip the lookup for a service token.
+async function resolveAuth(parsed, origins, profile) {
+    const file = await readCredentialsFile();
+    const flagToken = stringFlag(parsed, 'token');
+    const envToken = process.env['BRASS_SERVICE_TOKEN'];
+    const credential = resolveCredential({
+        profile,
+        ...(flagToken !== undefined ? { flagToken } : {}),
+        ...(envToken !== undefined ? { envToken } : {}),
+        ...(file !== null ? { file } : {}),
+    });
+    if (credential === null) {
+        throw new Error('No credential. Run `brass login`, or set BRASS_SERVICE_TOKEN (mint one in the dashboard: org Settings -> Service tokens), or pass --token.');
+    }
+    const auth = credential.kind === 'service'
+        ? serviceTokenAuth(credential.token)
+        : sessionAuth(origins.authBaseUrl, credential.sid);
+    return { auth, credentialKind: credential.kind };
+}
+async function runLogin(parsed, log) {
+    const { origins, profile } = resolveBase(parsed);
+    // The two-phase variant for automation: `--start` mints the grant and
+    // exits; `--check` polls it. Plain `brass login` stays the blocking
+    // interactive flow.
+    const start = boolFlag(parsed, 'start');
+    const check = boolFlag(parsed, 'check');
+    const waitSeconds = parseWaitFlag(parsed);
+    if (start && check)
+        throw new Error('Pass one of --start or --check.');
+    if (start) {
+        const code = await loginStart({
+            authBaseUrl: origins.authBaseUrl,
+            profile,
+            log,
+            ...(boolFlag(parsed, 'new') ? { force: true } : {}),
+        });
+        // `--start --wait` is the whole sign-in in one command: relay the code it
+        // prints, then it holds for the approval up to the deadline.
+        if (code !== 0 || waitSeconds === undefined)
+            return code;
+        return loginCheck({ profile, log, waitSeconds });
+    }
+    if (check) {
+        return loginCheck({ profile, log, ...(waitSeconds !== undefined ? { waitSeconds } : {}) });
+    }
+    // The RFC 8628 device grant: open the approval page (code prefilled), print
+    // the URL + code as a fallback for a headless box, and poll until approval.
+    const result = await loginDevice({ authBaseUrl: origins.authBaseUrl });
+    await writeStoredCredential(profile, { session: { sid: result.sessionToken } });
+    log.success(result.email ? `Signed in as ${result.email}.` : 'Signed in.');
+    log.result({ signed_in: true, ...(result.email !== undefined ? { email: result.email } : {}) });
+    return 0;
+}
+async function runLogout(parsed, log) {
+    const { profile } = resolveBase(parsed);
+    await writeStoredCredential(profile, null);
+    log.success('Signed out.');
+    log.result({ signed_out: true });
+    return 0;
+}
+async function runStatus(parsed, log) {
+    const { origins, profile } = resolveBase(parsed);
+    // Resolve the credential directly (not via `resolveAuth`, which throws when
+    // none is found); a missing credential is a reported state here.
+    const file = await readCredentialsFile();
+    const flagToken = stringFlag(parsed, 'token');
+    const envToken = process.env['BRASS_SERVICE_TOKEN'];
+    const credential = resolveCredential({
+        profile,
+        ...(flagToken !== undefined ? { flagToken } : {}),
+        ...(envToken !== undefined ? { envToken } : {}),
+        ...(file !== null ? { file } : {}),
+    });
+    const api = credential === null
+        ? null
+        : new BrassApi(origins.apiBaseUrl, credential.kind === 'service'
+            ? serviceTokenAuth(credential.token)
+            : sessionAuth(origins.authBaseUrl, credential.sid));
+    // What `publish` would target: the same app-id and manifest-name resolution
+    // it does, so the reported next step matches what actually runs.
+    const cwd = process.cwd();
+    const dir = parsed.positionals[1] ?? 'dist';
+    const state = await readProjectState(cwd);
+    const flagApp = stringFlag(parsed, 'app');
+    const envApp = process.env['BRASS_APP_ID'];
+    const appId = resolveAppId({
+        ...(flagApp !== undefined ? { flagApp } : {}),
+        ...(envApp !== undefined ? { envApp } : {}),
+        state,
+        profile,
+    });
+    const manifest = await readManifest(stringFlag(parsed, 'manifest') ?? 'brass-app.json');
+    const manifestName = typeof manifest?.name === 'string' && manifest.name.trim() !== ''
+        ? manifest.name.trim()
+        : null;
+    const pending = await readPendingLogin(profile);
+    const result = await status({
+        api,
+        profile,
+        log,
+        credential,
+        appId,
+        manifestName,
+        publishDir: dir,
+        pendingLogin: pending === null
+            ? null
+            : {
+                userCode: pending.userCode,
+                verificationUrl: pending.verificationUriComplete ?? pending.verificationUri,
+                expiresAt: pending.expiresAt,
+            },
+    });
+    log.result(result);
+    return 0;
+}
+async function runPublish(ctx, parsed) {
+    const dir = parsed.positionals[1] ?? 'dist';
+    const flagApp = stringFlag(parsed, 'app');
+    const envApp = process.env['BRASS_APP_ID'];
+    const name = stringFlag(parsed, 'name');
+    const org = stringFlag(parsed, 'org');
+    const slug = stringFlag(parsed, 'slug');
+    const clientToken = stringFlag(parsed, 'client-token');
+    const visibility = parseVisibilityFlag(stringFlag(parsed, 'visibility'));
+    const requireAccess = parseGateFlag(stringFlag(parsed, 'gate'));
+    const state = await readProjectState(ctx.cwd);
+    const appId = resolveAppId({
+        ...(flagApp !== undefined ? { flagApp } : {}),
+        ...(envApp !== undefined ? { envApp } : {}),
+        state,
+        profile: ctx.profile,
+    });
+    return publish(ctx, {
+        dir,
+        manifestPath: stringFlag(parsed, 'manifest') ?? 'brass-app.json',
+        ...(appId !== null ? { appId } : {}),
+        ...(name !== undefined ? { name } : {}),
+        ...(org !== undefined ? { organizationId: org } : {}),
+        ...(clientToken !== undefined ? { clientToken } : {}),
+        ...(slug !== undefined ? { slug } : {}),
+        ...(visibility !== undefined ? { visibility } : {}),
+        ...(requireAccess !== undefined ? { requireAccess } : {}),
+    });
+}
+// How long `--wait` holds for the approval: bare `--wait` takes the default,
+// `--wait <seconds>` an explicit bound. Capped so a mistyped value cannot
+// park an automated caller for hours; the grant survives the cap either way,
+// so a second check resumes the same sign-in.
+const DEFAULT_WAIT_SECONDS = 120;
+const MAX_WAIT_SECONDS = 3600;
+function parseWaitFlag(parsed) {
+    const raw = parsed.flags['wait'];
+    if (raw === undefined)
+        return undefined;
+    if (raw === true)
+        return DEFAULT_WAIT_SECONDS;
+    const seconds = Number(raw);
+    if (!Number.isInteger(seconds) || seconds <= 0 || seconds > MAX_WAIT_SECONDS) {
+        throw new Error(`Invalid --wait "${raw}" (expected whole seconds, 1 to ${MAX_WAIT_SECONDS})`);
+    }
+    return seconds;
+}
+// Validate `--visibility` against the three reserved values, so a typo is a
+// clear CLI error rather than a server 400 mid-publish.
+function parseVisibilityFlag(value) {
+    if (value === undefined)
+        return undefined;
+    if (value !== 'private' && value !== 'invitee_visible' && value !== 'public') {
+        throw new Error(`Invalid --visibility "${value}" (expected private, invitee_visible, or public)`);
+    }
+    return value;
+}
+// Map `--gate on|off` to the desired load-gate state (on = audience-gated).
+function parseGateFlag(value) {
+    if (value === undefined)
+        return undefined;
+    if (value !== 'on' && value !== 'off') {
+        throw new Error(`Invalid --gate "${value}" (expected on or off)`);
+    }
+    return value === 'on';
+}
+async function runSchema(ctx, parsed) {
+    const sub = parsed.positionals[1];
+    if (sub === 'pull') {
+        const docId = stringFlag(parsed, 'doc');
+        if (docId === undefined)
+            throw new Error('brass schema pull requires --doc <docId>');
+        return schemaPull(ctx, { docId, outPath: stringFlag(parsed, 'out') ?? 'brass-app.json' });
+    }
+    throw new Error('Usage: brass schema pull --doc <docId> [--out brass-app.json]');
+}
+async function runAgents(ctx, parsed) {
+    if (parsed.positionals[1] !== 'pull') {
+        throw new Error('Usage: brass agents pull [--out AGENTS.md | --stdout] [--org <organizationId>]');
+    }
+    const org = stringFlag(parsed, 'org');
+    return agentsPull(ctx, {
+        outPath: stringFlag(parsed, 'out') ?? 'AGENTS.md',
+        ...(boolFlag(parsed, 'stdout') ? { stdout: true } : {}),
+        ...(org !== undefined ? { organizationId: org } : {}),
+    });
+}
+function formatError(err) {
+    if (err instanceof BrassApiError) {
+        if (err.status === 401) {
+            return `error: ${err.message} (the credential was rejected; check BRASS_SERVICE_TOKEN or --token)`;
+        }
+        return `error: ${err.message}`;
+    }
+    if (err instanceof Error)
+        return `error: ${err.message}`;
+    return `error: ${String(err)}`;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands.d.ts

@@ -0,0 +1,94 @@
+import { BrassApi, type AppVisibility } from './api.js';
+import type { Logger } from './log.js';
+import type { Profile, ResolvedCredential } from './config.js';
+export interface CommandContext {
+    api: BrassApi;
+    cwd: string;
+    profile: string;
+    credentialKind: CredentialKind;
+    log: Logger;
+}
+export interface PublishOptions {
+    dir: string;
+    appId?: string;
+    name?: string;
+    organizationId?: string;
+    clientToken?: string;
+    visibility?: AppVisibility;
+    requireAccess?: boolean;
+    slug?: string;
+    manifestPath: string;
+    pollAttempts?: number;
+    pollIntervalMs?: number;
+    sleep?: (ms: number) => Promise<void>;
+}
+export interface PublishResult {
+    app_id: string;
+    version_id: string;
+    url: string | null;
+    warnings: string[];
+}
+export declare function publish(ctx: CommandContext, opts: PublishOptions): Promise<PublishResult>;
+export interface SchemaPullOptions {
+    docId: string;
+    outPath: string;
+}
+export interface SchemaPullResult {
+    family: string;
+    out_path: string;
+}
+export declare function schemaPull(ctx: CommandContext, opts: SchemaPullOptions): Promise<SchemaPullResult>;
+export interface AgentsPullOptions {
+    organizationId?: string;
+    outPath: string;
+    stdout?: boolean;
+}
+export interface AgentsPullResult {
+    organization_id: string;
+    out_path: string | null;
+    bytes: number;
+    empty: boolean;
+}
+export declare function agentsPull(ctx: CommandContext, opts: AgentsPullOptions): Promise<AgentsPullResult>;
+export interface WhoamiResult {
+    authenticated: true;
+}
+export declare function whoami(ctx: CommandContext): Promise<WhoamiResult>;
+export type CredentialKind = 'none' | 'service' | 'session';
+export interface StatusInputs {
+    api: BrassApi | null;
+    profile: Profile;
+    log: Logger;
+    credential: ResolvedCredential | null;
+    appId: string | null;
+    manifestName: string | null;
+    publishDir: string;
+    pendingLogin: {
+        userCode: string;
+        verificationUrl: string;
+        expiresAt: number;
+    } | null;
+}
+export interface StatusResult {
+    profile: string;
+    signed_in: boolean;
+    credential: CredentialKind;
+    authenticated: boolean | null;
+    unverified_reason?: string;
+    email: string | null;
+    pending_login: {
+        user_code: string;
+        verification_url: string;
+        expires_in_seconds: number;
+    } | null;
+    app_id: string | null;
+    hosting: {
+        enabled: boolean;
+        deployed: boolean;
+        url: string | null;
+    } | null;
+    ready_to_publish: boolean;
+    next: string;
+}
+export declare function status(inp: StatusInputs): Promise<StatusResult>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

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