@tickernelz/paperclip-pro-server 2026.1017.2 → 2026.1021.0

package/dist/services/local-browser/attachments.d.ts

@@ -0,0 +1,36 @@
+import type { Db } from "@tickernelz/paperclip-pro-db";
+import type { StorageService } from "../../storage/types.js";
+export declare const LOCAL_BROWSER_UPLOAD_MAX_BYTES: number;
+export interface DecodedDataUrl {
+    contentType: string;
+    bytes: Buffer;
+}
+export declare function decodeDataUrl(dataUrl: string): DecodedDataUrl | null;
+export declare function storeLocalBrowserAttachment(db: Db, input: {
+    companyId: string;
+    namespace: string;
+    originalFilename: string;
+    contentType: string;
+    bytes: Buffer;
+    createdByUserId: string | null;
+    createdByAgentId: string | null;
+    runId: string | null;
+    issueId: string | null;
+    storage?: StorageService;
+}): Promise<{
+    attachmentId: string;
+    byteSize: number;
+    originalFilename: string;
+    contentType: string;
+}>;
+export declare function readTaskAttachment(db: Db, input: {
+    companyId: string;
+    attachmentId: string;
+    issueId?: string | null;
+    storage?: StorageService;
+}): Promise<{
+    bytes: Buffer;
+    contentType: string;
+    originalFilename: string;
+}>;
+//# sourceMappingURL=attachments.d.ts.map

package/dist/services/local-browser/attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../../src/services/local-browser/attachments.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,8BAA8B,CAAC;AAKvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,eAAO,MAAM,8BAA8B,QAAmB,CAAC;AAI/D,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAqBpE;AAkBD,wBAAsB,2BAA2B,CAC/C,EAAE,EAAE,EAAE,EACN,KAAK,EAAE;IACL,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,GACA,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAoCpG;AAED,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,EAAE,EACN,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,cAAc,CAAA;CAAE,GACpG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAAC,CA4B3E"}

package/dist/services/local-browser/attachments.js

@@ -0,0 +1,118 @@
+import { and, eq } from "drizzle-orm";
+import { assets, issueAttachments } from "@tickernelz/paperclip-pro-db";
+import { isUuidLike } from "@tickernelz/paperclip-pro-shared";
+import { assetService } from "../assets.js";
+import { getStorageService } from "../../storage/index.js";
+import { localBrowserFailure } from "./errors.js";
+export const LOCAL_BROWSER_UPLOAD_MAX_BYTES = 20 * 1024 * 1024;
+const DATA_URL = /^data:([^;,]+)?(;base64)?,(.*)$/s;
+export function decodeDataUrl(dataUrl) {
+    if (typeof dataUrl !== "string" || dataUrl.length === 0)
+        return null;
+    const match = DATA_URL.exec(dataUrl);
+    if (!match)
+        return null;
+    const contentType = (match[1] ?? "application/octet-stream").trim().toLowerCase();
+    const isBase64 = match[2] === ";base64";
+    const payload = match[3] ?? "";
+    let bytes;
+    if (isBase64) {
+        const normalized = payload.replace(/\s+/g, "");
+        if (normalized.length === 0 || !/^[A-Za-z0-9+/_-]*={0,2}$/.test(normalized))
+            return null;
+        bytes = Buffer.from(normalized, "base64");
+    }
+    else {
+        try {
+            bytes = Buffer.from(decodeURIComponent(payload), "utf8");
+        }
+        catch {
+            return null;
+        }
+    }
+    if (bytes.length === 0)
+        return null;
+    return { contentType, bytes };
+}
+async function readStreamBytes(stream, limit) {
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of stream) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        size += buffer.length;
+        if (size > limit) {
+            throw localBrowserFailure("local_browser_result_too_large", `Attachment is larger than the ${limit} byte limit`, {
+                status: 413,
+            });
+        }
+        chunks.push(buffer);
+    }
+    return Buffer.concat(chunks);
+}
+export async function storeLocalBrowserAttachment(db, input) {
+    const storage = input.storage ?? getStorageService();
+    const stored = await storage.putFile({
+        companyId: input.companyId,
+        namespace: input.namespace,
+        originalFilename: input.originalFilename,
+        contentType: input.contentType,
+        body: input.bytes,
+    });
+    const asset = await assetService(db).create(input.companyId, {
+        provider: stored.provider,
+        objectKey: stored.objectKey,
+        contentType: stored.contentType,
+        byteSize: stored.byteSize,
+        sha256: stored.sha256,
+        originalFilename: stored.originalFilename,
+        createdByAgentId: input.createdByAgentId,
+        createdByUserId: input.createdByUserId,
+    });
+    if (input.issueId && isUuidLike(input.issueId)) {
+        await db
+            .insert(issueAttachments)
+            .values({
+            companyId: input.companyId,
+            issueId: input.issueId,
+            assetId: asset.id,
+            originatingRunId: input.runId && isUuidLike(input.runId) ? input.runId : null,
+        })
+            .onConflictDoNothing();
+    }
+    return {
+        attachmentId: asset.id,
+        byteSize: stored.byteSize,
+        originalFilename: stored.originalFilename ?? input.originalFilename,
+        contentType: stored.contentType,
+    };
+}
+export async function readTaskAttachment(db, input) {
+    const [row] = await db
+        .select({
+        objectKey: assets.objectKey,
+        contentType: assets.contentType,
+        originalFilename: assets.originalFilename,
+        issueId: issueAttachments.issueId,
+    })
+        .from(issueAttachments)
+        .innerJoin(assets, eq(issueAttachments.assetId, assets.id))
+        .where(and(eq(issueAttachments.companyId, input.companyId), eq(issueAttachments.id, input.attachmentId)))
+        .limit(1);
+    if (!row) {
+        throw localBrowserFailure("local_browser_unsupported", "Attachment is not part of this company's task attachments", {
+            status: 404,
+        });
+    }
+    if (input.issueId && row.issueId !== input.issueId) {
+        throw localBrowserFailure("local_browser_unsupported", "Attachment belongs to a different task", { status: 404 });
+    }
+    const storage = input.storage ?? getStorageService();
+    const object = await storage.getObject(input.companyId, row.objectKey);
+    const bytes = await readStreamBytes(object.stream, LOCAL_BROWSER_UPLOAD_MAX_BYTES);
+    return {
+        bytes,
+        contentType: row.contentType || object.contentType || "application/octet-stream",
+        originalFilename: row.originalFilename ?? "attachment",
+    };
+}
+//# sourceMappingURL=attachments.js.map

