@omercnet/paseo-omp 4.0.0-next.313.1 → 4.0.0-next.317.1

package/OVERVIEW.md

@@ -2,7 +2,7 @@ OMP adds an agent provider for the OMP coding agent, plus an OMP sidebar and wor
 
 ## Setup
 
-- Paseo ^0.13.0.
+- Paseo ^0.14.0.
 - OMP 18.1.15 or newer on the daemon host, speaking RPC protocol v2. Older runtimes are rejected.
 - Provider options let you change the OMP command, set environment values, choose an output redaction mode and set a session directory and timeout. Named OMP profiles appear as separate `OMP · <profile>` providers.
 

package/README.md

@@ -24,7 +24,7 @@ before capture.
 
 ## Quick start
 
-Requirements: Paseo `^0.13.0`, OMP `18.1.15` or newer, and OMP RPC protocol v2. Workspace discovery passes `includeBackground`, which throws on hosts that do not advertise `features.backgroundWorkspaces`; every 0.13 host does.
+Requirements: Paseo `^0.14.0`, OMP `18.1.15` or newer, and OMP RPC protocol v2. Workspace discovery passes `includeBackground`, which throws on hosts that do not advertise `features.backgroundWorkspaces`; every 0.14 host does.
 
 ```bash
 paseo plugin install npm:@omercnet/paseo-omp@<version>
@@ -40,7 +40,7 @@ Open the **OMP** sidebar to review the provider-profile contract, choose which c
 - [Core-provider issue and parity audit](docs/core-provider-issue-audit.md)
 - [Release checklist](docs/release-checklist.md)
 
-The plugin uses public Paseo 0.13 provider and client contracts and registers distinct `omp-plugin` and `omp-plugin-<profile>` identities; it does not modify the bundled `omp` provider.
+The plugin uses public Paseo 0.14 provider and client contracts and registers distinct `omp-plugin` and `omp-plugin-<profile>` identities; it does not modify the bundled `omp` provider.
 
 ## Named OMP profiles
 
@@ -54,20 +54,20 @@ Profile selection is request-local: concurrent clients cannot change each other'
 
 ## Paseo provider SDK coverage
 
-The capability inventory is pinned to `@getpaseo/plugin` 0.13.0, with nightly compatibility checks
+The capability inventory is pinned to `@getpaseo/plugin` 0.14.0-beta.1, with nightly compatibility checks
 against the latest and beta channels. Provider capability scoring covers
-all 17 entries in the SDK's `PROVIDER_CAPABILITIES`; the separate provider/client SDK table below
+all 18 entries in the SDK's `PROVIDER_CAPABILITIES`; the separate provider/client SDK table below
 also tracks the registration, screen, and sidebar APIs introduced in 0.11. This measures strict SDK surface
 coverage, not general product quality.
 
-**Provider capability completeness: 61.8%.** The provider advertises 11 of 17 capabilities (64.7%); ten are complete and `session.configure` is partial.
+**Provider capability completeness: 63.9%.** The provider advertises 12 of 18 capabilities (66.7%); eleven are complete and `session.configure` is partial.
 
 Scoring is deliberately mechanical so releases remain comparable:
 
 - **100%**: advertised, implemented end to end, and covered by automated provider tests.
 - **50%**: advertised with a meaningful subset, but at least one material SDK operation is rejected.
 - **0%**: not advertised; requests are rejected rather than silently approximated.
-- Overall completeness is the unweighted arithmetic mean of all 17 SDK capability rows.
+- Overall completeness is the unweighted arithmetic mean of all 18 SDK capability rows.
 
 | SDK capability | Completeness | Support and gap |
 | --- | ---: | --- |
@@ -77,6 +77,7 @@ Scoring is deliberately mechanical so releases remain comparable:
 | `prompt.output_schema` | **0%** | Not advertised. OMP has no equivalent structured-output contract; `outputSchema` fails visibly. |
 | `prompt.steer` | **100%** | Native steering with turn ownership, user-message correlation, stale-target rejection, and terminal race handling. |
 | `session.archive` | **0%** | Not advertised. Paseo may archive its agent record, but OMP has no native transcript archive operation. |
+| `session.can_stop_runtime` | **100%** | Answers Paseo's idle-release safety query. Returns `false` while a turn, permission, revert, configuration change, runtime recovery, active subagent, or OMP background async work is pending, and when OMP does not report a settled state; errors and unknown sessions fail the request, which also keeps the runtime. |
 | `session.configure` | **50%** | Live model and thinking changes commit and republish native state. Live approval-mode changes require a new session, and non-empty SDK `settings` are rejected. |
 | `session.list` | **100%** | Bounded host-wide and cwd-scoped discovery, search, previews, profile-specific session roots, and cleanup-reservation guards. |
 | `session.persistence` | **100%** | Versioned opaque handles, exact resume, import, replay-before-ready, runtime recovery, and cleanup quarantine. Archived agents whose recorded workspace has been removed load read-only from their authorized transcript when Paseo opens them with its `history` purpose, without spawning OMP or connecting MCP servers; interactive create and resume still require the workspace. |
@@ -125,7 +126,9 @@ Existing agents whose provider is `omp` remain owned by the bundled provider. Ne
 
 OMP `18.1.15` is the oldest version tested end to end. The direct provider's hard compatibility gate is `rpc-ui` protocol v2: metadata-free legacy ready frames and v1-only runtimes are rejected before a provider session opens because they cannot support the advertised persistence and conversation-rewind capabilities. Typed tool approvals remain capability-gated and fall back as described above. For terminal completion, a matching `agent_end.requestId` is authoritative and mismatches are ignored before state changes. Released OMP 18.2.x builds that omit that field use an ordered fallback requiring a fresh correlated native user entry followed by current-turn assistant activity, an idle non-compacting runtime, and no conflicting permission, tool, steer, or child-session work. Ambiguous events while OMP is active are ignored; unresolved ambiguity after confirmed idle fails only the Paseo turn. This trades a bounded residual same-agent stale-event risk for compatibility with released OMP instead of terminating and lazily restarting the runtime after every later prompt. Paseo clients, including mobile clients inside reconnect grace, do not own or terminate the daemon-managed OMP session.
 
-Paseo 0.13 is the minimum supported release. The controlled Docker canary is pinned to official 0.13.0; nightly SDK checks cover the latest and beta channels. The canary preserves nested provider-subagent ancestry and spawning-tool links, and validates npm-managed plugin sources, platform-owned external URL opening, and whole-item timeline transforms before Overview grouping.
+Paseo 0.14 is the minimum supported release. The controlled Docker canary is pinned to official 0.14.0-beta.1; nightly SDK checks cover the latest and beta channels. The canary preserves nested provider-subagent ancestry and spawning-tool links, and validates npm-managed plugin sources, platform-owned external URL opening, and whole-item timeline transforms before Overview grouping.
+
+Paseo releases idle resumable agent runtimes after one hour; the agent stays listed as `closed` and the next prompt resumes the same OMP session. The plugin vetoes that release while the session has a running turn, a pending permission, an active subagent, or OMP background async work, and while OMP does not report a settled state (the plugin needs the `hasPendingAsyncWork` and `isSettled` fields in OMP's `get_state`; builds without them are never released). Set `agents.idleRuntimeCleanup: false` in the Paseo config to disable idle release for every provider.
 
 Install, update, disable, or remove `paseo-omp` independently of the bundled provider. Verify the provider snapshot contains `omp-plugin` after installation; a bundled `omp` entry may remain present and is not modified by this plugin.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omercnet/paseo-omp",
-  "version": "4.0.0-next.313.1",
+  "version": "4.0.0-next.317.1",
   "type": "module",
   "description": "Paseo integration for OMP, including its direct provider and workspace tooling.",
   "license": "MIT",

package/paseo-plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "paseo-omp",
   "description": "Paseo integration for OMP, including its direct provider and workspace tooling.",
-  "requirements": { "paseo": "^0.13.0" },
+  "requirements": { "paseo": "^0.14.0" },
   "build": [["node", "scripts/prepare-dependencies.mjs"]]
 }

package/server/package-version.ts

@@ -1,2 +1,2 @@
 /** Release Please keeps this bundle-safe constant aligned with package.json. */
-export const PASEO_OMP_PACKAGE_VERSION = "4.0.0-next.313.1"; // x-release-please-version
+export const PASEO_OMP_PACKAGE_VERSION = "4.0.0-next.317.1"; // x-release-please-version

package/server/provider/connection.ts

@@ -48,6 +48,7 @@ const SUPPORTED_CAPABILITIES: Readonly<Record<string, true>> = {
   "prompt.command": true,
   "prompt.image": true,
   "prompt.steer": true,
+  "session.can_stop_runtime": true,
   "session.configure": true,
   "session.list": true,
   "session.persistence": true,
@@ -65,6 +66,7 @@ const SUPPORTED_INPUTS: Readonly<Record<string, true>> = {
   "session.permission": true,
   "session.revert": true,
   "session.interrupt": true,
+  "session.can_stop_runtime": true,
   "session.close": true,
 };
 const MAX_CONNECTION_SESSIONS = 32;
@@ -1135,6 +1137,21 @@ export function createOmpConnection(
         await session.interrupt(input);
         return;
       }
+      case "session.can_stop_runtime": {
+        const session = sessions.get(input.sessionId)?.session;
+        if (!session) {
+          requestFailure(input.requestId, new OmpPublicError("Unknown OMP session"));
+          return;
+        }
+        const canStop = await session.canStopRuntime();
+        emit({
+          type: "session.can_stop_runtime",
+          requestId: input.requestId,
+          sessionId: input.sessionId,
+          canStop,
+        });
+        return;
+      }
       case "session.close": {
         const slot = sessions.get(input.sessionId);
         if (!slot) {

package/server/provider/omp-rpc-protocol.ts

@@ -1231,6 +1231,8 @@ export const OmpSessionStateSchema = z.object({
   thinkingLevel: OmpCurrentThinkingLevelSchema,
   isStreaming: z.boolean(),
   isCompacting: z.boolean(),
+  hasPendingAsyncWork: z.boolean().optional(),
+  isSettled: z.boolean().optional(),
   sessionId: IDENTIFIER,
   autoCompactionEnabled: z.boolean().optional(),
   contextUsage: OmpContextUsageSchema.nullable().optional().catch(undefined),
@@ -1902,6 +1904,8 @@ export function projectSessionStateResponseData(value: unknown): unknown {
     "thinkingLevel",
     "isStreaming",
     "isCompacting",
+    "hasPendingAsyncWork",
+    "isSettled",
     "sessionId",
     "autoCompactionEnabled",
     "contextUsage",

package/server/provider/registration.ts

@@ -97,6 +97,7 @@ const CAPABILITIES = [
   "prompt.command",
   "prompt.image",
   "prompt.steer",
+  "session.can_stop_runtime",
   "session.configure",
   "session.list",
   "session.persistence",

package/server/provider/session-history.ts

@@ -301,6 +301,10 @@ export class OmpHistorySession implements OmpOpenedSession {
     return Promise.resolve();
   }
 
+  canStopRuntime(): Promise<boolean> {
+    return Promise.resolve(true);
+  }
+
   beginConnectionShutdown(): void {
     this.lifetime.abort(new Error("OMP provider connection closed"));
   }

package/server/provider/session-permissions.ts

@@ -1150,6 +1150,16 @@ export class OmpSessionPermissions {
     return this.activeTurn?.turnId === pending.turnId && !this.activeTurn.terminal;
   }
 
+  hasPending(): boolean {
+    return (
+      this.pendingPermissions.size > 0 ||
+      this.inFlightPermissions.size > 0 ||
+      this.pendingToolPermissions.size > 0 ||
+      this.inFlightToolPermissions.size > 0 ||
+      this.pendingFreeformSelection !== null
+    );
+  }
+
   hasForTurn(turnId: string): boolean {
     const ownsTurn = (pending: PendingPermission | PendingToolPermission) =>
       pending.turnId === turnId;

package/server/provider/session.ts

@@ -111,6 +111,7 @@ export interface OmpOpenedSession {
   configure(input: SessionConfigureInput): Promise<void>;
   revert(input: SessionRevertInput): Promise<void>;
   interrupt(input: SessionInterruptInput): Promise<void>;
+  canStopRuntime(): Promise<boolean>;
   close(input?: SessionCloseInput): Promise<void>;
   abortOpen(): Promise<void>;
   beginConnectionShutdown(): void;
@@ -1465,6 +1466,28 @@ export class OmpProviderSession implements OmpOpenedSession {
     }
   }
 
+  async canStopRuntime(): Promise<boolean> {
+    const hasLocalWork =
+      this.closed ||
+      this.runtimeDead !== null ||
+      this.recoveryPromise !== null ||
+      this.activeTurn !== null ||
+      this.activeAbort !== null ||
+      this.revertInFlight ||
+      this.configMutationInFlight ||
+      this.permissions.hasPending() ||
+      Boolean(this.subsessions?.hasActiveChildren());
+    if (hasLocalWork) return false;
+    const state = await this.runtime.getState();
+    // OMP builds that predate these fields report neither, which keeps the runtime alive.
+    return (
+      state.isSettled === true &&
+      state.hasPendingAsyncWork === false &&
+      !state.isStreaming &&
+      !state.isCompacting
+    );
+  }
+
   async interrupt(input: SessionInterruptInput): Promise<void> {
     const turn = this.activeTurn;
     if (!turn) {