opensteer 0.9.7 → 0.9.8

package/dist/index.cjs

@@ -1323,6 +1323,9 @@ var pageInfoSchema = objectSchema(
   {
     pageRef: pageRefSchema,
     sessionRef: sessionRefSchema,
+    targetId: stringSchema({
+      description: "Underlying browser target identifier when available."
+    }),
     openerPageRef: pageRefSchema,
     url: stringSchema({
       description: "Current main-frame URL."
@@ -6203,6 +6206,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);
   }
@@ -6233,40 +6239,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)) {
@@ -6487,6 +6467,40 @@ var FilesystemObservationStoreImpl = class {
   sessionLockPath(sessionId) {
     return path10__default.default.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) {
@@ -7546,7 +7560,9 @@ function resolveExtractedValueInContext(normalizedValue, options) {
 function stripPositionClauses(nodes) {
   return (nodes || []).map((node) => ({
     ...node,
-    match: (node.match || []).filter((clause) => clause.kind !== "position" && clause.kind !== "text")
+    match: (node.match || []).filter(
+      (clause) => clause.kind !== "position" && clause.kind !== "text"
+    )
   }));
 }
 function dedupeSelectors(selectors) {
@@ -9818,7 +9834,9 @@ var DefaultDomRuntime = class {
         `Unable to resolve structural anchor "${buildPathSelectorHint(anchor)}" in the current session`
       );
     }
-    const replayPath = await this.tryBuildPathFromNode(context.snapshot, target.node, { enableTextMatch: true });
+    const replayPath = await this.tryBuildPathFromNode(context.snapshot, target.node, {
+      enableTextMatch: true
+    });
     return this.createResolvedTarget(source, context.snapshot, target.node, anchor, {
       ...persist === void 0 ? {} : { persist },
       ...replayPath === void 0 ? {} : { replayPath }
@@ -13505,10 +13523,10 @@ async function isAttachedLocalBrowserSessionReachable(record) {
   }
 }
 function isPersistedCloudSessionRecord(value) {
-  return value.layout === OPENSTEER_LIVE_SESSION_LAYOUT && value.version === OPENSTEER_LIVE_SESSION_VERSION && value.provider === "cloud" && typeof value.sessionId === "string" && value.sessionId.length > 0 && typeof value.startedAt === "number" && Number.isFinite(value.startedAt) && typeof value.updatedAt === "number" && Number.isFinite(value.updatedAt);
+  return value.layout === OPENSTEER_LIVE_SESSION_LAYOUT && value.version === OPENSTEER_LIVE_SESSION_VERSION && value.provider === "cloud" && typeof value.sessionId === "string" && value.sessionId.length > 0 && (value.activePageUrl === void 0 || typeof value.activePageUrl === "string") && (value.activePageTitle === void 0 || typeof value.activePageTitle === "string") && typeof value.startedAt === "number" && Number.isFinite(value.startedAt) && typeof value.updatedAt === "number" && Number.isFinite(value.updatedAt);
 }
 function isPersistedLocalBrowserSessionRecord(value) {
-  return value.layout === OPENSTEER_LIVE_SESSION_LAYOUT && value.version === OPENSTEER_LIVE_SESSION_VERSION && value.provider === "local" && (value.engine === "playwright" || value.engine === "abp") && (value.ownership === void 0 || value.ownership === "owned" || value.ownership === "attached") && typeof value.pid === "number" && Number.isFinite(value.pid) && typeof value.startedAt === "number" && Number.isFinite(value.startedAt) && typeof value.updatedAt === "number" && Number.isFinite(value.updatedAt) && typeof value.userDataDir === "string" && value.userDataDir.length > 0;
+  return value.layout === OPENSTEER_LIVE_SESSION_LAYOUT && value.version === OPENSTEER_LIVE_SESSION_VERSION && value.provider === "local" && (value.engine === "playwright" || value.engine === "abp") && (value.ownership === void 0 || value.ownership === "owned" || value.ownership === "attached") && (value.activePageUrl === void 0 || typeof value.activePageUrl === "string") && (value.activePageTitle === void 0 || typeof value.activePageTitle === "string") && typeof value.pid === "number" && Number.isFinite(value.pid) && typeof value.startedAt === "number" && Number.isFinite(value.startedAt) && typeof value.updatedAt === "number" && Number.isFinite(value.updatedAt) && typeof value.userDataDir === "string" && value.userDataDir.length > 0;
 }
 function resolveOpensteerStateDir() {
   const explicit = process.env.OPENSTEER_HOME?.trim();
@@ -15946,11 +15964,11 @@ function delay2(ms) {
 function wrapCloudFetchError(error, input) {
   if (!(error instanceof Error)) {
     return new Error(
-      `Failed to reach Opensteer cloud endpoint ${input.method} ${input.url}. Check OPENSTEER_BASE_URL and network reachability from this environment.`
+      `Failed to reach Opensteer cloud endpoint ${input.method} ${input.url}. Check the configured Opensteer cloud base URL and network reachability from this environment.`
     );
   }
   const wrapped = new Error(
-    `Failed to reach Opensteer cloud endpoint ${input.method} ${input.url}. Check OPENSTEER_BASE_URL and network reachability from this environment.`,
+    `Failed to reach Opensteer cloud endpoint ${input.method} ${input.url}. Check the configured Opensteer cloud base URL and network reachability from this environment.`,
     {
       cause: error
     }
@@ -15990,6 +16008,7 @@ function asCloudErrorPayload(value) {
 }
 
 // src/cloud/config.ts
+var DEFAULT_OPENSTEER_CLOUD_BASE_URL = "https://api.opensteer.com";
 function resolveCloudConfig(input = {}) {
   const provider = resolveOpensteerProvider({
     ...input.provider === void 0 ? {} : { provider: input.provider },
@@ -15999,26 +16018,30 @@ function resolveCloudConfig(input = {}) {
     return void 0;
   }
   const cloudProvider = input.provider?.mode === "cloud" ? input.provider : void 0;
-  const apiKey = cloudProvider?.apiKey ?? input.environment?.OPENSTEER_API_KEY;
-  if (!apiKey || apiKey.trim().length === 0) {
+  const apiKey = normalizeOptionalCloudConfigValue(cloudProvider?.apiKey) ?? normalizeOptionalCloudConfigValue(input.environment?.OPENSTEER_API_KEY);
+  if (apiKey === void 0) {
     throw new Error("provider=cloud requires OPENSTEER_API_KEY or provider.apiKey.");
   }
-  const baseUrl = cloudProvider?.baseUrl ?? input.environment?.OPENSTEER_BASE_URL;
-  if (!baseUrl || baseUrl.trim().length === 0) {
-    throw new Error("provider=cloud requires OPENSTEER_BASE_URL or provider.baseUrl.");
-  }
-  const appBaseUrl = cloudProvider?.appBaseUrl ?? input.environment?.OPENSTEER_CLOUD_APP_BASE_URL;
+  const baseUrl = normalizeOptionalCloudConfigValue(cloudProvider?.baseUrl) ?? normalizeOptionalCloudConfigValue(input.environment?.OPENSTEER_BASE_URL) ?? DEFAULT_OPENSTEER_CLOUD_BASE_URL;
+  const appBaseUrl = normalizeOptionalCloudConfigValue(cloudProvider?.appBaseUrl) ?? normalizeOptionalCloudConfigValue(input.environment?.OPENSTEER_CLOUD_APP_BASE_URL);
   return {
-    apiKey: apiKey.trim(),
-    baseUrl: baseUrl.trim().replace(/\/+$/, ""),
-    ...appBaseUrl === void 0 || appBaseUrl.trim().length === 0 ? {} : { appBaseUrl: appBaseUrl.trim().replace(/\/+$/, "") },
+    apiKey,
+    baseUrl,
+    ...appBaseUrl === void 0 ? {} : { appBaseUrl },
     ...cloudProvider?.browserProfile === void 0 ? {} : { browserProfile: cloudProvider.browserProfile }
   };
 }
+function normalizeOptionalCloudConfigValue(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const normalized = value.trim().replace(/\/+$/, "");
+  return normalized.length === 0 ? void 0 : normalized;
+}
 
 // ../runtime-core/package.json
 var package_default = {
-  version: "0.2.6"};
+  version: "0.2.7"};
 
 // ../runtime-core/src/version.ts
 var OPENSTEER_RUNTIME_CORE_VERSION = package_default.version;
@@ -20089,7 +20112,10 @@ var OpensteerSessionRuntime = class {
   sessionRef;
   pageRef;
   runId;
-  observations;
+  observationSessions = /* @__PURE__ */ new Map();
+  openingObservationSessions = /* @__PURE__ */ new Map();
+  openedObservationSessions = /* @__PURE__ */ new Set();
+  observationSessionStorage = new async_hooks.AsyncLocalStorage();
   operationEventStorage = new async_hooks.AsyncLocalStorage();
   pendingOperationEventCaptures = [];
   ownsEngine = false;
@@ -20141,18 +20167,26 @@ var OpensteerSessionRuntime = class {
   }
   async setObservabilityConfig(input) {
     this.observationConfig = normalizeObservabilityConfig(input);
-    const observationSessionId = this.resolveObservationSessionId();
-    if (observationSessionId === void 0) {
-      return this.observationConfig;
-    }
-    const sink = this.injectedObservationSink ?? (await this.ensureRoot()).observations;
-    this.observations = await sink.openSession({
-      sessionId: observationSessionId,
-      openedAt: Date.now(),
-      config: this.observationConfig
-    });
+    await this.ensureConfiguredObservationSession();
     return this.observationConfig;
   }
+  async withObservationSessionId(sessionId, task) {
+    return await this.observationSessionStorage.run(
+      {
+        mode: "session",
+        sessionId: normalizeNonEmptyString("sessionId", sessionId)
+      },
+      task
+    );
+  }
+  async withoutObservationSession(task) {
+    return await this.observationSessionStorage.run(
+      {
+        mode: "disabled"
+      },
+      task
+    );
+  }
   async open(input = {}, options = {}) {
     assertValidSemanticOperationInput("session.open", input);
     if (input.workspace !== void 0 && normalizeNamespace2(input.workspace) !== this.workspace) {
@@ -23596,7 +23630,7 @@ var OpensteerSessionRuntime = class {
   }
   async resetRuntimeState(options) {
     const engine = this.engine;
-    const observations = this.observations;
+    const observationSessions = [...this.openedObservationSessions];
     this.networkHistory.clear();
     this.sessionRef = void 0;
     this.pageRef = void 0;
@@ -23605,9 +23639,15 @@ var OpensteerSessionRuntime = class {
     this.computer = void 0;
     this.extractionDescriptors = void 0;
     this.engine = void 0;
-    this.observations = void 0;
+    this.observationSessions.clear();
+    this.openingObservationSessions.clear();
+    this.openedObservationSessions.clear();
     this.pendingOperationEventCaptures.length = 0;
-    await observations?.close("runtime_reset").catch(() => void 0);
+    await Promise.allSettled(
+      observationSessions.map(
+        (observationSession) => observationSession.close("runtime_reset").catch(() => void 0)
+      )
+    );
     if (options.disposeEngine && this.ownsEngine && engine?.dispose) {
       await engine.dispose();
     }
@@ -23617,23 +23657,64 @@ var OpensteerSessionRuntime = class {
     if (this.observationConfig.profile === "off") {
       return void 0;
     }
-    if (this.observations !== void 0) {
-      return this.observations;
+    const observationSessionId = this.resolveObservationSessionId();
+    if (observationSessionId === void 0) {
+      return void 0;
+    }
+    const existingObservationSession = this.observationSessions.get(observationSessionId);
+    if (existingObservationSession !== void 0) {
+      return existingObservationSession;
+    }
+    const openingObservationSession = this.openingObservationSessions.get(observationSessionId);
+    if (openingObservationSession !== void 0) {
+      return await openingObservationSession;
+    }
+    const openObservationSessionTask = this.openObservationSession(observationSessionId).finally(
+      () => {
+        this.openingObservationSessions.delete(observationSessionId);
+      }
+    );
+    this.openingObservationSessions.set(observationSessionId, openObservationSessionTask);
+    return await openObservationSessionTask;
+  }
+  async ensureConfiguredObservationSession() {
+    if (this.observationConfig.profile === "off") {
+      return void 0;
     }
     const observationSessionId = this.resolveObservationSessionId();
     if (observationSessionId === void 0) {
       return void 0;
     }
+    const hadObservationSession = this.observationSessions.has(observationSessionId) || this.openingObservationSessions.has(observationSessionId);
+    const observationSession = await this.ensureObservationSession();
+    if (observationSession !== void 0 && hadObservationSession) {
+      await observationSession.configure?.({
+        config: this.observationConfig,
+        updatedAt: Date.now()
+      });
+    }
+    return observationSession;
+  }
+  resolveObservationSessionId() {
+    const scopedSession = this.observationSessionStorage.getStore();
+    if (scopedSession?.mode === "session") {
+      return scopedSession.sessionId;
+    }
+    if (scopedSession?.mode === "disabled") {
+      return void 0;
+    }
+    return this.observationSessionId ?? this.sessionRef;
+  }
+  async openObservationSession(sessionId) {
     const sink = this.injectedObservationSink ?? (await this.ensureRoot()).observations;
-    this.observations = await sink.openSession({
-      sessionId: observationSessionId,
+    const observationSession = await sink.openSession({
+      sessionId,
       openedAt: Date.now(),
       config: this.observationConfig
     });
-    return this.observations;
-  }
-  resolveObservationSessionId() {
-    return this.observationSessionId ?? this.sessionRef;
+    this.observationSessions.set(sessionId, observationSession);
+    this.openedObservationSessions.add(observationSession);
+    return observationSession;
   }
   runWithOperationTimeout(operation, callback, options = {}) {
     const timeoutPolicy = options.timeoutMs === void 0 ? this.policy.timeout : {
@@ -26309,7 +26390,29 @@ function isLoopbackBaseUrl(baseUrl) {
   }
   return url.hostname === "localhost" || url.hostname === "127.0.0.1" || url.hostname === "::1" || url.hostname === "[::1]";
 }
-var OpensteerRuntime = class extends OpensteerSessionRuntime {
+var LocalActivePageHintRuntime = class extends OpensteerSessionRuntime {
+  async completeWithLocalActivePageHint(operation) {
+    const output = await operation();
+    await persistLocalActivePageHint(this, this.rootPath);
+    return output;
+  }
+  async open(input = {}, options = {}) {
+    return this.completeWithLocalActivePageHint(() => super.open(input, options));
+  }
+  async newPage(input = {}, options = {}) {
+    return this.completeWithLocalActivePageHint(() => super.newPage(input, options));
+  }
+  async activatePage(input, options = {}) {
+    return this.completeWithLocalActivePageHint(() => super.activatePage(input, options));
+  }
+  async closePage(input = {}, options = {}) {
+    return this.completeWithLocalActivePageHint(() => super.closePage(input, options));
+  }
+  async goto(input, options = {}) {
+    return this.completeWithLocalActivePageHint(() => super.goto(input, options));
+  }
+};
+var OpensteerRuntime = class extends LocalActivePageHintRuntime {
   constructor(options = {}) {
     const publicWorkspace = normalizeWorkspace2(options.workspace);
     const rootPath = options.rootPath ?? (publicWorkspace === void 0 ? path10__default.default.resolve(options.rootDir ?? process.cwd(), ".opensteer", "temporary", crypto.randomUUID()) : resolveFilesystemWorkspacePath({
@@ -26347,6 +26450,41 @@ var OpensteerRuntime = class extends OpensteerSessionRuntime {
     );
   }
 };
+async function persistLocalActivePageHint(runtime, rootPath) {
+  try {
+    await syncPersistedLocalActivePageHint(runtime, rootPath);
+  } catch {
+  }
+}
+async function syncPersistedLocalActivePageHint(runtime, rootPath) {
+  const record = await readPersistedLocalBrowserSessionRecord(rootPath);
+  if (!record) {
+    return;
+  }
+  const sessionInfo = await runtime.info();
+  const activePageRef = sessionInfo.activePageRef;
+  let activePageUrl;
+  let activePageTitle;
+  if (activePageRef !== void 0) {
+    const pages = await runtime.listPages();
+    const activePage = pages.pages.find((page) => page.pageRef === activePageRef);
+    activePageUrl = activePage?.url;
+    activePageTitle = activePage?.title;
+  }
+  const {
+    activePageRef: _previousActivePageRef,
+    activePageUrl: _previousActivePageUrl,
+    activePageTitle: _previousActivePageTitle,
+    ...restRecord
+  } = record;
+  await writePersistedSessionRecord(rootPath, {
+    ...restRecord,
+    updatedAt: Date.now(),
+    ...activePageRef === void 0 ? {} : { activePageRef },
+    ...activePageUrl === void 0 ? {} : { activePageUrl },
+    ...activePageTitle === void 0 ? {} : { activePageTitle }
+  });
+}
 function buildSharedRuntimeOptions(input) {
   const ownership = resolveOwnership(input.browser);
   const engineFactory = input.engineFactory ?? ((factoryOptions) => new OpensteerBrowserManager({
@@ -26847,6 +26985,7 @@ function delay3(ms) {
   return new Promise((resolve4) => setTimeout(resolve4, ms));
 }
 
+exports.DEFAULT_OPENSTEER_CLOUD_BASE_URL = DEFAULT_OPENSTEER_CLOUD_BASE_URL;
 exports.DEFAULT_OPENSTEER_ENGINE = DEFAULT_OPENSTEER_ENGINE;
 exports.DEFERRED_MATCH_ATTR_KEYS = DEFERRED_MATCH_ATTR_KEYS;
 exports.ElementPathError = ElementPathError;