@lhremote/core 0.7.0 → 0.9.0

package/dist/operations/ephemeral-action.test.js

@@ -0,0 +1,140 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+vi.mock("../services/account-resolution.js", () => ({
+    resolveAccount: vi.fn(),
+}));
+vi.mock("../services/instance-context.js", () => ({
+    withInstanceDatabase: vi.fn(),
+}));
+vi.mock("../services/ephemeral-campaign.js", () => ({
+    EphemeralCampaignService: vi.fn(),
+}));
+import { resolveAccount } from "../services/account-resolution.js";
+import { withInstanceDatabase } from "../services/instance-context.js";
+import { EphemeralCampaignService } from "../services/ephemeral-campaign.js";
+import { executeEphemeralAction } from "./ephemeral-action.js";
+const MOCK_RESULT = {
+    success: true,
+    personId: 42,
+    results: [{ result: 1 }],
+};
+const mockExecute = vi.fn().mockResolvedValue(MOCK_RESULT);
+function setupMocks() {
+    vi.mocked(resolveAccount).mockResolvedValue(1);
+    vi.mocked(withInstanceDatabase).mockImplementation(async (_cdpPort, _accountId, callback) => callback({
+        accountId: 1,
+        instance: {},
+        db: {},
+    }));
+    vi.mocked(EphemeralCampaignService).mockImplementation(function () {
+        return { execute: mockExecute };
+    });
+}
+describe("executeEphemeralAction", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("throws when neither personId nor url is provided", async () => {
+        await expect(executeEphemeralAction("Follow", { cdpPort: 9222 })).rejects.toThrow("Exactly one of personId or url must be provided");
+    });
+    it("throws when both personId and url are provided", async () => {
+        await expect(executeEphemeralAction("Follow", {
+            personId: 42,
+            url: "https://www.linkedin.com/in/test",
+            cdpPort: 9222,
+        })).rejects.toThrow("Exactly one of personId or url must be provided");
+    });
+    it("resolves account and executes action with personId target", async () => {
+        setupMocks();
+        const result = await executeEphemeralAction("Follow", {
+            personId: 42,
+            cdpPort: 9222,
+        });
+        expect(resolveAccount).toHaveBeenCalledWith(9222, {});
+        expect(withInstanceDatabase).toHaveBeenCalledWith(9222, 1, expect.any(Function));
+        expect(mockExecute).toHaveBeenCalledWith("Follow", 42, undefined, {});
+        expect(result).toBe(MOCK_RESULT);
+    });
+    it("passes url as target when personId is not provided", async () => {
+        setupMocks();
+        await executeEphemeralAction("Follow", {
+            url: "https://www.linkedin.com/in/test",
+            cdpPort: 9222,
+        });
+        expect(mockExecute).toHaveBeenCalledWith("Follow", "https://www.linkedin.com/in/test", undefined, {});
+    });
+    it("forwards actionSettings to execute", async () => {
+        setupMocks();
+        const settings = { skipIfUnfollowable: true, mode: "follow" };
+        await executeEphemeralAction("Follow", { personId: 42, cdpPort: 9222 }, settings);
+        expect(mockExecute).toHaveBeenCalledWith("Follow", 42, settings, {});
+    });
+    it("forwards keepCampaign option when provided", async () => {
+        setupMocks();
+        await executeEphemeralAction("Follow", {
+            personId: 42,
+            cdpPort: 9222,
+            keepCampaign: true,
+        });
+        expect(mockExecute).toHaveBeenCalledWith("Follow", 42, undefined, {
+            keepCampaign: true,
+        });
+    });
+    it("omits keepCampaign from options when undefined", async () => {
+        setupMocks();
+        await executeEphemeralAction("Follow", {
+            personId: 42,
+            cdpPort: 9222,
+        });
+        expect(mockExecute).toHaveBeenCalledWith("Follow", 42, undefined, {});
+    });
+    it("passes connection options to resolveAccount", async () => {
+        setupMocks();
+        await executeEphemeralAction("Follow", {
+            personId: 42,
+            cdpPort: 1234,
+            cdpHost: "192.168.1.1",
+            allowRemote: true,
+        });
+        expect(resolveAccount).toHaveBeenCalledWith(1234, {
+            host: "192.168.1.1",
+            allowRemote: true,
+        });
+    });
+    it("omits undefined connection options from resolveAccount", async () => {
+        setupMocks();
+        await executeEphemeralAction("Follow", {
+            personId: 42,
+            cdpPort: 9222,
+        });
+        expect(resolveAccount).toHaveBeenCalledWith(9222, {});
+    });
+    it("propagates resolveAccount errors", async () => {
+        vi.mocked(resolveAccount).mockRejectedValue(new Error("connection refused"));
+        await expect(executeEphemeralAction("Follow", { personId: 42, cdpPort: 9222 })).rejects.toThrow("connection refused");
+    });
+    it("propagates withInstanceDatabase errors", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        vi.mocked(withInstanceDatabase).mockRejectedValue(new Error("instance not running"));
+        await expect(executeEphemeralAction("Follow", { personId: 42, cdpPort: 9222 })).rejects.toThrow("instance not running");
+    });
+    it("propagates EphemeralCampaignService.execute errors", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        vi.mocked(withInstanceDatabase).mockImplementation(async (_cdpPort, _accountId, callback) => callback({
+            accountId: 1,
+            instance: {},
+            db: {},
+        }));
+        vi.mocked(EphemeralCampaignService).mockImplementation(function () {
+            return {
+                execute: vi.fn().mockRejectedValue(new Error("campaign failed")),
+            };
+        });
+        await expect(executeEphemeralAction("Follow", { personId: 42, cdpPort: 9222 })).rejects.toThrow("campaign failed");
+    });
+});
+//# sourceMappingURL=ephemeral-action.test.js.map

