@opendatalabs/personal-server-ts-lite 0.0.1-canary.00328bf

package/dist/diagnostics.d.ts

@@ -0,0 +1,166 @@
+/**
+ * PS Lite one-shot diagnostics — v1
+ *
+ * Produces a bounded, plain-JSON diagnostic snapshot that the web MCP approval
+ * page can copy verbatim when it is stuck waiting for scopes. No payload bodies
+ * or secrets are ever included.
+ *
+ * Usage:
+ *   const recorder = new DiagnosticsRecorder();
+ *   recorder.push({ phase: "indexing", detail: "scope=drive" });
+ *   // … pass recorder into createPsLiteRuntime({ diagnostics: recorder, … })
+ *   // GET /v1/diagnostics returns recorder.snapshot(syncStatus, storage)
+ */
+import type { SyncStatus } from "@opendatalabs/personal-server-ts-core/sync";
+import type { DataStoragePort } from "@opendatalabs/personal-server-ts-core/ports";
+export declare const DIAGNOSTICS_VERSION = 1;
+/** Phases that the PS / PS Lite can be in during its lifecycle. */
+export type DiagnosticsPhase = "booting" | "registering" | "routing" | "syncing" | "downloading" | "decrypting" | "indexing" | "buildingManifest" | "repairingManifest" | "generatingScopes" | "storageFailing" | "networkFailing" | "ready" | "unknown";
+/** Per-scope readiness states visible to the approval page. */
+export type ScopeReadinessStatus = "ready" | "indexing" | "waitingForPayload" | "manifestMissing" | "downloadFailed" | "decryptFailed" | "indexFailed" | "unknown";
+export interface DiagnosticsEvent {
+    /** ISO 8601 timestamp */
+    at: string;
+    phase: DiagnosticsPhase;
+    /** Free-form detail — no payload bodies or secrets */
+    detail?: string;
+    /** Associated scope identifier, if known */
+    scope?: string;
+    /** Associated file id, if known */
+    fileId?: string;
+    /** Whether this event represents an error condition */
+    error?: boolean;
+}
+export interface ScopeDiagnostics {
+    scope: string;
+    status: ScopeReadinessStatus;
+    /** ISO 8601 */
+    lastActivityAt?: string;
+    lastError?: string;
+    lastFileId?: string;
+    /** Bytes of the last payload, if known */
+    sizeBytes?: number;
+    /** How many times a repair loop has fired for this scope */
+    repairCount?: number;
+}
+export interface ActiveOperation {
+    phase: DiagnosticsPhase;
+    startedAt: string;
+    elapsedMs: number;
+    scope?: string;
+    fileId?: string;
+}
+export interface LastNetworkOperation {
+    /** e.g. "download", "upload", "gatewayGetServer" */
+    operationClass: string;
+    status: "ok" | "error";
+    elapsedMs: number;
+    /** HTTP status code or error class, no body */
+    statusOrError?: string | number;
+    at: string;
+}
+export interface StorageHealthSummary {
+    indexedDbAvailable: boolean;
+    persistenceBackend?: string;
+    opfsAvailable?: boolean;
+    entryCount?: number;
+    unsyncedCount?: number;
+    scopeCount?: number;
+}
+export interface PsLiteDiagnosticsSnapshot {
+    diagnosticVersion: 1;
+    capturedAt: string;
+    /** Current runtime active state */
+    runtimeActive: boolean | "unknown";
+    /** Current or last readiness phase */
+    currentPhase: DiagnosticsPhase;
+    /** Active operation with elapsed time, if any */
+    activeOperation: ActiveOperation | null;
+    /** Recent event ring, newest-last, bounded to MAX_EVENTS */
+    recentEvents: DiagnosticsEvent[];
+    /** Per-scope readiness where known */
+    scopes: ScopeDiagnostics[];
+    /** Sync manager status, if available */
+    sync: SyncDiagnostics | null;
+    /** Storage health, if available */
+    storage: StorageHealthSummary | null;
+    /** Most recent network/storage operation, no body */
+    lastNetworkOperation: LastNetworkOperation | null;
+    /** Repair loop counts keyed by scope */
+    repairCounts: Record<string, number>;
+    /** Whether diagnostics collection itself timed out */
+    partial: boolean;
+}
+export interface SyncDiagnostics {
+    enabled: boolean;
+    running: boolean;
+    syncing: boolean;
+    blocked: {
+        reason: string;
+        message: string;
+    } | null;
+    lastSync: string | null;
+    lastProcessedTimestamp: string | null;
+    pendingFiles: number;
+    recentErrors: Array<{
+        fileId: string | null;
+        scope: string | null;
+        message: string;
+        timestamp: string;
+    }>;
+}
+/** Options passed when recording an event. */
+export interface RecordEventOptions {
+    phase: DiagnosticsPhase;
+    detail?: string;
+    scope?: string;
+    fileId?: string;
+    error?: boolean;
+}
+/**
+ * Lightweight thread-safe (single-threaded JS) recorder.
+ *
+ * Instantiate once per PS Lite runtime; pass it into createPsLiteRuntime and
+ * call recorder.push() from sync, storage, and indexing code paths.
+ */
+export declare class DiagnosticsRecorder {
+    private readonly events;
+    private currentPhase;
+    private activeOp;
+    private lastNetwork;
+    private readonly scopeMap;
+    private readonly repairCounts;
+    push(options: RecordEventOptions): void;
+    /** Call when an async operation starts (e.g. a download or index run). */
+    beginOperation(phase: DiagnosticsPhase, scope?: string, fileId?: string): void;
+    /** Call when the async operation completes or fails. */
+    endOperation(): void;
+    /** Record a network or storage operation result without payload. */
+    recordNetworkOp(operationClass: string, status: "ok" | "error", elapsedMs: number, statusOrError?: string | number): void;
+    /** Increment the repair loop counter for a scope. */
+    recordRepair(scope: string): void;
+    /** Update per-scope readiness explicitly. */
+    setScopeStatus(scope: string, status: ScopeReadinessStatus, extra?: Partial<Omit<ScopeDiagnostics, "scope" | "status">>): void;
+    /**
+     * Mark a scope as ready after a successful index pass, unless an earlier
+     * phase found that the bounded read sidecar is missing or corrupt.
+     */
+    setScopeReadyAfterIndex(scope: string): void;
+    /** Mark a successful block-manifest write and clear any stale manifest error. */
+    setScopeManifestBuilt(scope: string): void;
+    /**
+     * Assemble a snapshot. Optionally accepts sync status and storage port to
+     * enrich the result. Runs with a hard timeout so it can never block.
+     */
+    snapshot(options?: {
+        runtimeActive?: boolean;
+        syncStatus?: SyncStatus | null;
+        storage?: DataStoragePort | null;
+    }): PsLiteDiagnosticsSnapshot;
+}
+/**
+ * Collect a diagnostic snapshot with a hard timeout so it can never block the
+ * approval page. Returns a partial snapshot if the timeout fires.
+ */
+export declare function collectDiagnosticsWithTimeout(recorder: DiagnosticsRecorder, options?: Parameters<DiagnosticsRecorder["snapshot"]>[0], timeoutMs?: number): Promise<PsLiteDiagnosticsSnapshot>;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

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

