@h-rig/core 0.0.6-alpha.17 → 0.0.6-alpha.170

package/dist/src/remote-config.d.ts

@@ -0,0 +1,183 @@
+export declare const DEFAULT_REMOTE_PORT = 7890;
+/**
+ * Register the transport-owned relay/registry/sshTarget defaults. Called at the
+ * transport plugin module's load (plugin → floor). The floor keeps NO product
+ * host string or remote-execution target of its own; this is the only way the
+ * runtime fallback acquires those defaults. Idempotent and last-write-wins;
+ * absent/empty values are ignored so a second caller cannot clear a prior
+ * registration.
+ */
+export declare function registerBackboneDefaults(defaults: {
+    relayUrl?: string;
+    registryBaseUrl?: string;
+    sshTarget?: string;
+}): void;
+/**
+ * The collab relay URL: rig.config.ts (propagated to RIG_COLLAB_RELAY by the CLI)
+ * → env → the transport plugin's injected default (see registerBackboneDefaults)
+ * → "" (the floor bakes no product host).
+ */
+export declare function resolveRelayUrl(env?: NodeJS.ProcessEnv): string;
+/**
+ * The remote execution sshTarget: rig.config.ts `runtime.server.sshTarget`
+ * (propagated to RIG_SSH_TARGET by the CLI) → env → the transport plugin's
+ * injected default (see registerBackboneDefaults) → "" (the floor bakes no
+ * product remote target). This is a SEPARATE axis from the backbone server:
+ * picking a backbone never changes where runs execute, and vice versa.
+ */
+export declare function resolveSshTarget(env?: NodeJS.ProcessEnv): string;
+export declare const REMOTES_CONFIG_PATH: string;
+type JsonRecord = Record<string, unknown>;
+export declare class RemoteCliError extends Error {
+    readonly code: string;
+    readonly exitCode: number;
+    readonly details: JsonRecord | undefined;
+    constructor(code: string, message: string, exitCode?: number, details?: JsonRecord);
+}
+export type RemoteConfigEntry = {
+    host?: string;
+    port?: number;
+    token?: string;
+    addedAt?: string;
+    lastConnected?: string;
+};
+export type RemotesToml = {
+    version?: number;
+    remotes?: Record<string, RemoteConfigEntry>;
+};
+export type AuthorityRemoteEndpointRecord = {
+    id: string;
+    alias: string;
+    host: string;
+    port: number;
+    transport: string;
+    auto_connect: boolean;
+    labels: string[];
+    capabilities: string[];
+    secret_ref: string;
+    created_at: string;
+    updated_at: string;
+    last_connected_at?: string | null;
+};
+export type AuthorityRemoteEndpointsToml = {
+    version?: number;
+    endpoints?: Record<string, AuthorityRemoteEndpointRecord>;
+};
+export type AuthorityRemoteSecretsToml = {
+    version?: number;
+    secrets?: Record<string, string>;
+};
+export type AuthorityMaterializedRemoteEndpoint = {
+    id: string;
+    alias: string;
+    host: string;
+    port: number;
+    token: string;
+    autoConnect: boolean;
+    addedAt: string;
+    updatedAt: string;
+    lastConnectedAt: string | null;
+    labels: string[];
+    capabilities: string[];
+    transport: string;
+    secretRef: string;
+};
+export type ManagedRemoteEndpoint = {
+    id: string;
+    alias: string;
+    host: string;
+    port: number;
+    token: string;
+    addedAt: string | null;
+    lastConnected: string | null;
+};
+export declare function loadRemotesConfig(configPath?: string): RemotesToml;
+/**
+ * GitHub owner namespace key that scopes the relay registry. The run (which
+ * registers a room) and the cockpit (which lists rooms) MUST derive the SAME
+ * value or `list` returns empty. Order: env override → github-auth.userNamespaceKey
+ * → derived `gh:${userId}`.
+ */
+export declare function resolveOwnerNamespaceKey(projectRoot: string, env?: NodeJS.ProcessEnv): string | undefined;
+export type SelectedRemote = {
+    alias: string;
+    host: string;
+    port: number;
+    sshTarget: string;
+    checkout: string | null;
+    registryBaseUrl: string | null;
+    secretRef: string | null;
+};
+export type DispatchTransportPlacement = {
+    readonly kind: "local";
+    readonly alias: "local";
+    readonly sshTarget: null;
+    readonly selected: null;
+} | {
+    readonly kind: "remote";
+    readonly alias: string;
+    readonly sshTarget: string;
+    readonly selected: SelectedRemote | null;
+};
+/**
+ * Canonical dispatch-time transport placement. Kernel adoption can happen before
+ * a CLI has resolved projectRoot or hydrated env, so transport providers call
+ * this at dispatch time instead of letting command/capability callers branch.
+ */
+export declare function resolveDispatchTransportPlacement(projectRoot: string, env?: NodeJS.ProcessEnv): DispatchTransportPlacement;
+/**
+ * Selected remote placement from connection.json.selected matched against
+ * endpoints.toml.alias. Returns null => LOCAL placement. RIG_REMOTE_ALIAS overrides
+ * the persisted selection.
+ */
+export declare function resolveSelectedRemote(projectRoot: string, env?: NodeJS.ProcessEnv): SelectedRemote | null;
+/**
+ * Registry base URL for the selected target (remote), else the transport plugin's
+ * injected backbone default (see registerBackboneDefaults), else "" — the floor
+ * bakes no product host.
+ */
+export declare function resolveRegistryBaseUrl(projectRoot: string, env?: NodeJS.ProcessEnv): string;
+/**
+ * The OMP `--config` overlay, DERIVED from rig.config.ts-propagated values
+ * (relay/registry via the resolvers above: ambient env → rig.config.ts-filled env →
+ * computed default) plus cockpit-quiet. Written to a real temp file so OMP's
+ * `--config` gets a normal path; memoized per process. Single source for BOTH the
+ * CLI launch and the in-pty agent session (rig-host), so rig.config.ts values
+ * propagate identically — no checked-in/embedded YAML, so the binary is self-contained.
+ */
+export declare function resolveRigOmpConfigOverlayPath(projectRoot?: string): string;
+export declare function listAuthorityRemoteEndpoints(projectRoot: string): AuthorityMaterializedRemoteEndpoint[];
+export declare function updateAuthorityRemoteEndpoint(projectRoot: string, input: {
+    endpointId?: string | undefined;
+    alias?: string | undefined;
+    host?: string | undefined;
+    port?: number | undefined;
+    token?: string | undefined;
+    autoConnect?: boolean | undefined;
+    transport?: string | undefined;
+    labels?: string[] | undefined;
+    capabilities?: string[] | undefined;
+}): AuthorityMaterializedRemoteEndpoint | null;
+export declare function markAuthorityRemoteEndpointConnected(projectRoot: string, endpointId: string, connectedAt?: string): void;
+export declare function importLegacyRemoteEndpoints(projectRoot: string, legacyPath?: string): {
+    imported: number;
+    skipped: number;
+    sourcePath: string;
+};
+export declare function doctorAuthorityRemoteEndpoints(projectRoot: string): {
+    manifestPath: string;
+    secretsPath: string;
+    endpointCount: number;
+    missingSecrets: string[];
+    warnings: string[];
+};
+export declare function listManagedRemoteEndpoints(configPath?: string, projectRoot?: string): ManagedRemoteEndpoint[];
+export declare function upsertManagedRemoteEndpoint(input: {
+    alias: string;
+    host: string;
+    port: number;
+    token?: string;
+}, configPath?: string, projectRoot?: string): ManagedRemoteEndpoint;
+export declare function removeManagedRemoteEndpoint(alias: string, configPath?: string, projectRoot?: string): boolean;
+export declare function normalizeString(value: string | null | undefined): string;
+export {};