@run402/sdk 4.97.0 → 4.99.0

package/dist/node/buzz-doctor.d.ts

@@ -0,0 +1,155 @@
+/**
+ * `r.buzz.doctor()` — the zero-mutation Buzz setup preflight
+ * (`run402.buzz-doctor.v1`), owned by the Node SDK: the managed session's
+ * shell and Node runtime, the Run402 CLI, the managed Buzz CLI sidecar and
+ * its capabilities, the public agent identity, the Run402 API and console
+ * origins (measured with `r.diagnostics.probeOrigin`), the Buzz relay (a
+ * DNS-pinned NIP-11 read), and the explicit wallet profile. Every check's
+ * status is `ok | warning | blocked`; a blocked or warning check carries
+ * exactly one repair action from the frozen matrix below.
+ *
+ * `run402 doctor --buzz` is a shim over this. The Run402 CLI facts (its
+ * version, how it was installed, whether it is current) are the calling
+ * program's own, supplied as hooks; without them the `run402_cli` check
+ * reports the CLI unavailable.
+ */
+import { Buzz } from "../namespaces/buzz.js";
+import type { Client } from "../kernel.js";
+import { Diagnostics, type OriginProbeResult } from "./diagnostics.js";
+export declare const BUZZ_DOCTOR_TIMEOUT_MS = 3000;
+export declare const BUZZ_DOCTOR_MAX_RESPONSE_BYTES: number;
+export declare const BUZZ_DOCTOR_MIN_NODE_MAJOR = 22;
+export declare const BUZZ_DOCTOR_MIN_RUN402_VERSION = "4.17.2";
+export declare const BUZZ_DOCTOR_REPAIR_MATRIX: Readonly<{
+    BUZZ_PREFLIGHT_SHELL_UNAVAILABLE: {
+        type: string;
+        surface: string;
+    };
+    BUZZ_PREFLIGHT_NODE_UNAVAILABLE: {
+        type: string;
+        surface: string;
+    };
+    BUZZ_PREFLIGHT_NODE_INCOMPATIBLE: {
+        type: string;
+        surface: string;
+    };
+    BUZZ_PREFLIGHT_RUN402_UNAVAILABLE: {
+        type: string;
+        surface: string;
+    };
+    BUZZ_PREFLIGHT_RUN402_INCOMPATIBLE: {
+        type: string[];
+        surface: string;
+    };
+    BUZZ_PREFLIGHT_RUN402_UPDATE_AVAILABLE: {
+        type: string;
+        surface: string;
+    };
+    BUZZ_PREFLIGHT_BUZZ_CLI_UNAVAILABLE: {
+        type: string;
+        surface: string;
+    };
+    BUZZ_PREFLIGHT_BUZZ_CLI_INCOMPATIBLE: {
+        type: string;
+        surface: string;
+    };
+    BUZZ_AGENT_TARGET_REQUIRED: {
+        type: string;
+        surface: string;
+    };
+    BUZZ_AGENT_TARGET_UNVERIFIED: {
+        type: string[];
+        surface: string[];
+    };
+    BUZZ_AGENT_TARGET_MISMATCH: {
+        type: string;
+        surface: string;
+    };
+    BUZZ_PREFLIGHT_API_UNREACHABLE: {
+        type: string;
+        surface: string;
+    };
+    BUZZ_PREFLIGHT_CONSOLE_UNREACHABLE: {
+        type: string;
+        surface: string;
+    };
+    BUZZ_PREFLIGHT_RELAY_UNSAFE: {
+        type: string;
+        surface: string;
+    };
+    BUZZ_PREFLIGHT_RELAY_UNREACHABLE: {
+        type: string[];
+        surface: string;
+    };
+    BUZZ_PREFLIGHT_WALLET_PROFILE_REQUIRED: {
+        type: string;
+        surface: string;
+    };
+    BUZZ_PREFLIGHT_WALLET_PROFILE_NOT_FOUND: {
+        type: string;
+        surface: string;
+    };
+    BUZZ_PREFLIGHT_WALLET_PROFILE_MISMATCH: {
+        type: string;
+        surface: string;
+    };
+}>;
+export declare function normalizeNostrSubject(value: any): string | null;
+/** What the Run402 CLI knows about itself, supplied by the CLI when it runs the preflight. */
+export interface BuzzDoctorRun402CliHooks {
+    /** The executing CLI's version. */
+    currentVersion: () => string;
+    /** How the executing CLI was installed: `{ kind, confidence, package_manager }`. */
+    detectInstall: (ctx: {
+        cwd: string;
+        env: Record<string, string | undefined>;
+        argv: string[];
+        execPath: string;
+    }) => any;
+    /** The CLI's own update check (a doctor check; `status: "warning"` offers an upgrade). */
+    updateCheck?: (opts: Record<string, unknown>) => Promise<any>;
+}
+export interface BuzzDoctorOptions {
+    /** The intended managed agent's public key, hex (see {@link normalizeNostrSubject}). */
+    expectedSubjectHex?: string | null;
+    /** The Run402 CLI's facts; absent, the `run402_cli` check reports the CLI unavailable. */
+    run402Cli?: BuzzDoctorRun402CliHooks;
+    env?: Record<string, string | undefined>;
+    argv?: string[];
+    execPath?: string;
+    cliExecutable?: string | null;
+    cwd?: string;
+    platform?: NodeJS.Platform;
+    now?: number;
+    runCommand?: (command: string, args: string[], options?: Record<string, unknown>) => any;
+    lookup?: (hostname: string, options: any) => Promise<any>;
+    pinnedRelayRead?: (relay: any, record: any, options: {
+        timeoutMs: number;
+        maxBytes: number;
+    }) => Promise<any>;
+    /** Measures an origin; defaults to `r.diagnostics.probeOrigin`. */
+    originProbe?: (url: URL, options: {
+        timeoutMs: number;
+        maxBytes: number;
+    }) => Promise<OriginProbeResult>;
+    getActiveProfile?: () => string;
+    profileExistsImpl?: (name: string) => boolean;
+    readMetaImpl?: (name: string) => any;
+    apiOrigin?: string;
+    consoleOrigin?: string;
+}
+export declare function buildBuzzDoctorReport({ expectedSubjectHex, run402Cli, env, argv, execPath, cliExecutable, cwd, platform, now, runCommand, lookup, pinnedRelayRead, originProbe, getActiveProfile, profileExistsImpl, readMetaImpl, apiOrigin, consoleOrigin, }?: BuzzDoctorOptions): Promise<any>;
+export declare function defaultPinnedRelayRead(relay: any, record: any, { timeoutMs, maxBytes }?: any): Promise<unknown>;
+export declare function isPublicAddress(address: any): boolean;
+export declare function pinnedLookup(record: any, expectedHostname: any): (hostname: any, options: any, callback: any) => void;
+/**
+ * `r.buzz` on the Node entry: the isomorphic Buzz workflows plus the
+ * zero-mutation setup preflight.
+ */
+export declare class NodeBuzz extends Buzz {
+    #private;
+    constructor(client: Client, diagnostics: Diagnostics);
+    /** The `run402.buzz-doctor.v1` report. Read-only: nothing is created, signed, or published. */
+    doctor(opts?: BuzzDoctorOptions): Promise<any>;
+}
+//# sourceMappingURL=buzz-doctor.d.ts.map

