@rynx-ai/server 0.1.0 → 0.1.10-beta.2

package/dist/control-api.d.ts

@@ -1,8 +1,16 @@
 import Router from "@koa/router";
 import { type AgentSpec, type AuthMaterial, type ConversationRuntime, type MachineSessionRecord, type AgentRuntimeId, type SessionBus, type SessionLogStore, type SkillInstallRecipe } from "@rynx-ai/core";
 import type { ControlChannel, ControlChannelType, ControlInstanceConfig, ControlAgentSummary, SkillSummary, SkillDetail } from "@rynx-ai/protocol/control";
+import type { SessionInteractionResolution } from "@rynx-ai/protocol";
+import { type RemoteRuntimeRpcParams, type RemoteRuntimeRpcResultFor } from "@rynx-ai/protocol/remote-runtime-rpc";
 import type { CodexSessionStore, InjectOutcome } from "@rynx-ai/runtime";
 import type { ChannelManager } from "./channel-manager.js";
+import type { DaemonManagementHost, RemoteRuntimeAdminHost, RuntimeTargetControlHost, RuntimeConnectionResolverHost, RuntimeLocalBrowserAutomationHost } from "./server.js";
+import type { ProviderCliManagementHost } from "./provider-cli-host.js";
+import { type DaemonRuntimeHost } from "./remote-runtime.js";
+import { SessionRuntimeIndex } from "./session-runtime-index.js";
+import type { SessionEmulatorService } from "./session-emulator-service.js";
+import { type RuntimeWebAccessPolicy } from "./runtime-web-auth.js";
 export interface ControlEmulatorDeps {
     doctor(): Promise<unknown>;
     devices(): Promise<unknown[]>;
@@ -67,6 +75,7 @@ export interface ControlEmulatorDeps {
     }>;
     liveTouch?(input: {
         device?: string;
+        signal?: AbortSignal;
     }): Promise<{
         ok: true;
         backend: "ios" | "android";
@@ -78,6 +87,17 @@ export interface ControlEmulatorDeps {
         }): void;
         close(): void;
     }>;
+    imageStream?(input: {
+        device?: string;
+        signal?: AbortSignal;
+    }): Promise<{
+        ok: true;
+        backend: "ios" | "android";
+        device: string;
+        contentType: "image/jpeg";
+        nextFrame(): Promise<Buffer>;
+        close(): void;
+    }>;
     readScreenshotFile?(input: {
         file: string;
     }): Promise<{
@@ -108,7 +128,10 @@ export interface ControlPlaneDeps {
     }): void;
     removeChannel(id: string): void;
     /** Run a channel type's authorize flow; resolves with the options to persist. */
