@rynx-ai/runtime 0.1.11-beta.24 → 0.1.11-beta.26

package/dist/host.d.ts

@@ -1,4 +1,4 @@
-import { type ResolvedExecutionSnapshot, type ResolvedExecutionBudget, type RuntimeUserInput, type LiveSessionFailure, type SessionWorkspaceSnapshot, type SessionInteractionResolution, type SessionEvent } from "@rynx-ai/core";
+import { type ResolvedExecutionSnapshot, type ResolvedExecutionBudget, type RuntimeTurnOptions, type RuntimeUserInput, type SessionCollaborationMode, type LiveSessionFailure, type SessionWorkspaceSnapshot, type SessionInteractionResolution, type SessionEvent } from "@rynx-ai/core";
 import { type AgentRuntimeId } from "@rynx-ai/core";
 import { type AppConfig } from "@rynx-ai/core";
 import { createCodexChildEnv } from "./codex-child-env.js";
@@ -189,6 +189,13 @@ export declare class LocalAgentHost implements CodexCapabilities {
     private createAppServerClient;
     /** Resolve a pending native question/approval without opening a new Turn. */
     resolveInteraction(localThreadId: string, interactionId: string, resolution: SessionInteractionResolution): Promise<ResolveInteractionResult>;
+    /** Apply collaboration mode to an already-loaded Codex-lineage thread. The
+     * caller persists only after this native RPC succeeds. */
+    updateCollaborationMode(localThreadId: string, mode: SessionCollaborationMode): Promise<void>;
+    /** Apply one explicit collaboration mode to the current native thread and
+     * remember only a successful RPC. A supplied client is already initialized
+     * and remains owned by its caller (used by cold-resume preload). */
+    private applyLiveCollaborationMode;
     /**
      * The command to run in a session's live terminal so it co-drives the codex
      * app-server thread (Phase D). Returns `null` when live-terminal is off, the
@@ -227,7 +234,7 @@ export declare class LocalAgentHost implements CodexCapabilities {
      * Fresh sessions already connected their discovery listener before launch;
      * this is therefore an idempotent no-op for them and for a healthy observer. */
     startLiveCodexObserver(localThreadId: string): void;
-    /** Omnigent treats the forwarder as a required component of one native
+    /** reference implementation treats the forwarder as a required component of one native
      * lifecycle: if its transport dies, it closes the app-server instead of
      * accepting turns that can no longer reach the canonical mirror. */
     private failObserverLifecycle;
@@ -237,7 +244,7 @@ export declare class LocalAgentHost implements CodexCapabilities {
      * Subscribe the forwarder connection to a thread (reference implementation's
      * `_subscribe_until_ready`). A fresh TUI thread has no rollout until its first
      * turn, so `thread/resume` is retried: park until the forwarder observes the
-     * thread active, then retry. Like Omnigent, the first attempt always uses
+     * thread active, then retry. Like reference implementation, the first attempt always uses
      * `excludeTurns`: a known-session cold resume therefore never reconstructs
      * historical running/completed state. Only a fresh thread whose first attempt
      * failed as not-ready retries without `excludeTurns`, backfilling the newly
@@ -273,7 +280,7 @@ export declare class LocalAgentHost implements CodexCapabilities {
      * forwarder). Park-until-ready (~60s), aligning reference implementation's executor waiting for
      * the bridge instead of a short race that falls back to a second output path.
      */
-    injectMessage(localThreadId: string, input: RuntimeUserInput | string): Promise<InjectResult>;
+    injectMessage(localThreadId: string, input: RuntimeUserInput | string, options?: RuntimeTurnOptions): Promise<InjectResult>;
     /**
      * Interrupt the session's active turn — the web Stop button. codex: the
      * app-server `turn/interrupt` on the active `{threadId, turnId}` (exactly what
@@ -288,7 +295,7 @@ export declare class LocalAgentHost implements CodexCapabilities {
         deferClaudeInteractionCleanup?: boolean;
     }): void;
     /** Tear down one codex-lineage native runtime without deleting its durable
-     * session-store binding. Omnigent couples its auxiliary Terminal, observer,
+     * session-store binding. reference implementation couples its auxiliary Terminal, observer,
      * forwarder and per-session app-server as one disposable runtime envelope;
      * the next message recreates that envelope and cold-resumes the native id. */
     teardownLiveCodexSession(localThreadId: string, error?: Error): boolean;
@@ -321,8 +328,9 @@ export declare class LocalAgentHost implements CodexCapabilities {
      *  would fail and (pre-reference implementation) fall through to a second output path. */
     private waitInjector;
     /** Attach a session's tmux pane injector (from the runner-child, which owns the
-     *  terminal registry — the host does not hold tmux). Ignored for codex sessions
-     *  (they inject via the app-server). Idempotent. */
+     *  terminal registry — the host does not hold tmux). Claude uses it for normal
+     *  message injection; Codex uses it only to dismiss the exact TUI-local Plan
+     *  picker after its synthetic Web form is submitted. Idempotent. */
     attachTerminalInjector(localThreadId: string, injector: TerminalInjector): void;
     /** Close an active native response when its terminal or runner disappears. */
     failLiveSession(localThreadId: string, error: Error): boolean;