package/dist/node/buzz-doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buzz-doctor.d.ts","sourceRoot":"","sources":["../../src/node/buzz-doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAcH,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAO3C,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAIvE,eAAO,MAAM,sBAAsB,OAAQ,CAAC;AAC5C,eAAO,MAAM,8BAA8B,QAAY,CAAC;AACxD,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAI7C,eAAO,MAAM,8BAA8B,WAAW,CAAC;AAKvD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBpC,CAAC;AAEH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,GAAG,iBAa/C;AAED,8FAA8F;AAC9F,MAAM,WAAW,wBAAwB;IACvC,mCAAmC;IACnC,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,oFAAoF;IACpF,aAAa,EAAE,CAAC,GAAG,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,GAAG,CAAC;IACxH,0FAA0F;IAC1F,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,iBAAiB;IAChC,wFAAwF;IACxF,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,0FAA0F;IAC1F,SAAS,CAAC,EAAE,wBAAwB,CAAC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC;IACzF,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1D,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9G,mEAAmE;IACnE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzG,gBAAgB,CAAC,EAAE,MAAM,MAAM,CAAC;IAChC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,wBAAsB,qBAAqB,CAAC,EAC1C,kBAAyB,EACzB,SAAS,EACT,GAAiB,EACjB,IAAmB,EACnB,QAA2B,EAC3B,aAA+B,EAC/B,GAAmB,EACnB,QAA2B,EAC3B,GAAgB,EAChB,UAA8B,EAC9B,MAAkB,EAClB,eAAwC,EACxC,WAAwF,EACxF,gBAAuC,EACvC,iBAAiC,EACjC,YAAuB,EACvB,SAAwB,EACxB,aAA4C,GAC7C,GAAE,iBAAsB,GAAG,OAAO,CAAC,GAAG,CAAC,CAwDvC;AAsOD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,SAAkC,EAAE,QAAyC,EAAE,GAAE,GAAQ,oBAgD1J;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,GAAG,WAM3C;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,IACrD,UAAU,GAAG,EAAE,SAAS,GAAG,EAAE,UAAU,GAAG,UAenD;AA6VD;;;GAGG;AACH,qBAAa,QAAS,SAAQ,IAAI;;gBAGpB,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW;IAKpD,+FAA+F;IACzF,MAAM,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,GAAG,CAAC;CAMzD"}