opensteer 0.9.6 → 0.9.8

package/dist/{chunk-3XBQRZZC.js → chunk-EXXRLPLI.js}

@@ -1,4 +1,4 @@
-import { filePathToUri, resolveStoragePath, encodePathSegment, ensureDirectory, pathExists, readJsonFile, writeJsonFileAtomic, normalizeTimestamp, withFilesystemLock, resolveLocalViewPreferencesPath, resolveLocalViewServiceLockDir, readLocalViewServiceState, isLocalViewServiceStateLive, clearLocalViewServiceState, getLocalViewServiceStateLiveness, clearPersistedSessionRecord, writePersistedSessionRecord, isProcessRunning, readPersistedLocalBrowserSessionRecord, buildLocalViewSessionId, selectAttachBrowserCandidate, resolveChromeExecutablePath, readDevToolsActivePort, inspectCdpEndpoint, normalizeNonEmptyString, toCanonicalJsonValue, canonicalJsonString, sha256Hex, joinStoragePath, writeBufferIfMissing, writeJsonFileExclusive, isAlreadyExistsError, readBinaryFile, listJsonFiles, expandHome, createLocalViewSessionManifest, writeLocalViewSessionManifest, deleteLocalViewSessionManifest, CURRENT_PROCESS_OWNER, getProcessLiveness, processOwnersEqual, parseProcessOwner } from './chunk-T5P2QGZ3.js';
+import { filePathToUri, resolveStoragePath, encodePathSegment, ensureDirectory, pathExists, readJsonFile, writeJsonFileAtomic, normalizeTimestamp, withFilesystemLock, resolveLocalViewPreferencesPath, resolveLocalViewServiceLockDir, readLocalViewServiceState, isLocalViewServiceStateLive, clearLocalViewServiceState, getLocalViewServiceStateLiveness, clearPersistedSessionRecord, writePersistedSessionRecord, isAttachedLocalBrowserSessionReachable, isProcessRunning, readPersistedLocalBrowserSessionRecord, getPersistedLocalBrowserSessionOwnership, buildLocalViewSessionId, inspectCdpEndpoint, selectAttachBrowserCandidate, resolveChromeExecutablePath, readDevToolsActivePort, normalizeNonEmptyString, toCanonicalJsonValue, canonicalJsonString, sha256Hex, joinStoragePath, writeBufferIfMissing, writeJsonFileExclusive, isAlreadyExistsError, readBinaryFile, listJsonFiles, expandHome, createLocalViewSessionManifest, writeLocalViewSessionManifest, deleteLocalViewSessionManifest, CURRENT_PROCESS_OWNER, getProcessLiveness, processOwnersEqual, parseProcessOwner } from './chunk-GKYBP3KD.js';
 import path7, { join, resolve, dirname, relative } from 'path';
 import { randomBytes, randomUUID } from 'crypto';
 import { spawn } from 'child_process';
@@ -692,6 +692,9 @@ var FilesystemSessionSink = class {
     this.store = store;
     this.sessionId = sessionId;
   }
+  configure(input) {
+    return this.store.configureSession(this.sessionId, input);
+  }
   append(input) {
     return this.store.appendEvent(this.sessionId, input);
   }
@@ -722,40 +725,14 @@ var FilesystemObservationStoreImpl = class {
     const sessionId = normalizeNonEmptyString("sessionId", input.sessionId);
     const openedAt = normalizeTimestamp("openedAt", input.openedAt ?? Date.now());
     const config = normalizeObservabilityConfig(input.config);
-    const redactor = createObservationRedactor(config);
-    this.redactors.set(sessionId, redactor);
-    const redactedLabels = redactor.redactLabels(config.labels);
-    const redactedTraceContext = redactor.redactTraceContext(config.traceContext);
-    await withFilesystemLock(this.sessionLockPath(sessionId), async () => {
-      const existing = await this.reconcileSessionManifest(sessionId);
-      if (existing === void 0) {
-        await ensureDirectory(this.sessionEventsDirectory(sessionId));
-        await ensureDirectory(this.sessionArtifactsDirectory(sessionId));
-        const session = {
-          sessionId,
-          profile: config.profile,
-          ...redactedLabels === void 0 ? {} : { labels: redactedLabels },
-          ...redactedTraceContext === void 0 ? {} : { traceContext: redactedTraceContext },
-          openedAt,
-          updatedAt: openedAt,
-          currentSequence: 0,
-          eventCount: 0,
-          artifactCount: 0
-        };
-        await writeJsonFileExclusive(this.sessionManifestPath(sessionId), session);
-        return;
-      }
-      const patched = {
-        ...existing,
-        profile: config.profile,
-        ...redactedLabels === void 0 ? {} : { labels: redactedLabels },
-        ...redactedTraceContext === void 0 ? {} : { traceContext: redactedTraceContext },
-        updatedAt: Math.max(existing.updatedAt, openedAt)
-      };
-      await writeJsonFileAtomic(this.sessionManifestPath(sessionId), patched);
-    });
+    await this.applySessionConfiguration(sessionId, config, openedAt);
     return new FilesystemSessionSink(this, sessionId);
   }