package/dist/operations/ephemeral-action.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ephemeral-action.test.js","sourceRoot":"","sources":["../../src/operations/ephemeral-action.test.ts"],"names":[],"mappings":"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"}

package/dist/operations/follow-person.d.ts

@@ -0,0 +1,9 @@
+import type { EphemeralActionResult } from "../types/index.js";
+import { type EphemeralActionInput } from "./ephemeral-action.js";
+export interface FollowPersonInput extends EphemeralActionInput {
+    readonly mode?: "follow" | "unfollow" | undefined;
+    readonly skipIfUnfollowable?: boolean | undefined;
+}
+export type FollowPersonOutput = EphemeralActionResult;
+export declare function followPerson(input: FollowPersonInput): Promise<FollowPersonOutput>;
+//# sourceMappingURL=follow-person.d.ts.map

package/dist/operations/follow-person.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow-person.d.ts","sourceRoot":"","sources":["../../src/operations/follow-person.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAkB,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACnD;AAED,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AAEvD,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAO7B"}

package/dist/operations/follow-person.js

@@ -0,0 +1,11 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { executeEphemeralAction, } from "./ephemeral-action.js";
+export async function followPerson(input) {
+    const actionSettings = {
+        skipIfUnfollowable: input.skipIfUnfollowable ?? true,
+        ...(input.mode !== undefined && { mode: input.mode }),
+    };
+    return executeEphemeralAction("Follow", input, actionSettings);
+}
+//# sourceMappingURL=follow-person.js.map

package/dist/operations/follow-person.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow-person.js","sourceRoot":"","sources":["../../src/operations/follow-person.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,sBAAsB,GAEvB,MAAM,uBAAuB,CAAC;AAS/B,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAwB;IAExB,MAAM,cAAc,GAAmB;QACrC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,IAAI,IAAI;QACpD,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;KACtD,CAAC;IAEF,OAAO,sBAAsB,CAAC,QAAQ,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;AACjE,CAAC"}

package/dist/operations/follow-person.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=follow-person.test.d.ts.map

package/dist/operations/follow-person.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow-person.test.d.ts","sourceRoot":"","sources":["../../src/operations/follow-person.test.ts"],"names":[],"mappings":""}

package/dist/operations/follow-person.test.js