-    authorizeChannel(type: string, emit: (material: AuthMaterial) => void, signal: AbortSignal): Promise<Record<string, unknown>>;
+    authorizeChannel(type: string, context: {
+        instanceId?: string;
+        config: Record<string, unknown>;
+    }, emit: (material: AuthMaterial) => void, signal: AbortSignal): Promise<Record<string, unknown>>;
     listInstancesConfig(): ControlInstanceConfig[];
     createInstance(input: {
         channelId: string;
@@ -150,11 +173,30 @@ export interface ControlPlaneDeps {
     createSessionMeta(meta: StoredSessionMeta): void;
     setSessionTitle(id: string, title: string): void;
     removeSessionMeta(id: string): void;
+    consumeControlLink?(token: string): {
+        sessionId: string;
+    } | null;
 }
 /** Persisted meta for an agent session — the unified machine-session record.
  *  Runtime `status` is held separately by the server (idle after a restart);
  *  transcripts persist via {@link SessionLogStore}. */
 export type StoredSessionMeta = MachineSessionRecord;
+/** Session-owned resource fence shared by canonical and legacy local deletion paths. */
+export interface SessionResourceLifecycle {
+    beforeDelete?(sessionId: string): void | Promise<void>;
+    afterDelete?(sessionId: string): void | Promise<void>;
+}
+/** In-process Local Runtime resource authority. Direct targets continue through
+ * the bounded Remote Runtime RPC transport; Local avoids serial base64 frames. */
+export interface LocalSessionResourceHost {
+    resourcePolicy(sessionId: string): Promise<RemoteRuntimeRpcResultFor<"session.resource.policy.get">> | RemoteRuntimeRpcResultFor<"session.resource.policy.get">;
+    beginResourceUpload(input: RemoteRuntimeRpcParams<"session.resource.upload.begin">): Promise<RemoteRuntimeRpcResultFor<"session.resource.upload.begin">>;
+    writeResourceUploadChunk(input: RemoteRuntimeRpcParams<"session.resource.upload.chunk">): Promise<RemoteRuntimeRpcResultFor<"session.resource.upload.chunk">>;
+    commitResourceUpload(input: RemoteRuntimeRpcParams<"session.resource.upload.commit">): Promise<RemoteRuntimeRpcResultFor<"session.resource.upload.commit">>;
+    getResource(input: RemoteRuntimeRpcParams<"session.resource.get">): Promise<RemoteRuntimeRpcResultFor<"session.resource.get">>;
+    readResource(input: RemoteRuntimeRpcParams<"session.resource.read">): Promise<RemoteRuntimeRpcResultFor<"session.resource.read">>;
+    deleteResource(input: RemoteRuntimeRpcParams<"session.resource.delete">): Promise<RemoteRuntimeRpcResultFor<"session.resource.delete">>;
+}
 export declare function createControlRouter(opts: {
     manager: ChannelManager;
     deps: ControlPlaneDeps;
@@ -162,11 +204,10 @@ export declare function createControlRouter(opts: {
     runtime?: ConversationRuntime;
     sessionBus?: SessionBus;
     sessionLog?: SessionLogStore;
-    /** Used to stop a session's runner on close, resolve interactive approvals,
+    /** Used to stop a session's runner on close, resolve active interactions,
      *  and (codex-native live mode) bring up + inject into a session's forwarder. */
     runnerManager?: {
         stopRunner(localThreadId: string): void;
-        resolveApproval?(localThreadId: string, approvalId: string, decision: "acceptForSession" | "accept" | "decline" | "cancel"): void;
         ensureLiveSession?(localThreadId: string, opts?: {
             cwd?: string;
             cols?: number;
@@ -175,14 +216,45 @@ export declare function createControlRouter(opts: {
             agentName?: string;
             agentSpec?: AgentSpec;
         }): Promise<boolean>;
+        lastLiveSessionError?(localThreadId: string): string | undefined;
         injectMessage?(localThreadId: string, text: string): Promise<InjectOutcome>;
         interruptLiveSession?(localThreadId: string): Promise<boolean>;
+        resolveInteraction?(localThreadId: string, interactionId: string, resolution: SessionInteractionResolution): Promise<{
+            disposition: "applied" | "already_resolved" | "not_found" | "invalid";
+        }>;
     };
     /** Global codex/claude session store. Lets the control plane resume a
      *  non-console session on its original runtime/model/cwd binding. */
     sessionStore?: CodexSessionStore;
+    /** Trusted, cached plugin supervisor health. No plugin RPC is awaited here. */
+    pluginRuntimeStatus?: () => unknown;
+    /** Local-host-only runtime refresh used by the core CLI after a plugin command. */
+    pluginRuntimeReload?: (pluginId: string) => Promise<unknown>;
+    /** Idempotent local-host-only readiness check for an unchanged plugin runtime. */
+    pluginRuntimeEnsure?: (pluginId: string) => Promise<unknown>;
+    /** Complete local authority; its token is published only in the mode-0600 endpoint file. */
+    daemonManagement?: DaemonManagementHost;
+    /** Runtime application port shared by future Local and Direct bindings. */
+    remoteRuntime?: DaemonRuntimeHost;
+    /** Loopback-only pairing/client-grant administration. */
+    remoteRuntimeAdmin?: RemoteRuntimeAdminHost;
+    /** Local BFF authority for Local and explicitly paired Direct Runtime targets. */
+    runtimeTargetControl?: RuntimeTargetControlHost;
+    /** Browser-facing access boundary. Internal daemon management remains loopback-only. */
+    runtimeWebAccess?: RuntimeWebAccessPolicy;
+    /** Resolves an explicit Runtime selector without exposing Direct credentials. */
+    runtimeConnectionResolver?: RuntimeConnectionResolverHost;
+    /** Same-daemon resource authority for the `local` selector. */
+    localSessionResources?: LocalSessionResourceHost;
+    sessionEmulators?: SessionEmulatorService;
+    /** Ends host-owned long-lived HTTP responses before the server drains. */
+    shutdownSignal?: AbortSignal;
+    sessionRuntimeIndex?: SessionRuntimeIndex;
+    sessionLifecycle?: SessionResourceLifecycle;
+    runtimeLocalBrowser?: RuntimeLocalBrowserAutomationHost;
+    providerClis?: ProviderCliManagementHost;
 }): Router;
 /** Derive a one-line session title from the first user message: collapse
- *  whitespace, trim, and truncate to `limit` chars + an ellipsis (omnigent's
+ *  whitespace, trim, and truncate to `limit` chars + an ellipsis (reference implementation's
  *  rule — no LLM call). */
 export declare function synthesizeSessionTitle(message: string, limit?: number): string;