package/dist/services/local-browser/attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../../../src/services/local-browser/attachments.ts"],"names":[],"mappings":"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"}

package/dist/services/local-browser/errors.d.ts

@@ -0,0 +1,20 @@
+import type { LocalBrowserErrorCode, LocalBrowserToolError } from "@tickernelz/paperclip-pro-shared";
+import { HttpError } from "../../errors.js";
+export declare class LocalBrowserFailure extends HttpError {
+    readonly code: LocalBrowserErrorCode;
+    readonly retryable: boolean;
+    readonly hint: string | null;
+    constructor(code: LocalBrowserErrorCode, message: string, options?: {
+        retryable?: boolean;
+        hint?: string;
+        status?: number;
+    });
+    toToolError(): LocalBrowserToolError;
+}
+export declare function localBrowserFailure(code: LocalBrowserErrorCode, message: string, options?: {
+    retryable?: boolean;
+    hint?: string;
+    status?: number;
+}): LocalBrowserFailure;
+export declare function isLocalBrowserFailure(error: unknown): error is LocalBrowserFailure;
+//# sourceMappingURL=errors.d.ts.map

package/dist/services/local-browser/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/services/local-browser/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACrG,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAiB5C,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,YACE,IAAI,EAAE,qBAAqB,EAC3B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,EAWtE;IAED,WAAW,IAAI,qBAAqB,CAOnC;CACF;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,qBAAqB,EAC3B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACpE,mBAAmB,CAErB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAElF"}

package/dist/services/local-browser/errors.js

