@run402/sdk 4.97.0 → 4.99.0

package/dist/node/org-context.js

@@ -0,0 +1,403 @@
+/**
+ * Organization context, owned by the Node SDK: the ONE resolver every
+ * org-scoped command consumes, and the verbs that select, report, and bind
+ * the current organization.
+ *
+ * The org is the ownership root — it owns projects, holds memberships, and is
+ * the scope for rooms, escalations, members, grants, and audit. Precedence is
+ * four INTENT CLASSES, highest first, and inside each class an organization
+ * named directly outranks one derived from a project named in that same class:
+ *
+ *   1. flag          `org` (--org)                 else `project` (--project) -> its org
+ *   2. environment   RUN402_ORG, else the org half else RUN402_PROJECT_ID -> its org
+ *                    of RUN402_ROOM
+ *   3. binding       the `org` key of the nearest .run402(.local).json
+ *   3.5 vault pin    `r402.orgId` in this checkout's local git config
+ *   4. profile state the profile's selected org else its active project -> org
+ *
+ * Naming a project IS naming its organization, so a stale profile selection
+ * never outranks it; classes 3 and 4 are what let an org that owns no project
+ * be addressed at all.
+ *
+ * Two things this deliberately does NOT do:
+ * - Infer the org from the caller's memberships, at any count: membership is
+ *   server state that changes without the caller acting.
+ * - Validate membership locally: a well-formed id goes to the server and the
+ *   server's answer is surfaced as returned, never retried against a lower
+ *   class and never rewritten into a local not-found.
+ */
+import { basename } from "node:path";
+import { describeRejectedValue } from "../../core-dist/redact.js";
+import { findBindingKey, readBindingFile, updateBindingFile } from "../../core-dist/binding-file.js";
+import { clearActiveOrgId, getActiveOrgId, setActiveOrgId, } from "../../core-dist/profile-state.js";
+import { getActiveProjectId, getProject, updateProject } from "../../core-dist/keystore.js";
+import { LocalError } from "../errors.js";
+import { Orgs } from "../namespaces/org.js";
+import { Rooms } from "../namespaces/rooms.js";
+import { Projects } from "../namespaces/projects.js";
+import { localAction } from "./local-actions.js";
+export const ORG_ENV = "RUN402_ORG";
+export const ROOM_ENV = "RUN402_ROOM";
+export const PROJECT_ENV = "RUN402_PROJECT_ID";
+/** `org_id` is a UUID at every API boundary. */
+export const ORG_ID_RE = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
+const CONTEXT = "resolving the organization";
+const trimmed = (v) => (typeof v === "string" && v.trim() ? v.trim() : null);
+export function listOrgsAction() {
+    return localAction("edit_request", {
+        command: "run402 orgs list",
+        why: "List the organizations this wallet belongs to.",
+    });
+}
+/** The recovery actions an `ORG_REQUIRED` refusal carries: every way to supply an org. */
+export function orgRequiredActions() {
+    return [
+        localAction("edit_request", {
+            command: "run402 orgs use <org_id>",
+            why: "Select a current organization for this wallet profile.",
+        }),
+        listOrgsAction(),
+        localAction("edit_request", {
+            command: "run402 <command> --org <org_id>",
+            why: "Name the organization on this one call.",
+        }),
+        localAction("edit_request", {
+            command: "export RUN402_ORG=<org_id>",
+            why: "Name the organization for every call in this shell (harness wiring).",
+        }),
+        localAction("edit_request", {
+            command: `echo '{"org":"<org_id>"}' > .run402.json`,
+            why: "Bind this checkout to an organization so every agent in it inherits the same one.",
+        }),
+        localAction("edit_request", {
+            command: "run402 projects use <project_id>",
+            why: "Select a project; its owning organization becomes the current one.",
+        }),
+    ];
+}
+/**
+ * Shape-validate an organization id from a local source. Never checks
+ * membership. A rejected value may be a pasted secret, so it is redacted.
+ */
+export function assertOrgIdShape(orgId, origin) {
+    if (ORG_ID_RE.test(orgId))
+        return orgId;
+    throw new LocalError(`Invalid organization id ${JSON.stringify(describeRejectedValue(orgId))} (from ${origin}).`, CONTEXT, {
+        code: "BAD_ORG_ID",
+        hint: "An org_id is a UUID. Run 'run402 orgs list' to see the organizations you belong to.",
+        details: { org_id: describeRejectedValue(orgId), origin },
+        next_actions: [listOrgsAction()],
+    });
+}
+/** The `ORG_REQUIRED` refusal, optionally naming a rejected positional. */
+export function orgRequiredError(opts = {}) {
+    const rejected = opts.rejectedPositional;
+    return new LocalError(typeof rejected === "string"
+        ? `No organization specified and no current organization set (${JSON.stringify(rejected)} is not an org_id — an org_id is a UUID).`
+        : "No organization specified and no current organization set.", CONTEXT, {
+        code: "ORG_REQUIRED",
+        hint: opts.positionalHint
+            ? `Pass --org <org_id> (or a leading <org_id> positional), set ${ORG_ENV}, bind this directory in .run402.json, or run: run402 orgs use <org_id>`
+            : `Pass --org <org_id>, set ${ORG_ENV}, bind this directory in .run402.json, or run: run402 orgs use <org_id>`,
+        ...(typeof rejected === "string" ? { details: { rejected_positional: rejected } } : {}),
+        next_actions: orgRequiredActions(),
+    });
+}
+/** The org half of `RUN402_ROOM=<org_id>/<room_key>`, or null. */
+function orgFromRoomEnv(env) {
+    const raw = trimmed(env[ROOM_ENV]);
+    if (!raw)
+        return null;
+    const slash = raw.indexOf("/");
+    if (slash <= 0 || slash === raw.length - 1)
+        return null;
+    return raw.slice(0, slash);
+}
+/**
+ * `r402.orgId` from `cwd`'s local git config: a vault checkout's pin first,
+ * then the bare org/room pin a room-only `rooms join` writes. Best-effort:
+ * no repository, no pin, or a malformed value is simply null.
+ */
+async function readVaultPinnedOrgId(cwd) {
+    try {
+        const { readPinnedVaultRepo, readPinnedRoomBinding } = await import("./vault-address.js");
+        const pinned = await readPinnedVaultRepo(cwd);
+        const orgId = trimmed(pinned?.org_id);
+        if (orgId && ORG_ID_RE.test(orgId))
+            return orgId;
+        const bare = await readPinnedRoomBinding(cwd);
+        const bareOrgId = trimmed(bare?.org_id);
+        return bareOrgId && ORG_ID_RE.test(bareOrgId) ? bareOrgId : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** A directory name coerced into a legal room key, or null. */
+function roomKeyFromDir(dir) {
+    const base = basename(dir);
+    const slug = base.toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+/, "").slice(0, 64);
+    return /^[a-z0-9]/.test(slug) ? slug : null;
+}
+/** Provenance triple for command output: bounded, never a resolution trace. */
+export function orgProvenance(resolved) {
+    return resolved
+        ? { org_id: resolved.orgId, org_source: resolved.source, org_source_detail: resolved.sourceDetail }
+        : { org_id: null, org_source: null, org_source_detail: null };
+}
+/**
+ * `r.orgs` on the Node entry: the isomorphic org collection and identity
+ * verbs plus the local organization context.
+ */
+export class NodeOrgs extends Orgs {
+    #client;
+    #rooms;
+    #projects;
+    /**
+     * @param namespaces the reads the resolver makes (a project's org, the
+     *   project listing); default to fresh namespaces on `client`.
+     */
+    constructor(client, namespaces = {}) {
+        super(client);
+        this.#client = client;
+        this.#rooms = namespaces.rooms ?? new Rooms(client);
+        this.#projects = namespaces.projects ?? new Projects(client);
+    }
+    /**
+     * A project's owning org: the local key cache when it carries one, else one
+     * read. An explicitly named project (`required`) that cannot be resolved
+     * throws — falling to a lower class would act on a different org than the
+     * caller asked for; an implicit one returns null.
+     */
+    async #orgOfProject(projectId, required) {
+        const cached = (await this.#client.getProjectCredentials(projectId))?.org_id;
+        if (typeof cached === "string" && cached.length > 0)
+            return cached;
+        try {
+            return (await this.#rooms.forProject(projectId)).orgId;
+        }
+        catch (err) {
+            if (!required)
+                return null;
+            throw err;
+        }
+    }
+    /**
+     * The one resolver. Returns the org with its provenance, or null when
+     * `optional` and nothing supplies one; throws `BAD_ORG_ID`, `AMBIGUOUS_ORG`,
+     * or `ORG_REQUIRED` (each with its recovery actions) otherwise.
+     */
+    async resolve(input = {}, opts = {}) {
+        const { env = process.env, cwd = process.cwd(), optional = false, allowConflict = false } = opts;
+        // Class 1: flag.
+        const orgFlag = trimmed(input.org);
+        if (orgFlag)
+            return { orgId: assertOrgIdShape(orgFlag, "--org"), source: "flag", sourceDetail: "--org" };
+        const projectFlag = trimmed(input.project);
+        if (projectFlag) {
+            const orgId = await this.#orgOfProject(projectFlag, true);
+            if (orgId)
+                return { orgId, source: "flag", sourceDetail: "--project" };
+        }
+        // Classes 2 and 3: environment vs binding (the conflict pair).
+        const bindingHit = findBindingKey(cwd, "org");
+        const bindingOrg = bindingHit ? assertOrgIdShape(bindingHit.value, bindingHit.file) : null;
+        const envDirect = trimmed(env[ORG_ENV]);
+        const envRoomOrg = envDirect ? null : orgFromRoomEnv(env);
+        const envProject = envDirect || envRoomOrg ? null : trimmed(env[PROJECT_ENV]);
+        let envOrg = null;
+        let envDetail = null;
+        if (envDirect) {
+            envOrg = assertOrgIdShape(envDirect, ORG_ENV);
+            envDetail = ORG_ENV;
+        }
+        else if (envRoomOrg) {
+            envOrg = assertOrgIdShape(envRoomOrg, ROOM_ENV);
+            envDetail = ROOM_ENV;
+        }
+        else if (envProject && bindingOrg) {
+            // Only worth a lookup when a binding exists to disagree with.
+            envOrg = await this.#orgOfProject(envProject, false);
+            envDetail = PROJECT_ENV;
+        }
+        if (envOrg && bindingOrg && envOrg !== bindingOrg && !allowConflict) {
+            // A binding deliberately declared by a checkout outranks the profile
+            // selection silently; an ambient env var disagreeing with a committed
+            // file is the surprise worth stopping on.
+            throw new LocalError(`Ambiguous organization: ${envDetail}=${envOrg} but ${bindingHit.file} binds ${bindingOrg}.`, CONTEXT, {
+                code: "AMBIGUOUS_ORG",
+                hint: `Resolve with one of: pass --org <org_id>, unset ${envDetail}, or edit the binding file.`,
+                details: {
+                    candidates: [
+                        { org_id: envOrg, source: "env", source_detail: envDetail },
+                        { org_id: bindingOrg, source: "binding", source_detail: bindingHit.file },
+                    ],
+                },
+                next_actions: [
+                    localAction("edit_request", {
+                        command: "run402 <command> --org <org_id>",
+                        why: "The flag resolves the conflict for this call.",
+                    }),
+                ],
+            });
+        }
+        if (envOrg)
+            return { orgId: envOrg, source: "env", sourceDetail: envDetail };
+        if (envProject) {
+            const orgId = await this.#orgOfProject(envProject, false);
+            if (orgId)
+                return { orgId, source: "env", sourceDetail: PROJECT_ENV };
+        }
+        if (bindingOrg)
+            return { orgId: bindingOrg, source: "binding", sourceDetail: bindingHit.file };
+        // Class 3.5: this checkout's vault pin.
+        const pinnedOrg = await readVaultPinnedOrgId(cwd);
+        if (pinnedOrg)
+            return { orgId: pinnedOrg, source: "vault_pin", sourceDetail: "r402.orgId (local git config)" };
+        // Class 4: profile state.
+        const selected = trimmed(getActiveOrgId());
+        if (selected)
+            return { orgId: assertOrgIdShape(selected, "orgs use"), source: "profile", sourceDetail: "orgs use" };
+        const activeProject = trimmed(getActiveProjectId());
+        if (activeProject) {
+            const orgId = await this.#orgOfProject(activeProject, false);
+            if (orgId)
+                return { orgId, source: "profile", sourceDetail: "projects use" };
+        }
+        if (optional)
+            return null;
+        throw orgRequiredError();
+    }
+    /** Select the current organization for the active wallet profile (`orgs use`). */
+    async use(orgId) {
+        setActiveOrgId(assertOrgIdShape(orgId, "orgs use"));
+        return { org_id: orgId, selected: true, scope: "wallet_profile" };
+    }
+    /**
+     * The organization this directory and profile resolve to, with provenance,
+     * beside the profile's own selection. An empty selection is an explicit
+     * null state. Never fails on ambiguity: the command that reports the
+     * selection stays usable while it is ambiguous.
+     */
+    async current(opts = {}) {
+        const resolved = await this.resolve({}, { ...opts, optional: true, allowConflict: true });
+        return { ...orgProvenance(resolved), selected_org_id: this.selected() };
+    }
+    /** The profile's selected organization, without running the chain. */
+    selected() {
+        return trimmed(getActiveOrgId());
+    }
+    /** Clear the profile's selected organization. */
+    async clear() {
+        const previous = this.selected();
+        clearActiveOrgId();
+        return { org_id: null, selected: false, previous_org_id: previous ?? null };
+    }
+    /**
+     * Write this checkout's org (and room) into `.run402.json`. With no org, the
+     * caller's sole membership is used and written down: an explicit, recorded
+     * act, unlike the chain, which never infers. Two or more memberships refuse.
+     */
+    async bind(orgId, opts = {}) {
+        const cwd = opts.cwd ?? process.cwd();
+        let chosen = orgId || null;
+        let picked = "flag";
+        if (!chosen) {
+            const rows = await this.list();
+            if (rows.length === 0) {
+                throw new LocalError("This wallet is a member of no organization yet.", "binding the organization", {
+                    code: "NO_ORGS",
+                    hint: "Run 'run402 init' to provision one, or ask an owner to add you with 'run402 orgs members add'.",
+                    next_actions: [localAction("initialize_wallet", { command: "run402 init", why: "Provision this wallet's organization, then retry." })],
+                });
+            }
+            if (rows.length > 1) {
+                throw new LocalError(`This wallet belongs to ${rows.length} organizations — name the one to bind.`, "binding the organization", {
+                    code: "AMBIGUOUS_ORG",
+                    hint: "run402 orgs bind --org <org_id>",
+                    details: { orgs: rows.map((o) => ({ org_id: o.org_id, display_name: o.display_name ?? null, role: o.role ?? null })) },
+                    next_actions: [localAction("edit_request", { command: "run402 orgs bind --org <org_id>", why: "Name which organization this checkout coordinates in." })],
+                });
+            }
+            chosen = rows[0].org_id;
+            picked = "sole_membership";
+        }
+        const room = opts.room ?? roomKeyFromDir(cwd);
+        const { contents, file } = updateBindingFile(cwd, {
+            org: assertOrgIdShape(chosen, picked === "flag" ? "--org" : "orgs list"),
+            ...(room ? { room } : {}),
+        });
+        return {
+            org_id: chosen,
+            room_key: room ?? null,
+            org_source: picked,
+            file: ".run402.json",
+            path: file,
+            bound: true,
+            safe_to_commit: true,
+            note: "Safe to commit — an org id is an identifier, not a credential; authorization stays server-side.",
+            binding: contents,
+        };
+    }
+    /** Remove the `org` and `room` keys from `./.run402.json`; the file goes when nothing else is left. */
+    async unbind(opts = {}) {
+        const cwd = opts.cwd ?? process.cwd();
+        const previous = readBindingFile(cwd);
+        const { contents, removed } = updateBindingFile(cwd, { org: null, room: null });
+        return {
+            file: ".run402.json",
+            unbound: previous.org !== undefined || previous.room !== undefined,
+            removed,
+            binding: contents,
+        };
+    }
+    /**
+     * Stamp a project's owning organization as the profile's selection
+     * (`projects use` does this: a project determines its org unambiguously).
+     * Best-effort: returns the org, or null, and never throws.
+     */
+    async selectFromProject(projectId) {
+        try {
+            const orgId = await this.#orgOfProject(projectId, false);
+            if (orgId) {
+                setActiveOrgId(orgId);
+                return orgId;
+            }
+        }
+        catch {
+            /* best-effort */
+        }
+        return null;
+    }
+    /**
+     * The organization that OWNS a specific project, or null. Distinct from
+     * {@link resolve} (which org a command is addressed at): an `--org` override
+     * here would be a mis-binding. Remembered in the local project entry after
+     * the first lookup, so the vault scaffold adds no network read on a
+     * returning machine; an exact id match is required.
+     */
+    async owningOrgOf(projectId) {
+        const cached = getProject(projectId)?.org_id;
+        if (typeof cached === "string" && cached.length > 0)
+            return cached;
+        try {
+            const listed = await this.#projects.list();
+            const rows = Array.isArray(listed?.projects) ? listed.projects : [];
+            const row = rows.find((p) => (p?.id ?? p?.project_id) === projectId);
+            const orgId = row?.org_id;
+            if (typeof orgId !== "string" || orgId.length === 0)
+                return null;
+            try {
+                updateProject(projectId, { org_id: orgId });
+            }
+            catch {
+                /* caching is an optimization */
+            }
+            return orgId;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=org-context.js.map

package/dist/node/org-context.js.map

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

package/dist/node/status.d.ts

@@ -0,0 +1,62 @@
+/**
+ * `r.status()` — the organization's state in one read, owned by the Node
+ * SDK: the active wallet (`local_label`, `server_label`, address), its rail,
+ * on-chain and allowance balances, the tier and its lease, the projects
+ * (server-side, falling back to the local key cache), the active project, and
+ * the API target. This is the LOCAL view — which wallet this machine acts as —
+ * combined with the reads that wallet can make; it never returns key material.
+ *
+ * With no local wallet the answer is the bare local state (`wallet: null`,
+ * the locally known projects, the active project, the target) plus the next
+ * command; Run402 Core targets can still report it without a wallet.
+ * `run402 status` is a shim over this.
+ */
+import type { Run402 } from "../index.js";
+export interface StatusTarget {
+    api_base: string;
+    api_base_source: "env" | "profile" | "default";
+    kind: "cloud" | "core" | "unknown";
+}
+/** No local wallet: the local facts and the next command. */
+export interface LocalOnlyStatus {
+    wallet: null;
+    target: StatusTarget;
+    projects: Array<{
+        project_id: string;
+    }>;
+    active_project: string | null;
+    hint: string;
+}
+/** A local wallet: the organization's state as that wallet sees it. */
+export interface WalletStatus {
+    wallet: {
+        local_label: string;
+        server_label: string | null;
+        address: string;
+    };
+    rail: string;
+    remote_status: unknown;
+    next_actions: unknown;
+    projects_source: "remote" | "local_cache";
+    balances: {
+        on_chain_usd_micros: number | null;
+        on_chain_token: "USDC" | "pathUSD";
+        allowance_usd_micros: number | null;
+        held_usd_micros: number | null;
+    };
+    tier: {
+        name: string;
+        status: string;
+        expires: string | null;
+    } | null;
+    organization_lifecycle_state: string | null;
+    lease_perpetual: boolean | null;
+    projects: Array<Record<string, unknown> & {
+        project_id: string;
+    }>;
+    active_project: string | null;
+    target: StatusTarget;
+}
+export type StatusResult = LocalOnlyStatus | WalletStatus;
+export declare function runStatus(r: Run402): Promise<StatusResult>;
+//# sourceMappingURL=status.d.ts.map

package/dist/node/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/node/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAS1C,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;IAC/C,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,QAAQ,GAAG,aAAa,CAAC;IAC1C,QAAQ,EAAE;QACR,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;QACnC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;QACnC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;QACpC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC;IACF,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACtE,4BAA4B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,YAAY,CAAC;AA+C1D,wBAAsB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAsEhE"}

package/dist/node/status.js

@@ -0,0 +1,132 @@
+/**
+ * `r.status()` — the organization's state in one read, owned by the Node
+ * SDK: the active wallet (`local_label`, `server_label`, address), its rail,
+ * on-chain and allowance balances, the tier and its lease, the projects
+ * (server-side, falling back to the local key cache), the active project, and
+ * the API target. This is the LOCAL view — which wallet this machine acts as —
+ * combined with the reads that wallet can make; it never returns key material.
+ *
+ * With no local wallet the answer is the bare local state (`wallet: null`,
+ * the locally known projects, the active project, the target) plus the next
+ * command; Run402 Core targets can still report it without a wallet.
+ * `run402 status` is a shim over this.
+ */
+import { getActiveProfile, getApiBase, getApiBaseSource, getApiTargetKind, } from "../../core-dist/config.js";
+import { readLocalWallet } from "./wallets.js";
+import { getActiveProjectId, loadKeyStore } from "../../core-dist/keystore.js";
+import { readMeta } from "../../core-dist/profiles.js";
+import { readRemoteStatus } from "./remote-status.js";
+const USDC_ABI = [{ name: "balanceOf", type: "function", stateMutability: "view", inputs: [{ name: "account", type: "address" }], outputs: [{ name: "", type: "uint256" }] }];
+const USDC_MAINNET = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+const USDC_SEPOLIA = "0x036CbD53842c5426634e7929541eC2318f3dCF7e";
+const PATH_USD = "0x20c0000000000000000000000000000000000000";
+const TEMPO_RPC = "https://rpc.moderato.tempo.xyz/";
+/**
+ * The wallet's on-chain balance in USD micros for its rail: USDC on Base
+ * mainnet plus Base Sepolia (x402), or pathUSD on Tempo Moderato (mpp).
+ * Null when every read fails.
+ */
+async function readWalletBalanceUsdMicros(rail, address) {
+    try {
+        const { createPublicClient, http, defineChain } = await import("viem");
+        if (rail === "mpp") {
+            const tempoModerato = defineChain({
+                id: 42431,
+                name: "Tempo Moderato",
+                nativeCurrency: { name: "pathUSD", symbol: "pathUSD", decimals: 6 },
+                rpcUrls: { default: { http: [TEMPO_RPC] } },
+            });
+            const client = createPublicClient({ chain: tempoModerato, transport: http() });
+            try {
+                const raw = await client.readContract({ address: PATH_USD, abi: USDC_ABI, functionName: "balanceOf", args: [address] });
+                return Number(raw);
+            }
+            catch {
+                return null;
+            }
+        }
+        const { base, baseSepolia } = await import("viem/chains");
+        const mainnetClient = createPublicClient({ chain: base, transport: http() });
+        const sepoliaClient = createPublicClient({ chain: baseSepolia, transport: http() });
+        const [mainnet, sepolia] = await Promise.all([
+            mainnetClient.readContract({ address: USDC_MAINNET, abi: USDC_ABI, functionName: "balanceOf", args: [address] }).then(Number).catch(() => null),
+            sepoliaClient.readContract({ address: USDC_SEPOLIA, abi: USDC_ABI, functionName: "balanceOf", args: [address] }).then(Number).catch(() => null),
+        ]);
+        if (mainnet === null && sepolia === null)
+            return null;
+        return (mainnet || 0) + (sepolia || 0);
+    }
+    catch {
+        return null;
+    }
+}
+/** Always expose `project_id` (the remote listing keys entries as `id`), never both. */
+function normalizeProject(raw) {
+    if (!raw || typeof raw !== "object")
+        return raw;
+    const projectId = (raw.project_id || raw.id);
+    const { id: _dropId, project_id: _dropPid, ...rest } = raw;
+    return { project_id: projectId, ...rest };
+}
+export async function runStatus(r) {
+    const localWallet = readLocalWallet();
+    const target = {
+        api_base: getApiBase(),
+        api_base_source: getApiBaseSource(),
+        kind: getApiTargetKind(),
+    };
+    if (!localWallet) {
+        const store = loadKeyStore();
+        return {
+            wallet: null,
+            target,
+            projects: Object.keys(store.projects).map((id) => ({ project_id: id })),
+            active_project: getActiveProjectId() || null,
+            hint: target.kind === "core" ? "Run: run402 projects provision --name my-app" : "Run: run402 init",
+        };
+    }
+    const wallet = localWallet.address.toLowerCase();
+    const rail = localWallet.rail || "x402";
+    // Tier, allowance, and the membership-scoped project inventory, beside the
+    // on-chain balance, all best-effort.
+    const [status, walletBalance] = await Promise.all([
+        readRemoteStatus(r, wallet),
+        readWalletBalanceUsdMicros(rail, localWallet.address),
+    ]);
+    const { tier, billing, remote } = status;
+    const store = loadKeyStore();
+    const activeId = getActiveProjectId();
+    const projects = remote?.projects
+        ? remote.projects.map(normalizeProject)
+        : Object.keys(store.projects).map((id) => ({ project_id: id }));
+    const walletName = getActiveProfile();
+    const walletMeta = readMeta(walletName);
+    const hasBilling = billing && billing.exists !== false;
+    return {
+        wallet: {
+            local_label: walletName,
+            server_label: walletMeta?.label ?? null,
+            address: localWallet.address,
+        },
+        rail,
+        remote_status: status.availability,
+        next_actions: status.next_actions,
+        projects_source: remote ? "remote" : "local_cache",
+        balances: {
+            on_chain_usd_micros: walletBalance,
+            on_chain_token: rail === "mpp" ? "pathUSD" : "USDC",
+            allowance_usd_micros: hasBilling ? billing.allowance_usd_micros : null,
+            held_usd_micros: hasBilling ? (billing.held_usd_micros ?? 0) : null,
+        },
+        tier: tier && tier.tier
+            ? { name: tier.tier, status: tier.status, expires: tier.lease_perpetual === true ? null : tier.lease_expires_at }
+            : null,
+        // Lifecycle and the perpetual flag live on the organization; surfaced at the top.
+        organization_lifecycle_state: tier?.organization_lifecycle_state ?? null,
+        lease_perpetual: tier?.lease_perpetual ?? null,
+        projects,
+        active_project: activeId || null,
+        target,
+    };
+}
+//# sourceMappingURL=status.js.map

package/dist/node/status.js.map

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