@rynx-ai/server 0.1.11-beta.5 → 0.1.11-beta.51

package/dist/machine-session-service.d.ts

@@ -1,12 +1,12 @@
-import { type AdmissionReservation, type AgentRuntimeId, type ConversationRuntime, type ResolvedExecutionSnapshot, type SessionWorkspaceSnapshot, type SessionProviderId, type MachineSessionRecord, type ReasoningEffort, type RuntimeUserInput, type SessionBus, type SessionLogStore, type SessionRegistry } from "@rynx-ai/core";
+import { type AdmissionReservation, type AgentRuntimeId, type AuditAuthSource, type ConversationRuntime, type ResolvedExecutionSnapshot, type SessionWorkspaceSnapshot, type SessionProviderId, type MachineSessionRecord, type LiveSessionFailure, type ReasoningEffort, type RuntimeTurnOptions, type RuntimeUserInput, type SessionCollaborationMode, type SessionBus, type SessionLogStore, type SessionRegistry, type SteerSignal } from "@rynx-ai/core";
 import type { SequencedSessionEvent, SessionEvent, SessionInteractionResolution, SessionItem, UserContentPart } from "@rynx-ai/protocol";
-import type { RemoteRuntimeSessionResourceDeleteParams, RemoteRuntimeSessionResourceDeleteResult, RemoteRuntimeSessionResourceGetParams, RemoteRuntimeSessionResourceGetResult, RemoteRuntimeSessionResourcePolicyResult, RemoteRuntimeSessionResourceReadParams, RemoteRuntimeSessionResourceReadResult, RemoteRuntimeSessionResourceUploadBeginParams, RemoteRuntimeSessionResourceUploadBeginResult, RemoteRuntimeSessionResourceUploadChunkParams, RemoteRuntimeSessionResourceUploadChunkResult, RemoteRuntimeSessionResourceUploadCommitParams, RemoteRuntimeSessionResourceUploadCommitResult } from "@rynx-ai/protocol/remote-runtime-rpc";
+import type { RemoteRuntimeSessionResourceDeleteParams, RemoteRuntimeSessionResourceDeleteResult, RemoteRuntimeSessionResourceGetParams, RemoteRuntimeSessionResourceGetResult, RemoteRuntimeSessionResourcePolicyResult, RemoteRuntimeSessionResourceReadParams, RemoteRuntimeSessionResourceReadResult, RemoteRuntimeSessionResourceUploadBeginParams, RemoteRuntimeSessionResourceUploadBeginResult, RemoteRuntimeSessionResourceUploadChunkParams, RemoteRuntimeSessionResourceUploadChunkResult, RemoteRuntimeSessionResourceUploadCommitParams, RemoteRuntimeSessionResourceUploadCommitResult, RemoteRuntimeSessionFileGetParams, RemoteRuntimeSessionFileGetResult, RemoteRuntimeSessionFileReadParams, RemoteRuntimeSessionFileReadResult, RemoteRuntimeSessionWorkspaceFileGetParams, RemoteRuntimeSessionWorkspaceFileGetResult, RemoteRuntimeSessionWorkspaceFileReadParams, RemoteRuntimeSessionWorkspaceFileReadResult } from "@rynx-ai/protocol/remote-runtime-rpc";
 import type { ControlAgentModelOption, ControlAgentSummary, ControlSessionInteractionResolveDisposition, ControlSessionRuntimeSnapshot, SessionPermissionPreset } from "@rynx-ai/protocol/control";
 import { type RemoteRuntimeSessionInterruptResult, type RemoteRuntimeSessionExecutionGetResult, type RemoteRuntimeSessionExecutionUpdateParams, type RemoteRuntimeSessionExecutionUpdateResult, type RemoteRuntimeSessionLaunchOptionsListResult, type RemoteRuntimeSessionListParams, type RemoteRuntimeSessionListResult, type RemoteRuntimeSessionSnapshotParams } from "@rynx-ai/protocol/remote-runtime-rpc";