@@ -0,0 +1,46 @@
+import { HttpError } from "../../errors.js";
+const STATUS_BY_CODE = {
+    local_browser_not_paired: 409,
+    local_browser_extension_unavailable: 409,
+    local_browser_origin_denied: 403,
+    local_browser_tier_denied: 403,
+    local_browser_tab_missing: 404,
+    local_browser_ref_stale: 409,
+    local_browser_element_missing: 404,
+    local_browser_timeout: 504,
+    local_browser_navigation_blocked: 409,
+    local_browser_protocol_error: 502,
+    local_browser_result_too_large: 413,
+    local_browser_unsupported: 400,
+};
+export class LocalBrowserFailure extends HttpError {
+    code;
+    retryable;
+    hint;
+    constructor(code, message, options = {}) {
+        const retryable = options.retryable ?? false;
+        super(options.status ?? STATUS_BY_CODE[code], `[${code}] ${message}`, {
+            code,
+            retryable,
+            ...(options.hint ? { hint: options.hint } : {}),
+        });
+        this.code = code;
+        this.retryable = retryable;
+        this.hint = options.hint ?? null;
+    }
+    toToolError() {
+        return {
+            code: this.code,
+            message: this.message.startsWith(`[${this.code}] `) ? this.message.slice(this.code.length + 3) : this.message,
+            ...(this.hint ? { hint: this.hint } : {}),
+            retryable: this.retryable,
+        };
+    }
+}
+export function localBrowserFailure(code, message, options = {}) {
+    return new LocalBrowserFailure(code, message, options);
+}
+export function isLocalBrowserFailure(error) {
+    return error instanceof LocalBrowserFailure;
+}
+//# sourceMappingURL=errors.js.map

package/dist/services/local-browser/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/services/local-browser/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,cAAc,GAA0C;IAC5D,wBAAwB,EAAE,GAAG;IAC7B,mCAAmC,EAAE,GAAG;IACxC,2BAA2B,EAAE,GAAG;IAChC,yBAAyB,EAAE,GAAG;IAC9B,yBAAyB,EAAE,GAAG;IAC9B,uBAAuB,EAAE,GAAG;IAC5B,6BAA6B,EAAE,GAAG;IAClC,qBAAqB,EAAE,GAAG;IAC1B,gCAAgC,EAAE,GAAG;IACrC,4BAA4B,EAAE,GAAG;IACjC,8BAA8B,EAAE,GAAG;IACnC,yBAAyB,EAAE,GAAG;CAC/B,CAAC;AAEF,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IACvC,IAAI,CAAwB;IAC5B,SAAS,CAAU;IACnB,IAAI,CAAgB;IAE7B,YACE,IAA2B,EAC3B,OAAe,EACf,OAAO,GAA4D,EAAE;QAErE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAC7C,KAAK,CAAC,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,KAAK,OAAO,EAAE,EAAE;YACpE,IAAI;YACJ,SAAS;YACT,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChD,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;IACnC,CAAC;IAED,WAAW;QACT,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO;YAC7G,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzC,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CACjC,IAA2B,EAC3B,OAAe,EACf,OAAO,GAA4D,EAAE;IAErE,OAAO,IAAI,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,OAAO,KAAK,YAAY,mBAAmB,CAAC;AAC9C,CAAC"}

package/dist/services/local-browser/pairing.d.ts

@@ -0,0 +1,40 @@
+import { type LocalBrowserClient, type LocalBrowserPairingStartResult } from "@tickernelz/paperclip-pro-shared";
+export interface PairingRecord {
+    code: string;
+    companyId: string;
+    createdByUserId: string | null;
+    createdByAgentId: string | null;
+    label: string | null;
+    client: LocalBrowserClient | null;
+    expiresAt: number;
+    sessionId: string | null;
+    claimedAt: number | null;
+    consumedAt: number | null;
+}
+export type PairingStatus = "pending" | "paired" | "expired";
+export declare function createPairing(input: {
+    companyId: string;
+    createdByUserId?: string | null;
+    createdByAgentId?: string | null;
+    label?: string | null;
+    client?: LocalBrowserClient | null;
+    now?: number;
+}): PairingRecord;
+export declare function readPairing(code: string, now?: number): PairingRecord | null;
+export declare function pairingStatus(code: string, now?: number): {
+    status: PairingStatus;
+    sessionId?: string;
+};
+export declare function pairingStatusForCompany(code: string, companyId: string, now?: number): {
+    status: PairingStatus;
+    sessionId?: string;
+};
+export declare function claimPairing(code: string, now?: number): PairingRecord | null;
+export declare function releasePairingClaim(code: string): void;
+export declare function finalizePairing(code: string, sessionId: string): boolean;
+export declare function consumePairing(code: string, sessionId: string): boolean;
+export declare function pairingResult(record: PairingRecord, connectUrls: string[]): LocalBrowserPairingStartResult;
+export declare function resetPairings(): void;
+export declare function pairingBridgeUrl(baseUrl: string, code: string): string;
+export declare function newPairingNonce(): string;
+//# sourceMappingURL=pairing.d.ts.map

