@lhremote/core 0.6.0 → 0.8.0

package/dist/operations/endorse-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endorse-skills.js","sourceRoot":"","sources":["../../src/operations/endorse-skills.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,sBAAsB,GAEvB,MAAM,uBAAuB,CAAC;AAU/B,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAyB;IAEzB,MAAM,cAAc,GAAmB;QACrC,mBAAmB,EAAE,KAAK,CAAC,mBAAmB,IAAI,IAAI;QACtD,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;QACvE,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;KACzD,CAAC;IAEF,OAAO,sBAAsB,CAAC,eAAe,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;AACxE,CAAC"}

package/dist/operations/enrich-profile.d.ts

@@ -0,0 +1,18 @@
+import type { EphemeralActionResult } from "../types/index.js";
+import { type EphemeralActionInput } from "./ephemeral-action.js";
+/** Per-category enrichment toggle. */
+export interface EnrichmentCategory {
+    readonly shouldEnrich: boolean;
+    readonly actualDate?: number | undefined;
+    readonly types?: string[] | undefined;
+}
+export interface EnrichProfileInput extends EphemeralActionInput {
+    readonly profileInfo?: EnrichmentCategory | undefined;
+    readonly phones?: EnrichmentCategory | undefined;
+    readonly emails?: EnrichmentCategory | undefined;
+    readonly socials?: EnrichmentCategory | undefined;
+    readonly companies?: EnrichmentCategory | undefined;
+}
+export type EnrichProfileOutput = EphemeralActionResult;
+export declare function enrichProfile(input: EnrichProfileInput): Promise<EnrichProfileOutput>;
+//# sourceMappingURL=enrich-profile.d.ts.map

package/dist/operations/enrich-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich-profile.d.ts","sourceRoot":"","sources":["../../src/operations/enrich-profile.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAkB,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAE/B,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CACrD;AAED,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAExD,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAW9B"}

package/dist/operations/enrich-profile.js

@@ -0,0 +1,15 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { executeEphemeralAction, } from "./ephemeral-action.js";
+export async function enrichProfile(input) {
+    const defaults = { shouldEnrich: false };
+    const actionSettings = {
+        profileInfo: input.profileInfo ?? defaults,
+        phones: input.phones ?? defaults,
+        emails: input.emails ?? { ...defaults, types: ["personal", "business"] },
+        socials: input.socials ?? defaults,
+        companies: input.companies ?? defaults,
+    };
+    return executeEphemeralAction("DataEnrichment", input, actionSettings);
+}
+//# sourceMappingURL=enrich-profile.js.map

package/dist/operations/enrich-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich-profile.js","sourceRoot":"","sources":["../../src/operations/enrich-profile.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,sBAAsB,GAEvB,MAAM,uBAAuB,CAAC;AAmB/B,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAyB;IAEzB,MAAM,QAAQ,GAAuB,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;IAC7D,MAAM,cAAc,GAAmB;QACrC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,QAAQ;QAC1C,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,QAAQ;QAChC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE;QACxE,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,QAAQ;QAClC,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,QAAQ;KACvC,CAAC;IAEF,OAAO,sBAAsB,CAAC,gBAAgB,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;AACzE,CAAC"}

package/dist/operations/ephemeral-action.d.ts

@@ -0,0 +1,22 @@
+import type { ActionSettings, EphemeralActionResult } from "../types/index.js";
+import type { ConnectionOptions } from "./types.js";
+/**
+ * Shared input fields for all ephemeral action operations.
+ *
+ * Each individual action operation extends this with action-specific
+ * parameters.
+ */
+export interface EphemeralActionInput extends ConnectionOptions {
+    readonly personId?: number | undefined;
+    readonly url?: string | undefined;
+    readonly keepCampaign?: boolean | undefined;
+}
+/**
+ * Execute a single action on a single person via the ephemeral campaign
+ * service.
+ *
+ * Shared helper used by all individual action operations
+ * (message-person, send-invite, etc.).
+ */
+export declare function executeEphemeralAction(actionType: string, input: EphemeralActionInput, actionSettings?: ActionSettings): Promise<EphemeralActionResult>;
+//# sourceMappingURL=ephemeral-action.d.ts.map