@@ -0,0 +1,57 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+vi.mock("./ephemeral-action.js", () => ({
+    executeEphemeralAction: vi.fn(),
+}));
+import { executeEphemeralAction } from "./ephemeral-action.js";
+import { followPerson } from "./follow-person.js";
+const MOCK_RESULT = { success: true, personId: 42, results: [] };
+describe("followPerson", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.mocked(executeEphemeralAction).mockResolvedValue(MOCK_RESULT);
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("calls executeEphemeralAction with Follow action type", async () => {
+        const input = { personId: 42, cdpPort: 9222 };
+        await followPerson(input);
+        expect(executeEphemeralAction).toHaveBeenCalledWith("Follow", input, expect.any(Object));
+    });
+    it("defaults skipIfUnfollowable to true", async () => {
+        await followPerson({ personId: 42, cdpPort: 9222 });
+        expect(executeEphemeralAction).toHaveBeenCalledWith("Follow", expect.any(Object), expect.objectContaining({ skipIfUnfollowable: true }));
+    });
+    it("passes explicit skipIfUnfollowable value", async () => {
+        await followPerson({
+            personId: 42,
+            cdpPort: 9222,
+            skipIfUnfollowable: false,
+        });
+        expect(executeEphemeralAction).toHaveBeenCalledWith("Follow", expect.any(Object), expect.objectContaining({ skipIfUnfollowable: false }));
+    });
+    it("includes mode when provided", async () => {
+        await followPerson({
+            personId: 42,
+            cdpPort: 9222,
+            mode: "unfollow",
+        });
+        expect(executeEphemeralAction).toHaveBeenCalledWith("Follow", expect.any(Object), expect.objectContaining({ mode: "unfollow" }));
+    });
+    it("omits mode when undefined", async () => {
+        await followPerson({ personId: 42, cdpPort: 9222 });
+        const settings = vi.mocked(executeEphemeralAction).mock.calls[0]?.[2];
+        expect(settings).not.toHaveProperty("mode");
+    });
+    it("returns the result from executeEphemeralAction", async () => {
+        const result = await followPerson({ personId: 42, cdpPort: 9222 });
+        expect(result).toBe(MOCK_RESULT);
+    });
+    it("propagates errors from executeEphemeralAction", async () => {
+        vi.mocked(executeEphemeralAction).mockRejectedValue(new Error("action failed"));
+        await expect(followPerson({ personId: 42, cdpPort: 9222 })).rejects.toThrow("action failed");
+    });
+});
+//# sourceMappingURL=follow-person.test.js.map

package/dist/operations/follow-person.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow-person.test.js","sourceRoot":"","sources":["../../src/operations/follow-person.test.ts"],"names":[],"mappings":"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"}

package/dist/operations/get-action-budget.d.ts

@@ -0,0 +1,6 @@
+import type { ActionBudget } from "../types/index.js";
+import { type ConnectionOptions } from "./types.js";
+export type GetActionBudgetInput = ConnectionOptions;
+export type GetActionBudgetOutput = ActionBudget;
+export declare function getActionBudget(input: GetActionBudgetInput): Promise<GetActionBudgetOutput>;
+//# sourceMappingURL=get-action-budget.d.ts.map

package/dist/operations/get-action-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-action-budget.d.ts","sourceRoot":"","sources":["../../src/operations/get-action-budget.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAErD,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAEjD,wBAAsB,eAAe,CACnC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAahC"}

package/dist/operations/get-action-budget.js

@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { resolveAccount } from "../services/account-resolution.js";
+import { withDatabase } from "../services/instance-context.js";
+import { ActionBudgetRepository } from "../db/index.js";
+import { buildCdpOptions } from "./types.js";
+export async function getActionBudget(input) {
+    const cdpPort = input.cdpPort;
+    const accountId = await resolveAccount(cdpPort, buildCdpOptions(input));
+    return withDatabase(accountId, ({ db }) => {
+        const repo = new ActionBudgetRepository(db);
+        const entries = repo.getActionBudget();
+        return {
+            entries,
+            asOf: new Date().toISOString(),
+        };
+    });
+}
+//# sourceMappingURL=get-action-budget.js.map

package/dist/operations/get-action-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-action-budget.js","sourceRoot":"","sources":["../../src/operations/get-action-budget.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,eAAe,EAA0B,MAAM,YAAY,CAAC;AAMrE,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAA2B;IAE3B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAE9B,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IAExE,OAAO,YAAY,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;QACxC,MAAM,IAAI,GAAG,IAAI,sBAAsB,CAAC,EAAE,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACvC,OAAO;YACL,OAAO;YACP,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SAC/B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/operations/get-action-budget.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=get-action-budget.test.d.ts.map

package/dist/operations/get-action-budget.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-action-budget.test.d.ts","sourceRoot":"","sources":["../../src/operations/get-action-budget.test.ts"],"names":[],"mappings":""}

package/dist/operations/get-action-budget.test.js