package/dist/diagnostics.js

@@ -0,0 +1,265 @@
+/**
+ * PS Lite one-shot diagnostics — v1
+ *
+ * Produces a bounded, plain-JSON diagnostic snapshot that the web MCP approval
+ * page can copy verbatim when it is stuck waiting for scopes. No payload bodies
+ * or secrets are ever included.
+ *
+ * Usage:
+ *   const recorder = new DiagnosticsRecorder();
+ *   recorder.push({ phase: "indexing", detail: "scope=drive" });
+ *   // … pass recorder into createPsLiteRuntime({ diagnostics: recorder, … })
+ *   // GET /v1/diagnostics returns recorder.snapshot(syncStatus, storage)
+ */
+export const DIAGNOSTICS_VERSION = 1;
+const MAX_EVENTS = 100;
+const DIAG_TIMEOUT_MS = 3_000;
+/**
+ * Lightweight thread-safe (single-threaded JS) recorder.
+ *
+ * Instantiate once per PS Lite runtime; pass it into createPsLiteRuntime and
+ * call recorder.push() from sync, storage, and indexing code paths.
+ */
+export class DiagnosticsRecorder {
+    events = [];
+    currentPhase = "booting";
+    activeOp = null;
+    lastNetwork = null;
+    scopeMap = new Map();
+    repairCounts = {};
+    push(options) {
+        const event = {
+            at: new Date().toISOString(),
+            phase: options.phase,
+            ...(options.detail !== undefined ? { detail: options.detail } : {}),
+            ...(options.scope !== undefined ? { scope: options.scope } : {}),
+            ...(options.fileId !== undefined ? { fileId: options.fileId } : {}),
+            ...(options.error ? { error: true } : {}),
+        };
+        this.events.push(event);
+        if (this.events.length > MAX_EVENTS) {
+            this.events.splice(0, this.events.length - MAX_EVENTS);
+        }
+        this.currentPhase = options.phase;
+        if (options.scope) {
+            const existing = this.scopeMap.get(options.scope) ?? {
+                scope: options.scope,
+                status: "unknown",
+            };
+            const next = {
+                ...existing,
+                scope: options.scope,
+                lastActivityAt: event.at,
+                ...(options.fileId ? { lastFileId: options.fileId } : {}),
+                ...(options.error && options.detail
+                    ? { lastError: options.detail }
+                    : {}),
+                status: nextScopeStatus(existing.status, options.phase, options.error),
+            };
+            this.scopeMap.set(options.scope, next);
+        }
+    }
+    /** Call when an async operation starts (e.g. a download or index run). */
+    beginOperation(phase, scope, fileId) {
+        this.activeOp = { phase, startedAt: Date.now(), scope, fileId };
+        this.currentPhase = phase;
+    }
+    /** Call when the async operation completes or fails. */
+    endOperation() {
+        this.activeOp = null;
+    }
+    /** Record a network or storage operation result without payload. */
+    recordNetworkOp(operationClass, status, elapsedMs, statusOrError) {
+        this.lastNetwork = {
+            operationClass,
+            status,
+            elapsedMs,
+            ...(statusOrError !== undefined ? { statusOrError } : {}),
+            at: new Date().toISOString(),
+        };
+    }
+    /** Increment the repair loop counter for a scope. */
+    recordRepair(scope) {
+        this.repairCounts[scope] = (this.repairCounts[scope] ?? 0) + 1;
+        const existing = this.scopeMap.get(scope) ?? {
+            scope,
+            status: "unknown",
+        };
+        this.scopeMap.set(scope, {
+            ...existing,
+            repairCount: this.repairCounts[scope],
+        });
+    }
+    /** Update per-scope readiness explicitly. */
+    setScopeStatus(scope, status, extra) {
+        const existing = this.scopeMap.get(scope) ?? { scope, status };
+        this.scopeMap.set(scope, { ...existing, ...extra, scope, status });
+    }
+    /**
+     * Mark a scope as ready after a successful index pass, unless an earlier
+     * phase found that the bounded read sidecar is missing or corrupt.
+     */
+    setScopeReadyAfterIndex(scope) {
+        const existing = this.scopeMap.get(scope);
+        if (existing && isBlockingScopeStatus(existing.status)) {
+            return;
+        }
+        this.setScopeStatus(scope, "ready");
+    }
+    /** Mark a successful block-manifest write and clear any stale manifest error. */
+    setScopeManifestBuilt(scope) {
+        const existing = this.scopeMap.get(scope) ?? {
+            scope,
+            status: "indexing",
+        };
+        const { lastError: _lastError, ...withoutError } = existing;
+        this.scopeMap.set(scope, {
+            ...withoutError,
+            scope,
+            status: "indexing",
+        });
+    }
+    /**
+     * Assemble a snapshot. Optionally accepts sync status and storage port to
+     * enrich the result. Runs with a hard timeout so it can never block.
+     */
+    snapshot(options) {
+        const now = new Date().toISOString();
+        const activeOperation = this.activeOp
+            ? {
+                phase: this.activeOp.phase,
+                startedAt: new Date(this.activeOp.startedAt).toISOString(),
+                elapsedMs: Date.now() - this.activeOp.startedAt,
+                ...(this.activeOp.scope ? { scope: this.activeOp.scope } : {}),
+                ...(this.activeOp.fileId ? { fileId: this.activeOp.fileId } : {}),
+            }
+            : null;
+        const sync = buildSyncDiagnostics(options?.syncStatus);
+        const storage = buildStorageDiagnostics(options?.storage);
+        const scopes = Array.from(this.scopeMap.values());
+        return {
+            diagnosticVersion: DIAGNOSTICS_VERSION,
+            capturedAt: now,
+            runtimeActive: options?.runtimeActive ?? "unknown",
+            currentPhase: this.currentPhase,
+            activeOperation,
+            recentEvents: [...this.events],
+            scopes,
+            sync,
+            storage,
+            lastNetworkOperation: this.lastNetwork,
+            repairCounts: { ...this.repairCounts },
+            partial: false,
+        };
+    }
+}
+function phaseToScopeStatus(phase, error) {
+    if (error) {
+        if (phase === "downloading")
+            return "downloadFailed";
+        if (phase === "decrypting")
+            return "decryptFailed";
+        if (phase === "indexing")
+            return "indexFailed";
+        if (phase === "buildingManifest" || phase === "repairingManifest")
+            return "manifestMissing";
+        return "unknown";
+    }
+    switch (phase) {
+        case "ready":
+            return "ready";
+        case "indexing":
+            return "indexing";
+        case "downloading":
+            return "waitingForPayload";
+        case "buildingManifest":
+        case "repairingManifest":
+            return "indexing";
+        default:
+            return "unknown";
+    }
+}
+function nextScopeStatus(existingStatus, phase, error) {
+    if (!error && isBlockingScopeStatus(existingStatus)) {
+        return existingStatus;
+    }
+    return phaseToScopeStatus(phase, error);
+}
+function isBlockingScopeStatus(status) {
+    return (status === "manifestMissing" ||
+        status === "downloadFailed" ||
+        status === "decryptFailed" ||
+        status === "indexFailed");
+}
+function buildSyncDiagnostics(status) {
+    if (!status)
+        return null;
+    return {
+        enabled: status.enabled,
+        running: status.running,
+        syncing: status.syncing,
+        blocked: status.blocked ?? null,
+        lastSync: status.lastSync,
+        lastProcessedTimestamp: status.lastProcessedTimestamp,
+        pendingFiles: status.pendingFiles,
+        recentErrors: status.errors.map((e) => ({
+            fileId: e.fileId,
+            scope: e.scope,
+            message: e.message,
+            timestamp: e.timestamp,
+        })),
+    };
+}
+function buildStorageDiagnostics(storage) {
+    if (!storage)
+        return null;
+    try {
+        const scopeResult = storage.listScopes({ limit: 1000 });
+        const unsynced = storage.findUnsynced({ limit: 1000 });
+        return {
+            indexedDbAvailable: typeof indexedDB !== "undefined",
+            persistenceBackend: storage.kind,
+            scopeCount: scopeResult.total,
+            unsyncedCount: unsynced.length,
+        };
+    }
+    catch {
+        return {
+            indexedDbAvailable: typeof indexedDB !== "undefined",
+        };
+    }
+}
+/**
+ * Collect a diagnostic snapshot with a hard timeout so it can never block the
+ * approval page. Returns a partial snapshot if the timeout fires.
+ */
+export async function collectDiagnosticsWithTimeout(recorder, options, timeoutMs = DIAG_TIMEOUT_MS) {
+    return new Promise((resolve) => {
+        const tid = setTimeout(() => {
+            resolve({ ...recorder.snapshot(options), partial: true });
+        }, timeoutMs);
+        try {
+            const snap = recorder.snapshot(options);
+            clearTimeout(tid);
+            resolve(snap);
+        }
+        catch {
+            clearTimeout(tid);
+            resolve({
+                diagnosticVersion: DIAGNOSTICS_VERSION,
+                capturedAt: new Date().toISOString(),
+                runtimeActive: options?.runtimeActive ?? "unknown",
+                currentPhase: "unknown",
+                activeOperation: null,
+                recentEvents: [],
+                scopes: [],
+                sync: null,
+                storage: null,
+                lastNetworkOperation: null,
+                repairCounts: {},
+                partial: true,
+            });
+        }
+    });
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export { createIndexedDbPsLiteRuntime, type IndexedDbPsLiteRuntime, type IndexedDbPsLiteRuntimeOptions, } from "./browser-runtime.js";
+export { startPersonalServer, type StartPersonalServerLiteOptions, type StartPersonalServerLiteRelayOptions, } from "./client.js";
+export type { PersonalServerHandle, PersonalServerClientErrorBody, PersonalServerDataVersion, PersonalServerHealthRegistration, PersonalServerIdentity, PersonalServerInfo, PersonalServerAuthRequestOptions, PersonalServerListDataOptions, PersonalServerListDataResult, PersonalServerListVersionsOptions, PersonalServerListVersionsResult, PersonalServerReadDataOptions, PersonalServerRegistrationRequest, PersonalServerStatus, PersonalServerSyncTriggerResult, PersonalServerUrls, } from "@opendatalabs/personal-server-ts-core/client";
+export { PersonalServerClientError, dataListPath, dataReadPath, dataVersionsPath, parsePersonalServerJsonResponse, } from "@opendatalabs/personal-server-ts-core/client";
+export { handlePsLiteBridgeRequest, type PsLiteBridgeRequest, type PsLiteBridgeResponse, } from "./bridge.js";
+export { createIndexedDbPsLitePersistence, createOpfsPsLiteDataFileStore, createPersistentPsLiteStorage, isOpfsAvailable, type IndexedDbPsLitePersistenceOptions, type PsLiteDataFileStore, type PsLiteFileStorageKind, type PsLitePersistedStorageState, type PsLitePersistenceAdapter, type PsLiteStorageCapabilities, type PsLiteStoragePort, } from "./storage.js";
+export { createIndexedDbPsLiteAccessLogStore, createIndexedDbPsLiteStateStore, createIndexedDbPsLiteTokenStore, loadOrCreatePsLiteConfig, loadOrCreatePsLiteServerIdentity, loadPsLiteRelayState, savePsLiteConfig, savePsLiteRelayState, type IndexedDbPsLiteAccessLogStoreOptions, type IndexedDbPsLiteStateStoreOptions, type IndexedDbPsLiteTokenStoreOptions, type PsLiteEncryptedPrivateKey, type PsLiteEncryptedServerIdentity, type PsLiteRelayState, type PsLiteStateKey, type PsLiteStateStore, type PsLiteUnlockedServerIdentity, } from "./state.js";
+export { createPsLitePendingBlobDeletionStore, createPsLiteSyncCursor, createPsLiteSyncManager, type PsLiteSyncOptions, type PsLiteOwnerSyncSigner, } from "./sync.js";
+export { resolvePsLiteOwner, type PsLiteOwnerBindingInput, } from "./owner-binding.js";
+export { createPsLiteDerivativeCompute, createPsLiteQuestionStore, psLiteInferenceConfigured, type PsLiteDerivativeCompute, type PsLiteDerivativeComputeOptions, } from "./derivatives.js";
+export { createBearerTokenPsLiteAuth, createPsLiteRuntime, createWeb3SignedPsLiteAuth, type BearerTokenPsLiteAuthOptions, type PsLiteAuthAdapter, type PsLiteReadAuthInput, type PsLiteRuntime, type PsLiteRuntimeOptions, type PsLiteStorageAdapter, type PsLiteTokenStore, type PsLiteWriteSessionAuthOptions, type Web3SignedPsLiteAuthOptions, } from "./runtime.js";
+export { createInMemoryWriteProofReplayStore, createInMemoryWriteSessionStore, hashWriteSessionToken, verifyStoredWriterAttribution, WRITE_SIGNATURE_HEADER, WRITER_ATTRIBUTION_KEY, type WriteProofReplayStore, type WriteSessionRecord, type WriteSessionStore, } from "@opendatalabs/personal-server-ts-core/write";
+export { createIndexedDbMcpConnectionStore, createIndexedDbMcpOAuthAuthorizationStore, type IndexedDbMcpConnectionStoreOptions, type IndexedDbMcpOAuthAuthorizationStoreOptions, } from "./mcp-store.js";
+export { DiagnosticsRecorder, collectDiagnosticsWithTimeout, DIAGNOSTICS_VERSION, type ActiveOperation, type DiagnosticsEvent, type DiagnosticsPhase, type LastNetworkOperation, type PsLiteDiagnosticsSnapshot, type RecordEventOptions, type ScopeDiagnostics, type ScopeReadinessStatus, type StorageHealthSummary, type SyncDiagnostics, } from "./diagnostics.js";
+export { decodeDataFrame, encodeDataFrame, psLiteRelayControlUrl, psLiteRelayPublicUrl, RELAY_CLOSE_SESSION_REPLACED, startPsLiteRelayClient, type PsLiteRelayClient, type PsLiteRelayClientOptions, type PsLiteRelayCloseEvent, type PsLiteRelayStatus, type PsLiteRelayTlsFactory, type PsLiteRelayTlsPrepareInput, type PsLiteRelayTlsStep, type PsLiteRelayTlsStream, type PsLiteRelayTlsStreamInput, type PsLiteRelayWebSocket, type PsLiteRelayWebSocketFactory, } from "./relay.js";
+export { createLocalStoragePsLiteRelayTlsIdentityStore, createRustlsPsLiteRelayTlsFactory, psLiteRelayPublicHost, psLiteRelayPublicUrl as psLiteRelayTlsPublicUrl, type PsLiteRelayTlsIdentity, type PsLiteRelayTlsIdentityStore, type RustlsPsLiteRelayTlsOptions, } from "./relay-tls.js";
+export { assertCompletePsLitePersistenceBundle, psLitePersistenceRuntimeOptions, type PsLitePersistenceBundle, type PsLitePersistenceRuntimeOptions, } from "./persistence.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,19 @@
+export { createIndexedDbPsLiteRuntime, } from "./browser-runtime.js";
+export { startPersonalServer, } from "./client.js";
+export { PersonalServerClientError, dataListPath, dataReadPath, dataVersionsPath, parsePersonalServerJsonResponse, } from "@opendatalabs/personal-server-ts-core/client";
+export { handlePsLiteBridgeRequest, } from "./bridge.js";
+export { createIndexedDbPsLitePersistence, createOpfsPsLiteDataFileStore, createPersistentPsLiteStorage, isOpfsAvailable, } from "./storage.js";
+export { createIndexedDbPsLiteAccessLogStore, createIndexedDbPsLiteStateStore, createIndexedDbPsLiteTokenStore, loadOrCreatePsLiteConfig, loadOrCreatePsLiteServerIdentity, loadPsLiteRelayState, savePsLiteConfig, savePsLiteRelayState, } from "./state.js";
+export { createPsLitePendingBlobDeletionStore, createPsLiteSyncCursor, createPsLiteSyncManager, } from "./sync.js";
+export { resolvePsLiteOwner, } from "./owner-binding.js";
+export { createPsLiteDerivativeCompute, createPsLiteQuestionStore, psLiteInferenceConfigured, } from "./derivatives.js";
+export { createBearerTokenPsLiteAuth, createPsLiteRuntime, createWeb3SignedPsLiteAuth, } from "./runtime.js";
+// Delegated builder writes: hosts that build their own auth adapter (or want
+// one store shared across several runtimes) wire these themselves.
+export { createInMemoryWriteProofReplayStore, createInMemoryWriteSessionStore, hashWriteSessionToken, verifyStoredWriterAttribution, WRITE_SIGNATURE_HEADER, WRITER_ATTRIBUTION_KEY, } from "@opendatalabs/personal-server-ts-core/write";
+export { createIndexedDbMcpConnectionStore, createIndexedDbMcpOAuthAuthorizationStore, } from "./mcp-store.js";
+export { DiagnosticsRecorder, collectDiagnosticsWithTimeout, DIAGNOSTICS_VERSION, } from "./diagnostics.js";
+export { decodeDataFrame, encodeDataFrame, psLiteRelayControlUrl, psLiteRelayPublicUrl, RELAY_CLOSE_SESSION_REPLACED, startPsLiteRelayClient, } from "./relay.js";
+export { createLocalStoragePsLiteRelayTlsIdentityStore, createRustlsPsLiteRelayTlsFactory, psLiteRelayPublicHost, psLiteRelayPublicUrl as psLiteRelayTlsPublicUrl, } from "./relay-tls.js";
+export { assertCompletePsLitePersistenceBundle, psLitePersistenceRuntimeOptions, } from "./persistence.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,GAG7B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,mBAAmB,GAGpB,MAAM,aAAa,CAAC;AAmBrB,OAAO,EACL,yBAAyB,EACzB,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,+BAA+B,GAChC,MAAM,8CAA8C,CAAC;AAEtD,OAAO,EACL,yBAAyB,GAG1B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,gCAAgC,EAChC,6BAA6B,EAC7B,6BAA6B,EAC7B,eAAe,GAQhB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,mCAAmC,EACnC,+BAA+B,EAC/B,+BAA+B,EAC/B,wBAAwB,EACxB,gCAAgC,EAChC,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,GAUrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,oCAAoC,EACpC,sBAAsB,EACtB,uBAAuB,GAGxB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,kBAAkB,GAEnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,yBAAyB,GAG1B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,0BAA0B,GAU3B,MAAM,cAAc,CAAC;AAEtB,6EAA6E;AAC7E,mEAAmE;AACnE,OAAO,EACL,mCAAmC,EACnC,+BAA+B,EAC/B,qBAAqB,EACrB,6BAA6B,EAC7B,sBAAsB,EACtB,sBAAsB,GAIvB,MAAM,6CAA6C,CAAC;AAErD,OAAO,EACL,iCAAiC,EACjC,yCAAyC,GAG1C,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,mBAAmB,EACnB,6BAA6B,EAC7B,mBAAmB,GAWpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,4BAA4B,EAC5B,sBAAsB,GAYvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,6CAA6C,EAC7C,iCAAiC,EACjC,qBAAqB,EACrB,oBAAoB,IAAI,uBAAuB,GAIhD,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qCAAqC,EACrC,+BAA+B,GAGhC,MAAM,kBAAkB,CAAC"}