package/dist/operations/ephemeral-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ephemeral-action.d.ts","sourceRoot":"","sources":["../../src/operations/ephemeral-action.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAK/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,oBAAoB,EAC3B,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAmBhC"}

package/dist/operations/ephemeral-action.js

@@ -0,0 +1,31 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { resolveAccount } from "../services/account-resolution.js";
+import { withInstanceDatabase } from "../services/instance-context.js";
+import { EphemeralCampaignService } from "../services/ephemeral-campaign.js";
+import { DEFAULT_CDP_PORT } from "../constants.js";
+/**
+ * Execute a single action on a single person via the ephemeral campaign
+ * service.
+ *
+ * Shared helper used by all individual action operations
+ * (message-person, send-invite, etc.).
+ */
+export async function executeEphemeralAction(actionType, input, actionSettings) {
+    if ((input.personId == null) === (input.url == null)) {
+        throw new Error("Exactly one of personId or url must be provided");
+    }
+    const target = input.personId ?? input.url;
+    const cdpPort = input.cdpPort ?? DEFAULT_CDP_PORT;
+    const accountId = await resolveAccount(cdpPort, {
+        ...(input.cdpHost !== undefined && { host: input.cdpHost }),
+        ...(input.allowRemote !== undefined && { allowRemote: input.allowRemote }),
+    });
+    return withInstanceDatabase(cdpPort, accountId, async ({ instance, db }) => {
+        const ephemeral = new EphemeralCampaignService(instance, db);
+        return ephemeral.execute(actionType, target, actionSettings, {
+            ...(input.keepCampaign !== undefined && { keepCampaign: input.keepCampaign }),
+        });
+    });
+}
+//# sourceMappingURL=ephemeral-action.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ephemeral-action.js","sourceRoot":"","sources":["../../src/operations/ephemeral-action.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAenD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,UAAkB,EAClB,KAA2B,EAC3B,cAA+B;IAE/B,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,MAAM,GAAoB,KAAK,CAAC,QAAQ,IAAK,KAAK,CAAC,GAAc,CAAC;IACxE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,gBAAgB,CAAC;IAElD,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE;QAC9C,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,CAAC;IAEH,OAAO,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE;QACzE,MAAM,SAAS,GAAG,IAAI,wBAAwB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC7D,OAAO,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE;YAC3D,GAAG,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC;SAC9E,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

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/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;AAKtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,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,CAgBhC"}

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