+  async configureSession(sessionId, input) {
+    const updatedAt = normalizeTimestamp("updatedAt", input.updatedAt ?? Date.now());
+    const config = normalizeObservabilityConfig(input.config);
+    await this.applySessionConfiguration(sessionId, config, updatedAt);
+  }
   async getSession(sessionId) {
     const manifestPath = this.sessionManifestPath(sessionId);
     if (!await pathExists(manifestPath)) {
@@ -976,6 +953,40 @@ var FilesystemObservationStoreImpl = class {
   sessionLockPath(sessionId) {
     return path7.join(this.sessionDirectory(sessionId), ".lock");
   }
+  async applySessionConfiguration(sessionId, config, timestamp) {
+    const redactor = createObservationRedactor(config);
+    this.redactors.set(sessionId, redactor);
+    const redactedLabels = redactor.redactLabels(config.labels);
+    const redactedTraceContext = redactor.redactTraceContext(config.traceContext);
+    await withFilesystemLock(this.sessionLockPath(sessionId), async () => {
+      const existing = await this.reconcileSessionManifest(sessionId);
+      if (existing === void 0) {
+        await ensureDirectory(this.sessionEventsDirectory(sessionId));
+        await ensureDirectory(this.sessionArtifactsDirectory(sessionId));
+        const session = {
+          sessionId,
+          profile: config.profile,
+          ...redactedLabels === void 0 ? {} : { labels: redactedLabels },
+          ...redactedTraceContext === void 0 ? {} : { traceContext: redactedTraceContext },
+          openedAt: timestamp,
+          updatedAt: timestamp,
+          currentSequence: 0,
+          eventCount: 0,
+          artifactCount: 0
+        };
+        await writeJsonFileExclusive(this.sessionManifestPath(sessionId), session);
+        return;
+      }
+      const patched = {
+        ...existing,
+        profile: config.profile,
+        ...redactedLabels === void 0 ? {} : { labels: redactedLabels },
+        ...redactedTraceContext === void 0 ? {} : { traceContext: redactedTraceContext },
+        updatedAt: Math.max(existing.updatedAt, timestamp)
+      };
+      await writeJsonFileAtomic(this.sessionManifestPath(sessionId), patched);
+    });
+  }
   async reconcileSessionManifest(sessionId) {
     const session = await this.getSession(sessionId);
     if (session === void 0) {
@@ -3473,7 +3484,7 @@ var OpensteerBrowserManager = class {
     }
     const liveRecord = await this.readLivePersistentBrowser(await this.ensureWorkspaceStore());
     return {
-      mode: this.mode,
+      mode: liveRecord?.ownership === "attached" ? "attach" : this.mode,
       engine: liveRecord?.engine ?? this.engineName,
       ...this.workspace === void 0 ? {} : { workspace: this.workspace },
       live: liveRecord !== void 0
@@ -3601,6 +3612,7 @@ var OpensteerBrowserManager = class {
       });
       const liveRecord = {
         mode: "persistent",
+        ownership: "owned",
         engine: "abp",
         baseUrl: launched.baseUrl,
         remoteDebuggingUrl: launched.remoteDebuggingUrl,
@@ -3687,11 +3699,78 @@ var OpensteerBrowserManager = class {
   }
   async createAttachEngine() {
     const endpoint = await resolveAttachEndpoint(this.browserOptions);
-    return this.createAttachedEngine({
-      endpoint,
-      ...this.browserOptions?.headers === void 0 ? {} : { headers: this.browserOptions.headers },
-      freshTab: this.browserOptions?.freshTab ?? true,
-      onDispose: async () => void 0
+    if (this.workspace === void 0) {
+      return this.createAttachedEngine({
+        endpoint,
+        ...this.browserOptions?.headers === void 0 ? {} : { headers: this.browserOptions.headers },
+        freshTab: this.browserOptions?.freshTab ?? true,
+        onDispose: async () => void 0
+      });
+    }
+    const workspace = await this.ensureWorkspaceStore();
+    return workspace.lock(async () => {
+      const live = await this.readLivePersistentBrowser(workspace);
+      if (live) {
+        if (live.engine !== "playwright") {
+          throw new Error(
+            `workspace "${this.workspace}" already has a live ${live.engine} browser. Close it before attaching a Playwright browser.`
+          );
+        }
+        if (live.ownership !== "attached") {
+          throw new Error(
+            `workspace "${this.workspace}" already has a live Opensteer-owned browser. Close it before attaching another browser.`
+          );
+        }
+        if (live.endpoint === void 0) {
+          throw new Error("workspace live browser record is missing a DevTools endpoint.");
+        }
+        if (live.endpoint !== endpoint) {
+          throw new Error(
+            `workspace "${this.workspace}" is already attached to a different browser endpoint. Close it before reattaching.`
+          );
+        }
+        await bestEffortRegisterLocalViewSession({
+          rootPath: workspace.rootPath,
+          ...this.workspace === void 0 ? {} : { workspace: this.workspace },
+          live: toPersistedLocalBrowserSessionRecord(this.workspace, live),
+          ownership: "attached"
+        });
+        return this.createAttachedEngine({
+          endpoint: live.endpoint,
+          ...this.browserOptions?.headers === void 0 ? {} : { headers: this.browserOptions.headers },
+          freshTab: this.browserOptions?.freshTab ?? true,
+          onDispose: async () => void 0
+        });
+      }
+      const liveRecord = {
+        mode: "persistent",
+        ownership: "attached",
+        engine: "playwright",
+        endpoint,
+        pid: 0,
+        startedAt: Date.now(),
+        userDataDir: workspace.browserUserDataDir
+      };
+      await this.writeLivePersistentBrowser(workspace, liveRecord);
+      const persistedLiveRecord = toPersistedLocalBrowserSessionRecord(this.workspace, liveRecord);
+      await bestEffortRegisterLocalViewSession({
+        rootPath: workspace.rootPath,
+        ...this.workspace === void 0 ? {} : { workspace: this.workspace },
+        live: persistedLiveRecord,
+        ownership: "attached"
+      });
+      try {
+        return await this.createAttachedEngine({
+          endpoint,
+          ...this.browserOptions?.headers === void 0 ? {} : { headers: this.browserOptions.headers },
+          freshTab: this.browserOptions?.freshTab ?? true,
+          onDispose: async () => void 0
+        });
+      } catch (error) {
+        await this.unregisterLocalViewSessionForRecord(workspace.rootPath, persistedLiveRecord);
+        await clearPersistedSessionRecord(workspace.rootPath, "local").catch(() => void 0);
+        throw error;
+      }
     });
   }
   async createPersistentEngine() {
@@ -3711,7 +3790,7 @@ var OpensteerBrowserManager = class {
           rootPath: workspace.rootPath,
           ...this.workspace === void 0 ? {} : { workspace: this.workspace },
           live: toPersistedLocalBrowserSessionRecord(this.workspace, live),
-          ownership: "owned"
+          ownership: live.ownership
         });
         return this.createAttachedEngine({
           endpoint: live.endpoint,
@@ -3727,6 +3806,7 @@ var OpensteerBrowserManager = class {
       });
       const liveRecord = {
         mode: "persistent",
+        ownership: "owned",
         engine: "playwright",
         endpoint: launched.endpoint,
         pid: launched.pid,
@@ -3856,7 +3936,20 @@ var OpensteerBrowserManager = class {
     if (live === void 0) {
       return void 0;
     }
+    if (live.ownership === "attached") {
+      const attachedRecord = toPersistedLocalBrowserSessionRecord(this.workspace, live);
+      if (!await isAttachedLocalBrowserSessionReachable(attachedRecord)) {
+        await this.unregisterLocalViewSessionForRecord(workspace.rootPath, attachedRecord);
+        await clearPersistedSessionRecord(workspace.rootPath, "local").catch(() => void 0);
+        return void 0;
+      }
+      return live;
+    }
     if (!isProcessRunning(live.pid)) {
+      await this.unregisterLocalViewSessionForRecord(
+        workspace.rootPath,
+        toPersistedLocalBrowserSessionRecord(this.workspace, live)
+      );
       await clearPersistedSessionRecord(workspace.rootPath, "local").catch(() => void 0);
       return void 0;
     }
@@ -3904,6 +3997,10 @@ var OpensteerBrowserManager = class {
       workspace.rootPath,
       toPersistedLocalBrowserSessionRecord(this.workspace, live)
     );
+    if (live.ownership === "attached") {
+      await clearPersistedSessionRecord(workspace.rootPath, "local").catch(() => void 0);
+      return;
+    }
     if (live.engine === "playwright") {
       if (live.endpoint !== void 0) {
         await requestBrowserClose(live.endpoint).catch(() => void 0);
@@ -3932,10 +4029,18 @@ var OpensteerBrowserManager = class {
   }
   async unregisterLocalViewSessionForRecord(rootPath, record) {
     await bestEffortUnregisterLocalViewSession(
-      buildLocalViewSessionId({
+      getPersistedLocalBrowserSessionOwnership(record) === "attached" ? buildLocalViewSessionId({
+        rootPath,
+        startedAt: record.startedAt,
+        ownership: "attached",
+        ...record.endpoint === void 0 ? {} : { endpoint: record.endpoint },
+        ...record.baseUrl === void 0 ? {} : { baseUrl: record.baseUrl },
+        ...record.remoteDebuggingUrl === void 0 ? {} : { remoteDebuggingUrl: record.remoteDebuggingUrl }
+      }) : buildLocalViewSessionId({
         rootPath,
-        pid: record.pid,
-        startedAt: record.startedAt
+        startedAt: record.startedAt,
+        ownership: "owned",
+        pid: record.pid
       })
     );
   }
@@ -3970,6 +4075,7 @@ function toPersistedLocalBrowserSessionRecord(workspace, live) {
     version: 1,
     provider: "local",
     ...workspace === void 0 ? {} : { workspace },
+    ownership: live.ownership,
     engine: live.engine,
     ...live.endpoint === void 0 ? {} : { endpoint: live.endpoint },
     ...live.baseUrl === void 0 ? {} : { baseUrl: live.baseUrl },
@@ -3985,6 +4091,7 @@ function toPersistedLocalBrowserSessionRecord(workspace, live) {
 function toWorkspaceLiveBrowserRecord(record) {
   return {
     mode: "persistent",
+    ownership: getPersistedLocalBrowserSessionOwnership(record),
     engine: record.engine,
     ...record.endpoint === void 0 ? {} : { endpoint: record.endpoint },
     ...record.baseUrl === void 0 ? {} : { baseUrl: record.baseUrl },
@@ -4011,7 +4118,12 @@ function isAttachBrowserOptions(browser) {
 async function resolveAttachEndpoint(browser) {
   const endpoint = browser?.endpoint?.trim();
   if (endpoint && endpoint.length > 0) {
-    return endpoint;
+    const inspected = await inspectCdpEndpoint({
+      endpoint,
+      ...browser?.headers === void 0 ? {} : { headers: browser.headers },
+      timeoutMs: DEFAULT_TIMEOUT_MS
+    });
+    return inspected.endpoint;
   }
   const selection = await selectAttachBrowserCandidate({
     timeoutMs: DEFAULT_TIMEOUT_MS
@@ -4358,5 +4470,5 @@ async function sleep2(ms) {
 }
 
 export { DEFAULT_OPENSTEER_ENGINE, JSON_SCHEMA_DRAFT_2020_12, OPENSTEER_ENGINE_NAMES, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OpensteerBrowserManager, OpensteerProtocolError, arraySchema, assertSupportedEngineOptions, buildLocalViewSessionUrl, createArtifactStore, createFilesystemOpensteerWorkspace, createObservationStore, createOpensteerError, defineSchema, ensureLocalViewServiceRunning, enumSchema, integerSchema, isOpensteerProtocolError, literalSchema, manifestToExternalBinaryLocation, normalizeObservabilityConfig, normalizeObservationContext, normalizeOpensteerEngineName, normalizeWorkspaceId, numberSchema, objectSchema, oneOfSchema, opensteerCapabilitySetSchema, opensteerErrorCodes, opensteerErrorSchema, recordSchema, resolveFilesystemWorkspacePath, resolveOpensteerEngineName, setLocalViewMode, stopLocalViewService, stringSchema, toOpensteerError };
-//# sourceMappingURL=chunk-3XBQRZZC.js.map
-//# sourceMappingURL=chunk-3XBQRZZC.js.map
+//# sourceMappingURL=chunk-EXXRLPLI.js.map
+//# sourceMappingURL=chunk-EXXRLPLI.js.map