aboutsummaryrefslogtreecommitdiff
path: root/src/cdp/ownership.ts
diff options
context:
space:
mode:
Diffstat (limited to 'src/cdp/ownership.ts')
-rw-r--r--src/cdp/ownership.ts72
1 files changed, 72 insertions, 0 deletions
diff --git a/src/cdp/ownership.ts b/src/cdp/ownership.ts
new file mode 100644
index 0000000..f221d6a
--- /dev/null
+++ b/src/cdp/ownership.ts
@@ -0,0 +1,72 @@
+/**
+ * Tracks which tab targetIds belong to this harness session.
+ *
+ * The harness attaches to the user's running Chrome, which is also full of
+ * the user's own tabs. Without an ownership boundary the agent could attach
+ * to (or close) personal tabs by accident. The registry is the single source
+ * of truth for "did this session open that tab?".
+ *
+ * Mutations notify a single change listener so the orchestrator can persist
+ * to disk via the existing BrowserState flow without the registry needing to
+ * know about the pi storage API.
+ */
+
+export type OwnershipRegistry = {
+ add(targetId: string): void;
+ remove(targetId: string): void;
+ has(targetId: string): boolean;
+ list(): ReadonlyArray<string>;
+ /** Replace the full set — used on restoreState to re-hydrate from disk. */
+ replaceAll(ids: ReadonlyArray<string>): void;
+ setHarnessWindow(targetId: string | undefined): void;
+ harnessWindow(): string | undefined;
+ onChange(cb: () => void): void;
+};
+
+export const createOwnershipRegistry = (
+ initial?: { readonly ownedTargetIds?: ReadonlyArray<string>; readonly harnessWindowTargetId?: string },
+): OwnershipRegistry => {
+ const owned = new Set<string>(initial?.ownedTargetIds ?? []);
+ let harnessWindow: string | undefined = initial?.harnessWindowTargetId;
+ let listener: (() => void) | null = null;
+
+ const notify = (): void => {
+ if (listener) listener();
+ };
+
+ return {
+ add(targetId) {
+ if (owned.has(targetId)) return;
+ owned.add(targetId);
+ notify();
+ },
+ remove(targetId) {
+ if (!owned.has(targetId) && harnessWindow !== targetId) return;
+ owned.delete(targetId);
+ if (harnessWindow === targetId) harnessWindow = undefined;
+ notify();
+ },
+ has(targetId) {
+ return owned.has(targetId);
+ },
+ list() {
+ return [...owned];
+ },
+ replaceAll(ids) {
+ owned.clear();
+ for (const id of ids) owned.add(id);
+ notify();
+ },
+ setHarnessWindow(targetId) {
+ if (harnessWindow === targetId) return;
+ harnessWindow = targetId;
+ notify();
+ },
+ harnessWindow() {
+ return harnessWindow;
+ },
+ onChange(cb) {
+ listener = cb;
+ },
+ };
+};