package/dist/mcp-store.d.ts

@@ -0,0 +1,35 @@
+/**
+ * IndexedDB-backed `McpConnectionStore` for Web PS Lite.
+ *
+ * Phase 1 trade-off: persists the per-connection grantee private key in
+ * PLAINTEXT in IndexedDB. The owner-derived AES-GCM wrap used for the PS Lite
+ * server identity is not yet applied to grantee keys — that's the Phase 2
+ * "encrypt grantee private keys at rest" task in
+ * `260604-PLAN-vana-mcp-personal-server.md`. The risk is bounded by:
+ *
+ *   1. The browser same-origin policy — only code running on the PS Lite tab's
+ *      origin (e.g. app-dev.vana.org) can read this store.
+ *   2. Grantee keys are scoped per-connection and revocable. A leaked key only
+ *      lets the holder read the grants that connection already approved; any
+ *      revoke removes both the grant and the connection's lookup record.
+ *   3. There are no write tools — leaked grantee keys cannot mutate user data.
+ *
+ * Persistent storage is strongly preferred over in-memory because:
+ *   - app-dev page reloads are routine in a browser app;
+ *   - Claude's MCP URL is meant to live in the Claude config across sessions;
+ *   - the alternative (re-create on every boot) would silently invalidate every
+ *     prior Claude connection on every reload, indistinguishable from a real
+ *     revoke from the user's perspective.
+ */
+import { type McpConnectionStore, type McpOAuthAuthorizationStore } from "@opendatalabs/personal-server-ts-core/mcp";
+export interface IndexedDbMcpConnectionStoreOptions {
+    dbName?: string;
+    storeName?: string;
+}
+export interface IndexedDbMcpOAuthAuthorizationStoreOptions {
+    dbName?: string;
+    storeName?: string;
+}
+export declare function createIndexedDbMcpConnectionStore(options?: IndexedDbMcpConnectionStoreOptions): McpConnectionStore;
+export declare function createIndexedDbMcpOAuthAuthorizationStore(options?: IndexedDbMcpOAuthAuthorizationStoreOptions): McpOAuthAuthorizationStore;
+//# sourceMappingURL=mcp-store.d.ts.map

package/dist/mcp-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-store.d.ts","sourceRoot":"","sources":["../src/mcp-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAIL,KAAK,kBAAkB,EAEvB,KAAK,0BAA0B,EAChC,MAAM,2CAA2C,CAAC;AAqBnD,MAAM,WAAW,kCAAkC;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0CAA0C;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8ID,wBAAgB,iCAAiC,CAC/C,OAAO,GAAE,kCAAuC,GAC/C,kBAAkB,CAqFpB;AAED,wBAAgB,yCAAyC,CACvD,OAAO,GAAE,0CAA+C,GACvD,0BAA0B,CA0E5B"}