@@ -0,0 +1,22 @@
+// 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 { DEFAULT_CDP_PORT } from "../constants.js";
+export async function getActionBudget(input) {
+    const cdpPort = input.cdpPort ?? DEFAULT_CDP_PORT;
+    const accountId = await resolveAccount(cdpPort, {
+        ...(input.cdpHost !== undefined && { host: input.cdpHost }),
+        ...(input.allowRemote !== undefined && { allowRemote: input.allowRemote }),
+    });
+    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,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAOnD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAA2B;IAE3B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,gBAAgB,CAAC;IAElD,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE;QAC9C,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,CAAC;IAEH,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,4 +1,4 @@
-import type { UIHealthStatus } from "../types/index.js";
+import type { InstancePopup, UIHealthStatus } from "../types/index.js";
 import type { ConnectionOptions } from "./types.js";
 /**
  * Input for the get-errors operation.
@@ -9,13 +9,19 @@ 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.
+ *
+ * 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":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMvE,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;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,EAAE,SAAS,aAAa,EAAE,CAAC;CACnD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,eAAe,CAAC,CA8B1B"}

package/dist/operations/get-errors.js

@@ -1,14 +1,20 @@
 // SPDX-License-Identifier: AGPL-3.0-only
 // Copyright (C) 2026 Oleksii PELYKH
+import { discoverTargets } 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";
 /**
  * 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.
+ *
+ * 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;
@@ -18,13 +24,44 @@ export async function getErrors(input) {
     };
     const accountId = await resolveAccount(cdpPort, cdpOptions);
     const launcher = new LauncherService(cdpPort, cdpOptions);
+    let health;
     try {
         await launcher.connect();
-        const health = await launcher.checkUIHealth(accountId);
-        return { accountId, ...health };
+        health = await launcher.checkUIHealth(accountId);
     }
     finally {
         launcher.disconnect();
     }
+    // Best-effort: detect instance UI popups if the instance is running.
+    const instancePopups = await detectInstancePopups(cdpPort, input.cdpHost, cdpOptions);
+    const healthy = health.healthy && instancePopups.length === 0;
+    return { accountId, ...health, healthy, instancePopups };
+}
+/**
+ * Attempt to detect instance UI popups via a one-shot target discovery.
+ *
+ * Returns an empty array when the instance is not running or the
+ * targets disappear between discovery and connection.
+ */
+async function detectInstancePopups(cdpPort, cdpHost, cdpOptions) {
+    try {
+        const targets = await discoverTargets(cdpPort, cdpHost ?? "127.0.0.1");
+        const hasLinkedIn = targets.some((t) => t.type === "page" && t.url.includes("linkedin.com"));
+        const hasUI = targets.some((t) => t.type === "page" && t.url.includes("index.html"));
+        if (!hasLinkedIn || !hasUI) {
+            return [];
+        }
+        const instance = new InstanceService(cdpPort, cdpOptions);
+        try {
+            await instance.connect();
+            return await instance.getInstancePopups();
+        }
+        finally {
+            instance.disconnect();
+        }
+    }
+    catch {
+        return [];
+    }
 }
 //# 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":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAiBnD;;;;;;;;;;GAUG;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,MAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,UAAU,EAAE,CAAC;IACxB,CAAC;IAED,qEAAqE;IACrE,MAAM,cAAc,GAAG,MAAM,oBAAoB,CAC/C,OAAO,EACP,KAAK,CAAC,OAAO,EACb,UAAU,CACX,CAAC;IAEF,MAAM,OAAO,GACX,MAAM,CAAC,OAAO,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,CAAC;IAEhD,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,oBAAoB,CACjC,OAAe,EACf,OAA2B,EAC3B,UAAoD;IAEpD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,IAAI,WAAW,CAAC,CAAC;QACvE,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,CAC3D,CAAC;QACF,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CACxB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CACzD,CAAC;QACF,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC1D,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO,MAAM,QAAQ,CAAC,iBAAiB,EAAE,CAAC;QAC5C,CAAC;gBAAS,CAAC;YACT,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

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

@@ -7,40 +7,50 @@ vi.mock("../services/account-resolution.js", () => ({
 vi.mock("../services/launcher.js", () => ({
     LauncherService: vi.fn(),
 }));
+vi.mock("../cdp/index.js", () => ({
+    discoverTargets: vi.fn(),
+}));
+vi.mock("../services/instance.js", () => ({
+    InstanceService: vi.fn(),
+}));
+import { discoverTargets } from "../cdp/index.js";
 import { resolveAccount } from "../services/account-resolution.js";
+import { InstanceService } from "../services/instance.js";
 import { LauncherService } from "../services/launcher.js";
 import { getErrors } from "./get-errors.js";
 describe("getErrors", () => {
     beforeEach(() => {
         vi.clearAllMocks();
+        // Default: no instance targets
+        vi.mocked(discoverTargets).mockResolvedValue([]);
     });
     afterEach(() => {
         vi.restoreAllMocks();
     });
-    it("returns healthy status when no issues or popups", async () => {
-        vi.mocked(resolveAccount).mockResolvedValue(1);
-        const health = {
-            healthy: true,
-            issues: [],
-            popup: null,
-        };
-        const mockLauncher = {
+    function mockLauncher(health) {
+        const mock = {
             connect: vi.fn().mockResolvedValue(undefined),
             disconnect: vi.fn(),
             checkUIHealth: vi.fn().mockResolvedValue(health),
         };
         vi.mocked(LauncherService).mockImplementation(function () {
-            return mockLauncher;
+            return mock;
         });
+        return mock;
+    }
+    it("returns healthy status when no issues, popups, or instance popups", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        mockLauncher({ healthy: true, issues: [], popup: null, instancePopups: [] });
         const result = await getErrors({ cdpPort: 9222 });
         expect(result.healthy).toBe(true);
         expect(result.accountId).toBe(1);
         expect(result.issues).toEqual([]);
         expect(result.popup).toBeNull();
+        expect(result.instancePopups).toEqual([]);
     });
     it("returns blocked status with dialog issues", async () => {
         vi.mocked(resolveAccount).mockResolvedValue(1);
-        const health = {
+        mockLauncher({
             healthy: false,
             issues: [
                 {
@@ -56,14 +66,7 @@ describe("getErrors", () => {
                 },
             ],
             popup: null,
-        };
-        const mockLauncher = {
-            connect: vi.fn().mockResolvedValue(undefined),
-            disconnect: vi.fn(),
-            checkUIHealth: vi.fn().mockResolvedValue(health),
-        };
-        vi.mocked(LauncherService).mockImplementation(function () {
-            return mockLauncher;
+            instancePopups: [],
         });
         const result = await getErrors({ cdpPort: 9222 });
         expect(result.healthy).toBe(false);
@@ -72,18 +75,11 @@ describe("getErrors", () => {
     });
     it("returns blocked status with popup overlay", async () => {
         vi.mocked(resolveAccount).mockResolvedValue(1);
-        const health = {
+        mockLauncher({
             healthy: false,
             issues: [],
             popup: { blocked: true, message: "Network issue", closable: false },
-        };
-        const mockLauncher = {
-            connect: vi.fn().mockResolvedValue(undefined),
-            disconnect: vi.fn(),
-            checkUIHealth: vi.fn().mockResolvedValue(health),
-        };
-        vi.mocked(LauncherService).mockImplementation(function () {
-            return mockLauncher;
+            instancePopups: [],
         });
         const result = await getErrors({ cdpPort: 9222 });
         expect(result.healthy).toBe(false);
@@ -92,18 +88,7 @@ describe("getErrors", () => {
     });
     it("passes connection options to resolveAccount", async () => {
         vi.mocked(resolveAccount).mockResolvedValue(1);
-        const mockLauncher = {
-            connect: vi.fn().mockResolvedValue(undefined),
-            disconnect: vi.fn(),
-            checkUIHealth: vi.fn().mockResolvedValue({
-                healthy: true,
-                issues: [],
-                popup: null,
-            }),
-        };
-        vi.mocked(LauncherService).mockImplementation(function () {
-            return mockLauncher;
-        });
+        mockLauncher({ healthy: true, issues: [], popup: null, instancePopups: [] });
         await getErrors({
             cdpPort: 1234,
             cdpHost: "192.168.1.1",
@@ -116,20 +101,101 @@ describe("getErrors", () => {
     });
     it("disconnects launcher even on error", async () => {
         vi.mocked(resolveAccount).mockResolvedValue(1);
-        const mockLauncher = {
+        const mock = {
             connect: vi.fn().mockResolvedValue(undefined),
             disconnect: vi.fn(),
             checkUIHealth: vi.fn().mockRejectedValue(new Error("CDP failure")),
         };
         vi.mocked(LauncherService).mockImplementation(function () {
-            return mockLauncher;
+            return mock;
         });
         await expect(getErrors({ cdpPort: 9222 })).rejects.toThrow("CDP failure");
-        expect(mockLauncher.disconnect).toHaveBeenCalledOnce();
+        expect(mock.disconnect).toHaveBeenCalledOnce();
     });
     it("propagates resolveAccount errors", async () => {
         vi.mocked(resolveAccount).mockRejectedValue(new Error("connection refused"));
         await expect(getErrors({ cdpPort: 9222 })).rejects.toThrow("connection refused");
     });
+    it("includes instance popups when instance is running", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        mockLauncher({ healthy: true, issues: [], popup: null, instancePopups: [] });
+        vi.mocked(discoverTargets).mockResolvedValue([
+            { id: "t1", type: "page", title: "LinkedIn", url: "https://www.linkedin.com/feed/", description: "", devtoolsFrontendUrl: "", webSocketDebuggerUrl: "" },
+            { id: "t2", type: "page", title: "LH", url: "file:///index.html", description: "", devtoolsFrontendUrl: "", webSocketDebuggerUrl: "" },
+        ]);
+        const mockInstance = {
+            connect: vi.fn().mockResolvedValue(undefined),
+            disconnect: vi.fn(),
+            getInstancePopups: vi.fn().mockResolvedValue([
+                { title: "Failed to initialize UI", description: "AsyncHandlerError", closable: true },
+            ]),
+        };
+        vi.mocked(InstanceService).mockImplementation(function () {
+            return mockInstance;
+        });
+        const result = await getErrors({ cdpPort: 9222 });
+        expect(result.instancePopups).toHaveLength(1);
+        expect(result.instancePopups[0]?.title).toBe("Failed to initialize UI");
+        expect(result.healthy).toBe(false);
+    });
+    it("marks unhealthy when instance popups are present even if launcher is healthy", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        mockLauncher({ healthy: true, issues: [], popup: null, instancePopups: [] });
+        vi.mocked(discoverTargets).mockResolvedValue([
+            { id: "t1", type: "page", title: "LinkedIn", url: "https://www.linkedin.com/feed/", description: "", devtoolsFrontendUrl: "", webSocketDebuggerUrl: "" },
+            { id: "t2", type: "page", title: "LH", url: "file:///index.html", description: "", devtoolsFrontendUrl: "", webSocketDebuggerUrl: "" },
+        ]);
+        const mockInstance = {
+            connect: vi.fn().mockResolvedValue(undefined),
+            disconnect: vi.fn(),
+            getInstancePopups: vi.fn().mockResolvedValue([
+                { title: "Error popup", closable: false },
+            ]),
+        };
+        vi.mocked(InstanceService).mockImplementation(function () {
+            return mockInstance;
+        });
+        const result = await getErrors({ cdpPort: 9222 });
+        expect(result.healthy).toBe(false);
+        expect(result.instancePopups).toHaveLength(1);
+    });
+    it("returns empty instancePopups when instance is not running", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        mockLauncher({ healthy: true, issues: [], popup: null, instancePopups: [] });
+        // Only launcher target, no instance targets
+        vi.mocked(discoverTargets).mockResolvedValue([
+            { id: "t1", type: "page", title: "Launcher", url: "file:///launcher.html", description: "", devtoolsFrontendUrl: "", webSocketDebuggerUrl: "" },
+        ]);
+        const result = await getErrors({ cdpPort: 9222 });
+        expect(result.instancePopups).toEqual([]);
+        expect(result.healthy).toBe(true);
+    });
+    it("returns empty instancePopups when target discovery fails", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        mockLauncher({ healthy: true, issues: [], popup: null, instancePopups: [] });
+        vi.mocked(discoverTargets).mockRejectedValue(new Error("connection reset"));
+        const result = await getErrors({ cdpPort: 9222 });
+        expect(result.instancePopups).toEqual([]);
+        expect(result.healthy).toBe(true);
+    });
+    it("disconnects instance service even when getInstancePopups fails", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        mockLauncher({ healthy: true, issues: [], popup: null, instancePopups: [] });
+        vi.mocked(discoverTargets).mockResolvedValue([
+            { id: "t1", type: "page", title: "LinkedIn", url: "https://www.linkedin.com/feed/", description: "", devtoolsFrontendUrl: "", webSocketDebuggerUrl: "" },
+            { id: "t2", type: "page", title: "LH", url: "file:///index.html", description: "", devtoolsFrontendUrl: "", webSocketDebuggerUrl: "" },
+        ]);
+        const mockInstance = {
+            connect: vi.fn().mockResolvedValue(undefined),
+            disconnect: vi.fn(),
+            getInstancePopups: vi.fn().mockRejectedValue(new Error("DOM error")),
+        };
+        vi.mocked(InstanceService).mockImplementation(function () {
+            return mockInstance;
+        });
+        const result = await getErrors({ cdpPort: 9222 });
+        expect(result.instancePopups).toEqual([]);
+        expect(mockInstance.disconnect).toHaveBeenCalledOnce();
+    });
 });
 //# sourceMappingURL=get-errors.test.js.map