@rynx-ai/daemon 0.1.0 → 0.1.9

package/dist/control-client.d.ts

@@ -0,0 +1,113 @@
+import { type DaemonStatus } from "@rynx-ai/protocol/remote-runtime";
+import { type RemoteRuntimeRpcMethod, type RemoteRuntimeRpcParams, type RemoteRuntimeRpcResultFor } from "@rynx-ai/protocol/remote-runtime-rpc";
+import { type PairingOffer } from "@rynx-ai/protocol/direct-runtime";
+import { type RuntimeBrowserBootstrapCredential, type RuntimeBrowserEndpointDescriptor } from "@rynx-ai/protocol/runtime-browser-bootstrap";
+export { connectResidentDesktopBrowserHost, type ResidentDesktopBrowserHostConnection, type ResidentDesktopBrowserHostCommandRequest, type ResidentDesktopBrowserHostConnectOptions, type ResidentDesktopBrowserHostFailure, } from "./desktop-browser-host-client.js";
+export interface ResidentDaemon {
+    origin: string;
+}
+export interface ResidentDaemonIdentity {
+    installationId: string;
+    algorithm: "Ed25519";
+    publicKey: string;
+}
+export interface ResidentPluginCommandResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+    truncated: boolean;
+}
+export interface ResidentRemoteRuntimeClientGrant {
+    grantId: string;
+    clientId: string;
+    clientLabel: string | null;
+    clientKeyFingerprint: string;
+    authorities: string[];
+    createdAt: string;
+    revokedAt: string | null;
+    lastUsedAt: string | null;
+}
+export interface ResidentRuntimeTargetView {
+    selector: string;
+    daemonId: string;
+    displayName: string;
+    binding: "local" | "direct";
+    endpoint?: string;
+    identityKeyFingerprint?: string;
+    createdAt?: string;
+}
+export interface ResidentRuntimeTargetTestResult {
+    target: ResidentRuntimeTargetView;
+    status: DaemonStatus;
+}
+export interface InvokeResidentPluginCommandOptions {
+    stdin?: string;
+    signal?: AbortSignal;
+}
+export type ResidentRuntimeCallErrorCode = "invalid_target" | "invalid_request" | "not_found" | "conflict" | "failed_precondition" | "method_not_found" | "deadline_exceeded" | "unreachable" | "tls_error" | "identity_mismatch" | "incompatible" | "authentication_failed" | "protocol_error" | "operation_failed" | "outcome_unknown" | "cancelled" | "unauthorized" | "closed" | "internal" | "internal_error";
+export type ResidentRuntimeCallOutcome = "not_started" | "unknown";
+/** Stable error returned by the resident daemon's typed Runtime gateway. */
+export declare class ResidentRuntimeCallError extends Error {
+    readonly code: ResidentRuntimeCallErrorCode;
+    readonly status?: number | undefined;
+    readonly outcome?: ResidentRuntimeCallOutcome;
+    constructor(code: ResidentRuntimeCallErrorCode, message: string, status?: number | undefined, options?: ErrorOptions & {
+        outcome?: ResidentRuntimeCallOutcome;
+    });
+}
+/** Connect to the one resident daemon, starting its supervisor when absent. */
+export declare function ensureResidentDaemon(): Promise<ResidentDaemon>;
+/** Read the stable public identity of the single resident daemon. */
+export declare function getResidentDaemonIdentity(): Promise<ResidentDaemonIdentity>;
+/** Read the transport-independent status of the resident daemon process. */
+export declare function getResidentDaemonRuntimeStatus(): Promise<DaemonStatus>;
+/** Create one pairing offer on the resident daemon for a selected reachable route. */
+export declare function createResidentRemoteRuntimePairingOffer(input?: {
+    clientLabel?: string;
+    address?: string;
+}): Promise<PairingOffer>;
+/** List redacted client grants accepted by the resident daemon. */
+export declare function listResidentRemoteRuntimeClients(): Promise<ResidentRemoteRuntimeClientGrant[]>;
+/** Revoke one resident-daemon client grant and close its active channels. */
+export declare function revokeResidentRemoteRuntimeClient(grantId: string): Promise<{
+    revoked: true;
+    closedConnections: number;
+}>;
+/** List local and paired Runtime targets through the resident daemon BFF. */
+export declare function listResidentRuntimeTargets(): Promise<ResidentRuntimeTargetView[]>;
+/** Pair a target; the offer remains inside the loopback management request. */
+export declare function pairResidentRuntimeTarget(offer: unknown, displayName?: string): Promise<ResidentRuntimeTargetTestResult>;
+export declare function testResidentRuntimeTarget(selector: string): Promise<ResidentRuntimeTargetTestResult>;
+export declare function forgetResidentRuntimeTarget(daemonId: string): Promise<{
+    forgotten: true;
+}>;
+/**
+ * Invoke one typed Runtime method through the single resident daemon.
+ *
+ * The short-lived CLI process never reads Direct credentials or opens a
+ * remote socket. The resident daemon owns target resolution, Local/Direct
+ * connection reuse, authorization and no-retry outcome semantics.
+ */
+export declare function callResidentRuntime<M extends RemoteRuntimeRpcMethod>(selectorInput: string, method: M, params: RemoteRuntimeRpcParams<M>, options?: {
+    signal?: AbortSignal;
+}): Promise<RemoteRuntimeRpcResultFor<M>>;
+/** Read the current managed Session credential without exposing it in output. */
+export declare function readManagedRuntimeBrowserCredential(env?: NodeJS.ProcessEnv): Promise<RuntimeBrowserBootstrapCredential>;
+/** Return undefined only when the process has no managed Session context at all. */
+export declare function readOptionalManagedRuntimeBrowserCredential(env?: NodeJS.ProcessEnv): Promise<RuntimeBrowserBootstrapCredential | undefined>;
+/**
+ * Invoke Browser control for the caller's own managed Session. Unlike the
+ * operator Runtime gateway, this path never reads or sends daemon management
+ * authority and cannot select a remote Runtime or another Session.
+ */
+export declare function callManagedRuntimeBrowser<M extends RemoteRuntimeRpcMethod>(credential: RuntimeBrowserBootstrapCredential, method: M, params: RemoteRuntimeRpcParams<M>, options?: {
+    signal?: AbortSignal;
+}): Promise<RemoteRuntimeRpcResultFor<M>>;
+/** Resolve native CDP for the caller's own Session on this Runtime only. */
+export declare function getResidentRuntimeLocalBrowserEndpoint(options?: {
+    env?: NodeJS.ProcessEnv;
+    sessionId?: string;
+    signal?: AbortSignal;
+}): Promise<RuntimeBrowserEndpointDescriptor>;
+/** Invoke one command declared by an installed plugin through the resident daemon. */
+export declare function invokeResidentPluginCommand(pluginId: string, args: readonly string[], options?: InvokeResidentPluginCommandOptions): Promise<ResidentPluginCommandResult>;