-import type { CodexRuntimeStatus, InjectOutcome } from "@rynx-ai/runtime";
+import type { CodexRuntimeStatus, InjectResult } from "@rynx-ai/runtime";
+import type { MachineSessionPendingInput, MachineSessionPendingInputPort } from "./session-pending-inputs.js";
 export interface MachineSessionRuntimeStatePort {
     snapshot(sessionId: string): ControlSessionRuntimeSnapshot;
-    beginResponseHandoff?(sessionId: string, responseId: string): () => void;
     remove?(sessionId: string): void;
 }
 export interface MachineSessionInterruptPort {
@@ -34,6 +34,17 @@ export interface MachineSessionPreparedInput {
     input: RuntimeUserInput;
     title: string;
     operationState?: MachineSessionMessageOperationState;
+    responseId?: string;
+    messageItemId?: string;
+    operationExecution?: MachineSessionRunExecutionSnapshot;
+}
+export interface MachineSessionRunExecutionSelection {
+    model?: string | null;
+    reasoningEffort?: ReasoningEffort | null;
+}
+export interface MachineSessionRunExecutionSnapshot {
+    model: string | null;
+    reasoningEffort: ReasoningEffort | null;
 }
 /** Target-daemon resource authority. Transfer methods are deliberately chunked
  * below the 64 KiB Direct Runtime frame; `prepareInput` is the only method that
@@ -46,9 +57,22 @@ export interface MachineSessionResourcePort {
     getResource(input: RemoteRuntimeSessionResourceGetParams): Promise<RemoteRuntimeSessionResourceGetResult>;
     readResource(input: RemoteRuntimeSessionResourceReadParams): Promise<RemoteRuntimeSessionResourceReadResult>;
     deleteResource(input: RemoteRuntimeSessionResourceDeleteParams): Promise<RemoteRuntimeSessionResourceDeleteResult>;
-    prepareInput(sessionId: string, content: UserContentPart[], clientMessageId?: string): Promise<MachineSessionPreparedInput>;
-    markMessageInjecting(sessionId: string, clientMessageId: string): void | Promise<void>;
-    markMessageInjected(sessionId: string, clientMessageId: string): void | Promise<void>;
+    resolveCommittedLocalPath?(sessionId: string, resourceId: string): string | Promise<string>;
+    prepareInput(sessionId: string, content: UserContentPart[], clientMessageId?: string, operationExecution?: {
+        selection: MachineSessionRunExecutionSelection;
+        snapshot: MachineSessionRunExecutionSnapshot;
+    }): Promise<MachineSessionPreparedInput>;
+    markMessageInjecting(sessionId: string, clientMessageId: string, identity?: {
+        responseId: string;
+        messageItemId: string;
+    }): void | Promise<void>;
+    markMessageInjected(sessionId: string, clientMessageId: string, identity?: {
+        responseId: string;
+    }): void | Promise<void>;
+    markMessageMirrored(sessionId: string, clientMessageId: string, identity: {
+        responseId: string;
+        messageItemId: string;
+    }): void | Promise<void>;
     markMessageOutcomeUnknown(sessionId: string, clientMessageId: string, reason: string): void | Promise<void>;
     markMessageFailedNotStarted(sessionId: string, clientMessageId: string, reason: string): void | Promise<void>;
     deleteSession(sessionId: string): void | Promise<void>;
@@ -68,8 +92,13 @@ export interface MachineSessionRunnerPort {
         execution?: ResolvedExecutionSnapshot;
     }): Promise<boolean>;
     lastLiveSessionError?(sessionId: string): string | undefined;
-    injectMessage(sessionId: string, input: RuntimeUserInput | string): Promise<InjectOutcome>;
+    lastLiveSessionFailure?(sessionId: string): LiveSessionFailure | undefined;
+    injectMessage(sessionId: string, input: RuntimeUserInput | string, options?: RuntimeTurnOptions): Promise<InjectResult>;
+    updateCollaborationMode?(sessionId: string, mode: SessionCollaborationMode): Promise<void>;
     stopRunner(sessionId: string): void;
+    /** Full native teardown. Completion proves the runner child and its tmux/app-server
+     * descendants have exited before durable Session identity is removed. */
+    terminateLiveSession?(sessionId: string): Promise<boolean>;
     resolveInteraction(sessionId: string, interactionId: string, resolution: SessionInteractionResolution): Promise<{
         disposition: ControlSessionInteractionResolveDisposition;
     }>;
@@ -131,7 +160,7 @@ export interface MachineSessionForkStorePort {
 }
 export interface MachineSessionServicePorts {
     registry: Pick<SessionRegistry, "create" | "get" | "list" | "setTitle" | "setExecution" | "remove">;
-    log: Pick<SessionLogStore, "list" | "listSessions" | "snapshot" | "deleteSession">;
+    log: Pick<SessionLogStore, "list" | "get" | "listSessions" | "snapshot" | "deleteSession">;
     events: Pick<SessionBus, "subscribe"> & Partial<Pick<SessionBus, "close">>;
     /** Canonical persistence + fan-out for user turns accepted before a native
      * Terminal has finished starting. */
@@ -147,6 +176,9 @@ export interface MachineSessionServicePorts {
     agents?: MachineSessionAgentCatalogPort;
     /** Durable first messages that must not reach a Provider setup prompt. */
     pendingMessages?: MachineSessionPendingMessagePort;
+    /** Process-live optimistic inputs awaiting the native transcript's single
+     * durable write. Shared with the mirror and snapshot paths. */
+    pendingInputs?: MachineSessionPendingInputPort;
     resources?: MachineSessionResourcePort;
     /** Native Session execution belongs to the target daemon, never the caller. */
     execution?: {
@@ -154,7 +186,7 @@ export interface MachineSessionServicePorts {
         resolve(input: {
             agent?: string;
             provider?: SessionProviderId;
-            model?: string;
+            model?: string | null;
             reasoningEffort?: ReasoningEffort;
             permissionPreset?: SessionPermissionPreset;
             cwd: string;
@@ -200,13 +232,16 @@ export interface MachineSessionSnapshotPage {
     sessionId: string;
     /** Canonical daemon-owned items; the Direct adapter projects payloads later. */
     items: SessionItem[];
+    /** Web-composer inputs forwarded to the native Provider but not yet observed
+     * in its transcript. Replayed as temporary bubbles after a client rebind. */
+    pendingInputs: MachineSessionPendingInput[];
     runtime: ControlSessionRuntimeSnapshot;
     hasMore: boolean;
     nextAfterId?: string;
 }
 export type MachineSessionInterruptResult = RemoteRuntimeSessionInterruptResult;
 interface MachineSessionCreateOptions {
-    model?: string;
+    model?: string | null;
     reasoningEffort?: ReasoningEffort;
     permissionPreset?: SessionPermissionPreset;
     title?: string;
@@ -239,11 +274,27 @@ export interface MachineSessionNativeRotationInput {
 export interface MachineSessionMessageResult {
     ok: true;
     injected: true;
+    pendingId?: string;
+    responseId?: string;
+    replayed?: boolean;
+    operationExecution?: MachineSessionRunExecutionSnapshot;
 }
 export interface MachineSessionMessageInput {
     message?: string;
     content?: UserContentPart[];
     clientMessageId?: string;
+    /** Optional Turn execution selection. Applied inside the same admission and
+     * idempotency fence as the input, never before replay detection. */
+    execution?: MachineSessionRunExecutionSelection;
+}
+export interface StartedMachineSessionRun {
+    /** Native identity when admission can return it synchronously. Transcript-
+     * backed runtimes publish it later on the canonical event stream. */
+    responseId?: string;
+    provider: SessionProviderId;
+    model: string | null;
+    authSource: AuditAuthSource;
+    generator: AsyncGenerator<SessionEvent>;
 }
 export interface MachineSessionMessageEnqueueResult {
     ok: true;
@@ -275,7 +326,14 @@ export type MachineSessionServiceFailureCode = "not_found" | "failed_preconditio
 export declare class MachineSessionServiceFailure extends Error {
     readonly code: MachineSessionServiceFailureCode;
     readonly detail?: string | undefined;
-    constructor(code: MachineSessionServiceFailureCode, message: string, detail?: string | undefined);
+    readonly runtimeFailure?: LiveSessionFailure | undefined;
+    /** True only when retrying the same operation can succeed without changing
+     * its payload. Used by durable mirror delivery to preserve transient data. */
+    readonly retryable: boolean;
+    constructor(code: MachineSessionServiceFailureCode, message: string, detail?: string | undefined, runtimeFailure?: LiveSessionFailure | undefined, 
+    /** True only when retrying the same operation can succeed without changing
+     * its payload. Used by durable mirror delivery to preserve transient data. */
+    retryable?: boolean);
 }
 /** Application boundary shared by an in-process Local adapter and Direct RPC. */
 export declare class MachineSessionService {
@@ -291,6 +349,7 @@ export declare class MachineSessionService {
     private readonly pendingDeliveries;
     private readonly cancelledPendingDeliveries;
     private readonly forkTasks;
+    private readonly sessionMutationTails;
     constructor(ports: MachineSessionServicePorts, options?: MachineSessionServiceOptions);
     list(input?: MachineSessionListInput): Promise<MachineSessionListPage>;
     snapshot(input: MachineSessionSnapshotInput): Promise<MachineSessionSnapshotPage>;
@@ -311,10 +370,16 @@ export declare class MachineSessionService {
     launchOptions(): Promise<RemoteRuntimeSessionLaunchOptionsListResult>;
     /** Read the effective model defaults used for the next turn. */
     executionSettings(sessionIdInput: string): Promise<RemoteRuntimeSessionExecutionGetResult>;
-    /** Replace only the model defaults of an idle Session. The runner is closed
-     * so every Provider resumes its native context with the new settings on the
-     * next turn. */
+    /** Replace the defaults for the next new Turn. Codex-lineage Providers keep
+     * their live runner: the host applies changed native thread settings under
+     * its injection lock immediately before the next `turn/start`. Claude still
+     * needs an idle cold resume because its live CLI has no confirmed settings
+     * update boundary. Provider CLIs own model availability validation. */
     updateExecutionSettings(input: RemoteRuntimeSessionExecutionUpdateParams): Promise<RemoteRuntimeSessionExecutionUpdateResult>;
+    private replaceExecutionSettings;
+    /** Persist a mode changed from the native TUI before its reflected event is
+     * fanned out to Web clients. Unknown/deleted and Claude Sessions are ignored. */
+    recordNativeCollaborationMode(sessionIdInput: string, mode: SessionCollaborationMode): void;
     /** Create target-owned Session identity from one Agent preset or direct Provider. */
     create(input: MachineSessionCreateInput): Promise<MachineSessionCreateResult>;
     private createAdmitted;
@@ -331,7 +396,15 @@ export declare class MachineSessionService {
     private assertForkableSource;
     /** Inject one turn through the target daemon's native single-writer runner. */
     sendMessage(sessionIdInput: string, messageInput: string | MachineSessionMessageInput): Promise<MachineSessionMessageResult>;
+    /** Start a turn and return only that response's canonical event stream. */
+    startRun(sessionIdInput: string, messageInput: string | MachineSessionMessageInput, options?: {
+        signal?: AbortSignal;
+        steer?: SteerSignal;
+        collaborationMode?: SessionCollaborationMode;
+    }): Promise<StartedMachineSessionRun>;
     private sendMessageAdmitted;
+    private sendMessageAdmittedSerial;
+    private withSessionMutation;
     resourcePolicy(sessionIdInput: string): RemoteRuntimeSessionResourcePolicyResult;
     beginResourceUpload(input: RemoteRuntimeSessionResourceUploadBeginParams): Promise<RemoteRuntimeSessionResourceUploadBeginResult>;
     writeResourceUploadChunk(input: RemoteRuntimeSessionResourceUploadChunkParams): Promise<RemoteRuntimeSessionResourceUploadChunkResult>;
@@ -339,6 +412,12 @@ export declare class MachineSessionService {
     getResource(input: RemoteRuntimeSessionResourceGetParams): Promise<RemoteRuntimeSessionResourceGetResult>;
     readResource(input: RemoteRuntimeSessionResourceReadParams): Promise<RemoteRuntimeSessionResourceReadResult>;
     deleteResource(input: RemoteRuntimeSessionResourceDeleteParams): Promise<RemoteRuntimeSessionResourceDeleteResult>;
+    resolveResourcePath(sessionIdInput: string, resourceId: string): Promise<string>;
+    getFile(input: RemoteRuntimeSessionFileGetParams): Promise<RemoteRuntimeSessionFileGetResult>;
+    readFile(input: RemoteRuntimeSessionFileReadParams): Promise<RemoteRuntimeSessionFileReadResult>;
+    getWorkspaceFile(input: RemoteRuntimeSessionWorkspaceFileGetParams): Promise<RemoteRuntimeSessionWorkspaceFileGetResult>;
+    readWorkspaceFile(input: RemoteRuntimeSessionWorkspaceFileReadParams): Promise<RemoteRuntimeSessionWorkspaceFileReadResult>;
+    private readResolvedFile;
     /** Persist the first task while login/onboarding owns the Provider TUI. The
      * delivery worker starts the pane now, waits for a real native thread, then
      * injects exactly once. `failed` is fenced as outcome_unknown and never retried. */
@@ -351,6 +430,8 @@ export declare class MachineSessionService {
     private liveSessionRequest;
     resolveInteraction(sessionIdInput: string, interactionIdInput: string, resolution: SessionInteractionResolution): Promise<MachineSessionInteractionResult>;
     delete(sessionIdInput: string): Promise<MachineSessionDeleteResult>;
+    private resolveSessionItemFile;
+    private resolveSessionWorkspaceFile;
     private requireAgents;
     private reserveAdmission;
     private withAdmission;