package/dist/services/local-browser/pairing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.d.ts","sourceRoot":"","sources":["../../../src/services/local-browser/pairing.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,8BAA8B,EACpC,MAAM,kCAAkC,CAAC;AAI1C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAmB7D,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,aAAa,CAmBhB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,aAAa,GAAG,IAAI,CAMhF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAM3G;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,GAAG,SAAa,GACf;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAI/C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,aAAa,GAAG,IAAI,CAOjF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAItD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAMxE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAIvE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,8BAA8B,CAM1G;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/services/local-browser/pairing.js

@@ -0,0 +1,114 @@
+import { randomBytes, randomUUID } from "node:crypto";
+import { LOCAL_BROWSER_PAIRING_CODE_LENGTH, LOCAL_BROWSER_PAIRING_TTL_MS, } from "@tickernelz/paperclip-pro-shared";
+const CODE_ALPHABET = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789";
+const pairings = new Map();
+function mintCode() {
+    const bytes = randomBytes(LOCAL_BROWSER_PAIRING_CODE_LENGTH);
+    let code = "";
+    for (let index = 0; index < LOCAL_BROWSER_PAIRING_CODE_LENGTH; index += 1) {
+        code += CODE_ALPHABET[bytes[index] % CODE_ALPHABET.length];
+    }
+    return code;
+}
+function sweep(now) {
+    for (const [code, record] of pairings) {
+        if (record.expiresAt <= now && record.consumedAt === null)
+            pairings.delete(code);
+    }
+}
+export function createPairing(input) {
+    const now = input.now ?? Date.now();
+    sweep(now);
+    let code = mintCode();
+    while (pairings.has(code))
+        code = mintCode();
+    const record = {
+        code,
+        companyId: input.companyId,
+        createdByUserId: input.createdByUserId ?? null,
+        createdByAgentId: input.createdByAgentId ?? null,
+        label: input.label ?? null,
+        client: input.client ?? null,
+        expiresAt: now + LOCAL_BROWSER_PAIRING_TTL_MS,
+        sessionId: null,
+        claimedAt: null,
+        consumedAt: null,
+    };
+    pairings.set(code, record);
+    return record;
+}
+export function readPairing(code, now = Date.now()) {
+    const record = pairings.get(code.trim().toUpperCase());
+    if (!record)
+        return null;
+    if (record.consumedAt !== null || record.claimedAt !== null)
+        return null;
+    if (record.expiresAt <= now)
+        return null;
+    return record;
+}
+export function pairingStatus(code, now = Date.now()) {
+    const record = pairings.get(code.trim().toUpperCase());
+    if (!record)
+        return { status: "expired" };
+    if (record.consumedAt !== null)
+        return { status: "paired", sessionId: record.sessionId ?? undefined };
+    if (record.expiresAt <= now)
+        return { status: "expired" };
+    return { status: "pending" };
+}
+export function pairingStatusForCompany(code, companyId, now = Date.now()) {
+    const record = pairings.get(code.trim().toUpperCase());
+    if (!record || record.companyId !== companyId)
+        return { status: "expired" };
+    return pairingStatus(code, now);
+}
+export function claimPairing(code, now = Date.now()) {
+    const record = pairings.get(code.trim().toUpperCase());
+    if (!record)
+        return null;
+    if (record.consumedAt !== null || record.claimedAt !== null)
+        return null;
+    if (record.expiresAt <= now)
+        return null;
+    record.claimedAt = now;
+    return record;
+}
+export function releasePairingClaim(code) {
+    const record = pairings.get(code.trim().toUpperCase());
+    if (!record || record.sessionId !== null)
+        return;
+    record.claimedAt = null;
+}
+export function finalizePairing(code, sessionId) {
+    const record = pairings.get(code.trim().toUpperCase());
+    if (!record || record.claimedAt === null || record.consumedAt !== null)
+        return false;
+    record.consumedAt = Date.now();
+    record.sessionId = sessionId;
+    return true;
+}
+export function consumePairing(code, sessionId) {
+    const claimed = claimPairing(code);
+    if (!claimed)
+        return false;
+    return finalizePairing(code, sessionId);
+}
+export function pairingResult(record, connectUrls) {
+    return {
+        code: record.code,
+        expiresAt: new Date(record.expiresAt).toISOString(),
+        connectUrls,
+    };
+}
+export function resetPairings() {
+    pairings.clear();
+}
+export function pairingBridgeUrl(baseUrl, code) {
+    const trimmed = baseUrl.replace(/\/+$/, "");
+    return `${trimmed}/api/local-browser/bridge?code=${encodeURIComponent(code)}`;
+}
+export function newPairingNonce() {
+    return randomUUID();
+}
+//# sourceMappingURL=pairing.js.map