@@ -0,0 +1,79 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+vi.mock("../services/account-resolution.js", () => ({
+    resolveAccount: vi.fn(),
+}));
+vi.mock("../services/instance-context.js", () => ({
+    withDatabase: vi.fn(),
+}));
+vi.mock("../db/index.js", () => ({
+    ActionBudgetRepository: vi.fn(),
+}));
+import { resolveAccount } from "../services/account-resolution.js";
+import { withDatabase } from "../services/instance-context.js";
+import { ActionBudgetRepository } from "../db/index.js";
+import { getActionBudget } from "./get-action-budget.js";
+const MOCK_ENTRIES = [
+    {
+        limitTypeId: 8,
+        limitType: "Invite",
+        dailyLimit: 100,
+        campaignUsed: 5,
+        directUsed: 0,
+        totalUsed: 5,
+        remaining: 95,
+    },
+];
+function setupMocks() {
+    vi.mocked(resolveAccount).mockResolvedValue(1);
+    vi.mocked(withDatabase).mockImplementation(async (_accountId, callback) => callback({ db: {} }));
+    vi.mocked(ActionBudgetRepository).mockImplementation(function () {
+        return {
+            getActionBudget: vi.fn().mockReturnValue(MOCK_ENTRIES),
+            getLimitTypes: vi.fn().mockReturnValue([]),
+        };
+    });
+}
+describe("getActionBudget", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("returns action budget with entries and timestamp", async () => {
+        setupMocks();
+        const result = await getActionBudget({ cdpPort: 9222 });
+        expect(result.entries).toEqual(MOCK_ENTRIES);
+        expect(result.asOf).toBeDefined();
+        expect(new Date(result.asOf).getTime()).not.toBeNaN();
+    });
+    it("passes connection options to resolveAccount", async () => {
+        setupMocks();
+        await getActionBudget({
+            cdpPort: 1234,
+            cdpHost: "192.168.1.1",
+            allowRemote: true,
+        });
+        expect(resolveAccount).toHaveBeenCalledWith(1234, {
+            host: "192.168.1.1",
+            allowRemote: true,
+        });
+    });
+    it("omits undefined connection options", async () => {
+        setupMocks();
+        await getActionBudget({ cdpPort: 9222 });
+        expect(resolveAccount).toHaveBeenCalledWith(9222, {});
+    });
+    it("propagates resolveAccount errors", async () => {
+        vi.mocked(resolveAccount).mockRejectedValue(new Error("connection refused"));
+        await expect(getActionBudget({ cdpPort: 9222 })).rejects.toThrow("connection refused");
+    });
+    it("propagates withDatabase errors", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        vi.mocked(withDatabase).mockRejectedValue(new Error("database not found"));
+        await expect(getActionBudget({ cdpPort: 9222 })).rejects.toThrow("database not found");
+    });
+});
+//# sourceMappingURL=get-action-budget.test.js.map

package/dist/operations/get-action-budget.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-action-budget.test.js","sourceRoot":"","sources":["../../src/operations/get-action-budget.test.ts"],"names":[],"mappings":"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"}

package/dist/operations/get-errors.d.ts

@@ -1,5 +1,5 @@
-import type { UIHealthStatus } from "../types/index.js";
-import type { ConnectionOptions } from "./types.js";
+import type { InstancePopup, UIHealthStatus } from "../types/index.js";
+import { type ConnectionOptions } from "./types.js";
 /**
  * Input for the get-errors operation.
  */
@@ -9,13 +9,23 @@ export type GetErrorsInput = ConnectionOptions;
  */
 export interface GetErrorsOutput extends UIHealthStatus {
     readonly accountId: number;
+    /** Popups detected in the instance UI DOM (behind the LinkedIn webview). */
+    readonly instancePopups: readonly InstancePopup[];
 }
 /**
  * Query the current error/dialog/popup state of a LinkedHelper instance.
  *
  * Connects to the launcher, resolves the account, and returns the
- * aggregated UI health status including active instance issues and
- * popup overlay state.
+ * aggregated UI health status including active instance issues,
+ * popup overlay state, and instance UI popups.
+ *
+ * When the launcher is not available (e.g. connecting directly to an
+ * instance), launcher health is reported as healthy and only instance
+ * popups are checked.
+ *
+ * Instance popups are detected on a best-effort basis: if the instance
+ * is not running or the UI target is unavailable, the operation still
+ * succeeds and returns an empty `instancePopups` array.
  */
 export declare function getErrors(input: GetErrorsInput): Promise<GetErrorsOutput>;
 //# sourceMappingURL=get-errors.d.ts.map

