@rynx-ai/daemon 0.1.10 → 0.1.11-beta.10

package/dist/plugin-host-rpc.d.ts

@@ -1,5 +1,5 @@
-import { type AgentCapabilities, type AgentSessionStore, type ConversationRuntime, type SessionRegistry } from "@rynx-ai/core";
-import { type PluginAgentSummary, type PluginCapability, type PluginHostEvent, type PluginResolvedSessionExecution, type PluginSessionExecutionSnapshot, type PluginSessionInteractionResolveDisposition } from "@rynx-ai/plugin-sdk";
+import { type AdmissionReservation, type AgentSpec, type AgentCapabilities, type AgentRuntimeId, type AgentSessionStore, type ConversationRuntime, type ResolvedExecutionSnapshot, type SessionRegistry, type SessionWorkspaceSnapshot } from "@rynx-ai/core";
+import { type PluginAgentSummary, type PluginHostEvent, type PluginResolvedSessionExecution, type PluginSessionExecutionSnapshot, type PluginSessionInteractionResolveDisposition } from "@rynx-ai/plugin-sdk";
 import type { SessionInteractionResolution } from "@rynx-ai/protocol";
 import { PluginRunnerError } from "@rynx-ai/plugin-runner";
 /** Leaves ample room for the RPC envelope below the runner's 1 MiB line cap. */
@@ -12,6 +12,24 @@ export interface PluginAgentCatalogHost {
         session: PluginSessionExecutionSnapshot;
     }): Promise<PluginResolvedSessionExecution>;
 }
+/** Mutable launch selectors are accepted only at the Host boundary. The
+ * resolver turns them into immutable Session-owned snapshots before a registry
+ * row is created; none of these selectors are persisted on the Session. */
+export interface PluginSessionLaunchSelection {
+    projectId?: string;
+    managedCwd?: string;
+    workspace?: SessionWorkspaceSnapshot;
+    agent?: string;
+    config?: AgentSpec;
+    provider?: AgentRuntimeId;
+    model?: string | null;
+    reasoningEffort?: string;
+    title?: string;
+}
+export interface PluginResolvedSessionLaunch {
+    workspace: SessionWorkspaceSnapshot;
+    execution: ResolvedExecutionSnapshot;
+}
 export interface PluginHostServices {
     installationId: string;
     installationProof: {
@@ -24,21 +42,56 @@ export interface PluginHostServices {
     sessionStore: AgentSessionStore;
     sessionRegistry: SessionRegistry;
     agentCatalog: PluginAgentCatalogHost;
+    sessionLaunch: {
+        resolve(input: PluginSessionLaunchSelection): Promise<PluginResolvedSessionLaunch>;
+    };
+    sessionExecution: {
+        update(input: {
+            sessionId: string;
+            model: string | null;
+            reasoningEffort: string | null;
+        }): Promise<void>;
+    };
     interruptSession?(sessionId: string): Promise<boolean>;
+    terminateSession?(sessionId: string): Promise<boolean>;
     resolveSessionInteraction?(sessionId: string, interactionId: string, resolution: SessionInteractionResolution): Promise<{
         disposition: PluginSessionInteractionResolveDisposition;
     }>;
+    sessionFork?(input: {
+        sourceSessionId: string;
+        operationId: string;
+        title?: string;
+    }): Promise<{
+        sessionId: string;
+        disposition: "created" | "replayed";
+    }>;
+    admissionOpen?: () => boolean;
+    admissionReserve?: () => AdmissionReservation | undefined;
+    sessionPortal?: {
+        scheme: "http" | "https";
+        bindHost: string;
+        port: number;
+    };
 }
 export interface PluginHostRpcOptions {
+    /** Manifest id returned by host.info. */
     pluginId: string;
+    /** Marketplace-qualified principal used for ownership and proof scopes. */
+    principalId?: string;
     daemonInstanceId: string;
-    grants: readonly PluginCapability[];
+    productVersion: string;
+    cliVersion: string;
     services: PluginHostServices;
+    /** Canonical plugin-owned root permitted for the Workspace plugin's isolated
+     * Session directory. Omitted for every other plugin. */
+    managedWorkspaceRoot?: string;
     /** Resolving this promise is the stream's backpressure acknowledgement. */
     emit(event: PluginHostEvent): void | Promise<void>;
+    /** Bounded graceful-stop window used while disposing this Host. */
+    disposeForceAfterMs?: number;
 }
 /**
- * One authenticated plugin's capability-gated Host RPC surface.
+ * One authenticated plugin's Host RPC surface.
  *
  * This adapter is deliberately the only place that maps public string methods
  * to trusted runtime objects. The runner receives neither this class nor its
@@ -46,19 +99,29 @@ export interface PluginHostRpcOptions {
  */
 export declare class PluginHostRpc {
     private readonly pluginId;
+    private readonly principalId;
     private readonly daemonInstanceId;
-    private readonly grants;
+    private readonly productVersion;
+    private readonly cliVersion;
     private readonly services;
+    private readonly managedWorkspaceRoot;
     private readonly emit;
+    private readonly disposeForceAfterMs;
     private readonly activeRuns;
     private readonly activeSessionRuns;
     private readonly activeRunsByOperation;
     private disposed;
+    private disposePromise?;
     constructor(options: PluginHostRpcOptions);
-    call(method: string, params: unknown): Promise<unknown>;
+    call(method: string, params: unknown, signal?: AbortSignal): Promise<unknown>;
     dispose(): Promise<void>;
     private ensureSession;
+    private ensureSessionAdmitted;
+    private resolveManagedWorkspace;
+    private resolveWorkspaceSnapshot;
+    private sessionEnsureResult;
     private runSession;
+    private runSessionAdmitted;
     private pumpRun;
     private releaseRun;
     private steerSession;
@@ -72,9 +135,13 @@ export declare class PluginHostRpc {
     private withOwnedSession;
     private resolveSessionInteraction;
     private forkSession;
+    private forkSessionAdmitted;
+    private reserveAdmission;
+    private withAdmission;
     private setSessionTitle;
     private resolveAgentExecution;
     private issueControlLink;
+    private issueSessionPortalLink;
     private ownedSession;
     private isOwned;
 }