package/dist/services/local-browser/pairing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.js","sourceRoot":"","sources":["../../../src/services/local-browser/pairing.ts"],"names":[],"mappings":"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"}

package/dist/services/local-browser/registry.d.ts

@@ -0,0 +1,39 @@
+import type { LocalBrowserSession, LocalBrowserTab, LocalBrowserTier } from "@tickernelz/paperclip-pro-shared";
+import type { BridgeSocket, LiveSession, PendingCall, ViewerListener, ViewerPayload } from "./types.js";
+export declare function hashSessionToken(token: string): string;
+export declare function mintSessionToken(): string;
+export declare function registerSession(input: {
+    socket: BridgeSocket;
+    companyId: string;
+    connectionId: string;
+    createdByUserId: string | null;
+    createdByAgentId: string | null;
+    client: LiveSession["client"];
+    clientVersion: string;
+    label: string;
+    profileName: string | null;
+    tabs: LocalBrowserTab[];
+    tier: LocalBrowserTier;
+    allowedOrigins: string[];
+    tokenHash: string;
+    sessionId?: string;
+    now?: Date;
+}): LiveSession;
+export declare function getSession(sessionId: string): LiveSession | null;
+export declare function findSessionByTokenHash(tokenHash: string): LiveSession | null;
+export declare function liveSessionsForCompany(companyId: string): LiveSession[];
+export declare function liveSessionsForAgent(companyId: string, agentId: string): LiveSession[];
+export declare function touchSession(session: LiveSession, now?: Date): void;
+export declare function updateSessionTabs(session: LiveSession, tabs: LocalBrowserTab[]): void;
+export declare function updateSessionTier(session: LiveSession, tier: LocalBrowserTier, allowedOrigins: string[]): void;
+export declare function nextCallId(): string;
+export declare function addPendingCall(session: LiveSession, call: PendingCall): void;
+export declare function takePendingCall(session: LiveSession, id: string): PendingCall | null;
+export declare function failPendingCalls(session: LiveSession, error: unknown): void;
+export declare function removeSession(sessionId: string, reason: "closed" | "disconnected" | "terminated" | "server_shutdown"): LiveSession | null;
+export declare function subscribeViewer(session: LiveSession, listener: ViewerListener): () => void;
+export declare function publishViewerPayload(session: LiveSession, payload: ViewerPayload): void;
+export declare function viewerCount(session: LiveSession): number;
+export declare function toPublicSession(session: LiveSession): LocalBrowserSession;
+export declare function resetSessions(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/services/local-browser/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/services/local-browser/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAE/G,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKxG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,IAAI,EAAE,gBAAgB,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,WAAW,CAyBd;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAEhE;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAI5E;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAIvE;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAEtF;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAa,GAAG,IAAI,CAEzE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,IAAI,CAErF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,CAG9G;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAE5E;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAMpF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAM3E;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,cAAc,GAAG,YAAY,GAAG,iBAAiB,GAAG,WAAW,GAAG,IAAI,CAyBzI;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI,CAK1F;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAQvF;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAExD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,mBAAmB,CAgBzE;AAED,wBAAgB,aAAa,IAAI,IAAI,CAMpC"}

package/dist/services/local-browser/registry.js

@@ -0,0 +1,149 @@
+import { createHash, randomBytes, randomUUID } from "node:crypto";
+import { localBrowserFailure } from "./errors.js";
+const sessions = new Map();
+const sessionIdByTokenHash = new Map();
+export function hashSessionToken(token) {
+    return createHash("sha256").update(token).digest("hex");
+}
+export function mintSessionToken() {
+    return randomBytes(32).toString("base64url");
+}
+export function registerSession(input) {
+    const now = input.now ?? new Date();
+    const sessionId = input.sessionId ?? randomUUID();
+    const session = {
+        sessionId,
+        connectionId: input.connectionId,
+        companyId: input.companyId,
+        createdByUserId: input.createdByUserId,
+        createdByAgentId: input.createdByAgentId,
+        socket: input.socket,
+        client: input.client,
+        clientVersion: input.clientVersion,
+        label: input.label,
+        profileName: input.profileName,
+        tabs: input.tabs,
+        tier: input.tier,
+        allowedOrigins: input.allowedOrigins,
+        connectedAt: now,
+        lastSeenAt: now,
+        pending: new Map(),
+        viewers: new Set(),
+    };
+    sessions.set(sessionId, session);
+    sessionIdByTokenHash.set(input.tokenHash, sessionId);
+    return session;
+}
+export function getSession(sessionId) {
+    return sessions.get(sessionId) ?? null;
+}
+export function findSessionByTokenHash(tokenHash) {
+    const sessionId = sessionIdByTokenHash.get(tokenHash);
+    if (!sessionId)
+        return null;
+    return sessions.get(sessionId) ?? null;
+}
+export function liveSessionsForCompany(companyId) {
+    return [...sessions.values()]
+        .filter((session) => session.companyId === companyId)
+        .sort((left, right) => left.connectedAt.getTime() - right.connectedAt.getTime());
+}
+export function liveSessionsForAgent(companyId, agentId) {
+    return liveSessionsForCompany(companyId).filter((session) => session.createdByAgentId === agentId);
+}
+export function touchSession(session, now = new Date()) {
+    session.lastSeenAt = now;
+}
+export function updateSessionTabs(session, tabs) {
+    session.tabs = tabs;
+}
+export function updateSessionTier(session, tier, allowedOrigins) {
+    session.tier = tier;
+    session.allowedOrigins = allowedOrigins;
+}
+export function nextCallId() {
+    return randomUUID();
+}
+export function addPendingCall(session, call) {
+    session.pending.set(call.id, call);
+}
+export function takePendingCall(session, id) {
+    const call = session.pending.get(id);
+    if (!call)
+        return null;
+    session.pending.delete(id);
+    clearTimeout(call.timer);
+    return call;
+}
+export function failPendingCalls(session, error) {
+    for (const call of [...session.pending.values()]) {
+        session.pending.delete(call.id);
+        clearTimeout(call.timer);
+        call.reject(error);
+    }
+}
+export function removeSession(sessionId, reason) {
+    const session = sessions.get(sessionId);
+    if (!session)
+        return null;
+    sessions.delete(sessionId);
+    for (const [tokenHash, mapped] of sessionIdByTokenHash) {
+        if (mapped === sessionId)
+            sessionIdByTokenHash.delete(tokenHash);
+    }
+    failPendingCalls(session, localBrowserFailure("local_browser_extension_unavailable", reason === "closed"
+        ? "The paired browser was closed"
+        : "The browser extension disconnected", {
+        retryable: true,
+        hint: "Reconnect the browser extension, then call local_browser_sessions to confirm it is live.",
+    }));
+    for (const listener of [...session.viewers]) {
+        listener({ type: "state", state: "disconnected", message: reason === "closed" ? "Browser session closed" : "Browser disconnected" });
+    }
+    session.viewers.clear();
+    return session;
+}
+export function subscribeViewer(session, listener) {
+    session.viewers.add(listener);
+    return () => {
+        session.viewers.delete(listener);
+    };
+}
+export function publishViewerPayload(session, payload) {
+    for (const listener of [...session.viewers]) {
+        try {
+            listener(payload);
+        }
+        catch {
+            session.viewers.delete(listener);
+        }
+    }
+}
+export function viewerCount(session) {
+    return session.viewers.size;
+}
+export function toPublicSession(session) {
+    const view = {
+        sessionId: session.sessionId,
+        connectionId: session.connectionId,
+        client: session.client,
+        clientVersion: session.clientVersion,
+        label: session.label,
+        profileName: session.profileName,
+        ownerUserId: session.createdByUserId,
+        tier: session.tier,
+        connectedAt: session.connectedAt.toISOString(),
+        lastSeenAt: session.lastSeenAt.toISOString(),
+        tabs: session.tabs,
+        controlledByViewer: session.viewers.size > 0,
+    };
+    return view;
+}
+export function resetSessions() {
+    for (const session of [...sessions.values()]) {
+        failPendingCalls(session, localBrowserFailure("local_browser_extension_unavailable", "Server restarted", { retryable: true }));
+    }
+    sessions.clear();
+    sessionIdByTokenHash.clear();
+}
+//# sourceMappingURL=registry.js.map

package/dist/services/local-browser/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/services/local-browser/registry.ts"],"names":[],"mappings":"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"}