package/dist/operations/get-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-errors.d.ts","sourceRoot":"","sources":["../../src/operations/get-errors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,eAAe,CAAC,CAkB1B"}
+{"version":3,"file":"get-errors.d.ts","sourceRoot":"","sources":["../../src/operations/get-errors.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKvE,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,EAAE,SAAS,aAAa,EAAE,CAAC;CACnD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,eAAe,CAAC,CAmD1B"}

package/dist/operations/get-errors.js

@@ -1,30 +1,89 @@
 // SPDX-License-Identifier: AGPL-3.0-only
 // Copyright (C) 2026 Oleksii PELYKH
+import { discoverInstancePort, resolveInstancePort } from "../cdp/index.js";
 import { resolveAccount } from "../services/account-resolution.js";
+import { InstanceService } from "../services/instance.js";
 import { LauncherService } from "../services/launcher.js";
-import { DEFAULT_CDP_PORT } from "../constants.js";
+import { isLoopbackAddress } from "../utils/loopback.js";
+import { buildCdpOptions } from "./types.js";
 /**
  * Query the current error/dialog/popup state of a LinkedHelper instance.
  *
  * Connects to the launcher, resolves the account, and returns the
- * aggregated UI health status including active instance issues and
- * popup overlay state.
+ * aggregated UI health status including active instance issues,
+ * popup overlay state, and instance UI popups.
+ *
+ * When the launcher is not available (e.g. connecting directly to an
+ * instance), launcher health is reported as healthy and only instance
+ * popups are checked.
+ *
+ * Instance popups are detected on a best-effort basis: if the instance
+ * is not running or the UI target is unavailable, the operation still
+ * succeeds and returns an empty `instancePopups` array.
  */
 export async function getErrors(input) {
-    const cdpPort = input.cdpPort ?? DEFAULT_CDP_PORT;
-    const cdpOptions = {
-        ...(input.cdpHost !== undefined && { host: input.cdpHost }),
-        ...(input.allowRemote !== undefined && { allowRemote: input.allowRemote }),
-    };
+    const cdpPort = await resolveInstancePort(input.cdpPort, input.cdpHost);
+    const cdpOptions = buildCdpOptions(input);
     const accountId = await resolveAccount(cdpPort, cdpOptions);
-    const launcher = new LauncherService(cdpPort, cdpOptions);
+    // Launcher health check (best-effort — returns default healthy
+    // status when connected directly to an instance)
+    let health = {
+        issues: [],
+        popup: null,
+        instancePopups: [],
+        healthy: true,
+    };
+    let connectedToLauncher = false;
+    try {
+        const launcher = new LauncherService(cdpPort, cdpOptions);
+        try {
+            await launcher.connect();
+            connectedToLauncher = true;
+            health = await launcher.checkUIHealth(accountId);
+        }
+        finally {
+            launcher.disconnect();
+        }
+    }
+    catch {
+        // Launcher not available — proceed with instance-only health info
+    }
+    // Best-effort: detect instance UI popups if the UI target is available.
+    // When connected to a launcher, discover the instance's dynamic CDP port
+    // first — the launcher port does not host instance UI targets.
+    // Discovery only works locally (process inspection), so skip for remote hosts.
+    const isLocal = input.cdpHost === undefined || isLoopbackAddress(input.cdpHost);
+    let instancePopups = [];
+    if (connectedToLauncher && isLocal) {
+        const instancePort = await discoverInstancePort(cdpPort).catch(() => null);
+        if (instancePort !== null) {
+            instancePopups = await detectInstancePopups(instancePort, cdpOptions);
+        }
+    }
+    else if (!connectedToLauncher) {
+        // Direct instance connection — cdpPort IS the instance port
+        instancePopups = await detectInstancePopups(cdpPort, cdpOptions);
+    }
+    const healthy = health.healthy && instancePopups.length === 0;
+    return { accountId, ...health, healthy, instancePopups };
+}
+/**
+ * Attempt to detect instance UI popups via {@link InstanceService.connectUiOnly}.
+ *
+ * Returns an empty array when the UI target is unavailable or the
+ * connection fails for any reason.
+ */
+async function detectInstancePopups(cdpPort, cdpOptions) {
+    const instance = new InstanceService(cdpPort, cdpOptions);
     try {
-        await launcher.connect();
-        const health = await launcher.checkUIHealth(accountId);
-        return { accountId, ...health };
+        await instance.connectUiOnly();
+        return await instance.getInstancePopups();
+    }
+    catch {
+        return [];
     }
     finally {
-        launcher.disconnect();
+        instance.disconnect();
     }
 }
 //# sourceMappingURL=get-errors.js.map

package/dist/operations/get-errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-errors.js","sourceRoot":"","sources":["../../src/operations/get-errors.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAenD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,KAAqB;IAErB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,gBAAgB,CAAC;IAElD,MAAM,UAAU,GAAG;QACjB,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAC3D,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;KAC3E,CAAC;IAEF,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAE5D,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC1D,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACvD,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAAC;IAClC,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,UAAU,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}
+{"version":3,"file":"get-errors.js","sourceRoot":"","sources":["../../src/operations/get-errors.ts"],"names":[],"mappings":"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"}