@mquan/portal 0.0.1

package/dist/src/provider/codex/websocket-client.d.ts

@@ -0,0 +1,40 @@
+import type { CodexAppServerMethod, CodexAppServerMethods, CodexAppServerNotification, CodexAppServerNotifications, InitializeResponse } from "./protocol.js";
+type NotificationListener<M extends CodexAppServerNotification> = (params: CodexAppServerNotifications[M]) => void;
+export interface WebSocketLike {
+    readonly readyState: number;
+    send(data: string): void;
+    close(): void;
+    addEventListener(type: "open", listener: () => void, options?: {
+        once?: boolean;
+    }): void;
+    addEventListener(type: "message", listener: (event: {
+        data: unknown;
+    }) => void): void;
+    addEventListener(type: "error", listener: () => void, options?: {
+        once?: boolean;
+    }): void;
+    addEventListener(type: "close", listener: () => void, options?: {
+        once?: boolean;
+    }): void;
+}
+export interface CodexWebSocketClientOptions {
+    requestTimeoutMs?: number;
+    clientVersion?: string;
+    webSocketFactory?: (address: string) => WebSocketLike;
+}
+/** JSON-RPC client for a Codex app-server WebSocket endpoint. */
+export declare class CodexWebSocketClient {
+    #private;
+    private constructor();
+    static connect(address: string, options?: CodexWebSocketClientOptions): Promise<CodexWebSocketClient>;
+    get initializeResult(): InitializeResponse;
+    request<M extends CodexAppServerMethod>(method: M, params: CodexAppServerMethods[M]["params"]): Promise<CodexAppServerMethods[M]["result"]>;
+    /**
+     * Subscribe to one app-server notification. The returned function is
+     * idempotent and removes only this listener.
+     */
+    subscribe<M extends CodexAppServerNotification>(method: M, listener: NotificationListener<M>): () => void;
+    close(): void;
+    private notify;
+}
+export {};

package/dist/src/provider/codex/websocket-client.js

@@ -0,0 +1,174 @@
+/** JSON-RPC client for a Codex app-server WebSocket endpoint. */
+export class CodexWebSocketClient {
+    #initializeResult;
+    #socket;
+    #timeoutMs;
+    #pending = new Map();
+    #notificationListeners = new Map();
+    #nextId = 1;
+    #closed = false;
+    constructor(socket, timeoutMs, initializeResult) {
+        this.#socket = socket;
+        this.#timeoutMs = timeoutMs;
+        this.#initializeResult = initializeResult;
+        socket.addEventListener("message", (event) => this.#handleMessage(event.data));
+        socket.addEventListener("close", () => this.#handleClose(new Error("Codex app-server WebSocket closed")));
+        socket.addEventListener("error", () => this.#handleClose(new Error("Codex app-server WebSocket failed")));
+    }
+    static async connect(address, options = {}) {
+        const socket = (options.webSocketFactory ?? defaultWebSocketFactory)(address);
+        await waitForOpen(socket, options.requestTimeoutMs ?? 10_000);
+        const client = new CodexWebSocketClient(socket, options.requestTimeoutMs ?? 10_000, { userAgent: "", codexHome: "", platformFamily: "", platformOs: "" });
+        try {
+            const initialized = await client.request("initialize", {
+                clientInfo: {
+                    name: "portal",
+                    title: "Portal",
+                    version: options.clientVersion ?? "0.0.1",
+                },
+                capabilities: null,
+            });
+            client.#initializeResult = initialized;
+            client.notify("initialized");
+            return client;
+        }
+        catch (error) {
+            client.close();
+            throw error;
+        }
+    }
+    get initializeResult() {
+        return this.#initializeResult;
+    }
+    request(method, params) {
+        if (this.#closed)
+            return Promise.reject(new Error("Codex app-server WebSocket client is closed"));
+        const id = this.#nextId++;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.#pending.delete(id);
+                reject(new Error(`Codex app-server request timed out: ${method}`));
+            }, this.#timeoutMs);
+            timer.unref();
+            this.#pending.set(id, { method, timer, resolve, reject });
+            this.#socket.send(JSON.stringify({ id, method, params }));
+        });
+    }
+    /**
+     * Subscribe to one app-server notification. The returned function is
+     * idempotent and removes only this listener.
+     */
+    subscribe(method, listener) {
+        if (this.#closed)
+            throw new Error("Codex app-server WebSocket client is closed");
+        const listeners = this.#notificationListeners.get(method) ?? new Set();
+        const untypedListener = listener;
+        listeners.add(untypedListener);
+        this.#notificationListeners.set(method, listeners);
+        let subscribed = true;
+        return () => {
+            if (!subscribed)
+                return;
+            subscribed = false;
+            listeners.delete(untypedListener);
+            if (listeners.size === 0)
+                this.#notificationListeners.delete(method);
+        };
+    }
+    close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.#failPending(new Error("Codex app-server WebSocket client closed"));
+        this.#notificationListeners.clear();
+        this.#socket.close();
+    }
+    notify(method) {
+        this.#socket.send(JSON.stringify({ method }));
+    }
+    #handleMessage(data) {
+        let message;
+        try {
+            message = JSON.parse(typeof data === "string" ? data : String(data));
+        }
+        catch {
+            return;
+        }
+        if (isRpcNotification(message)) {
+            this.#dispatchNotification(message);
+            return;
+        }
+        if (!isRpcResponse(message))
+            return;
+        const pending = this.#pending.get(message.id);
+        if (pending === undefined)
+            return;
+        this.#pending.delete(message.id);
+        clearTimeout(pending.timer);
+        if (message.error !== undefined) {
+            pending.reject(new Error(`${pending.method}: ${message.error.message}`));
+        }
+        else {
+            pending.resolve(message.result);
+        }
+    }
+    #handleClose(error) {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.#failPending(error);
+        this.#notificationListeners.clear();
+    }
+    #dispatchNotification(notification) {
+        const listeners = this.#notificationListeners.get(notification.method);
+        if (listeners === undefined)
+            return;
+        // Snapshot so listeners can safely unsubscribe themselves while handling an event.
+        for (const listener of [...listeners])
+            listener(notification.params);
+    }
+    #failPending(error) {
+        for (const pending of this.#pending.values()) {
+            clearTimeout(pending.timer);
+            pending.reject(error);
+        }
+        this.#pending.clear();
+    }
+}
+function defaultWebSocketFactory(address) {
+    return new WebSocket(address);
+}
+function waitForOpen(socket, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const finish = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            if (error === undefined)
+                resolve();
+            else
+                reject(error);
+        };
+        const timer = setTimeout(() => finish(new Error("Codex app-server WebSocket connection timed out")), timeoutMs);
+        timer.unref();
+        socket.addEventListener("open", () => finish(), { once: true });
+        socket.addEventListener("error", () => finish(new Error("Codex app-server WebSocket connection failed")), {
+            once: true,
+        });
+    });
+}
+function isRpcResponse(value) {
+    if (value === null || typeof value !== "object")
+        return false;
+    const candidate = value;
+    return typeof candidate.id === "number" && ("result" in candidate || "error" in candidate);
+}
+function isRpcNotification(value) {
+    if (value === null || typeof value !== "object")
+        return false;
+    const candidate = value;
+    return candidate.id === undefined && typeof candidate.method === "string";
+}
+//# sourceMappingURL=websocket-client.js.map

package/dist/src/provider/codex/websocket-client.js.map

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

package/dist/src/provider/types.d.ts

@@ -0,0 +1,35 @@
+export type ProviderName = "codex" | "claude";
+export type SessionState = "active" | "idle" | "historical" | "unknown";
+export type CapabilityConfidence = "verified" | "inferred" | "unavailable";
+export interface ProviderSession {
+    provider: ProviderName;
+    vendorSessionId: string;
+    workspace: string | null;
+    title: string | null;
+    createdAt: Date | null;
+    updatedAt: Date | null;
+    state: SessionState;
+    stateConfidence: CapabilityConfidence;
+    indexed: boolean;
+    connected: boolean;
+    messageable: boolean;
+}
+export interface TranscriptEntry {
+    sourceId: string;
+    vendorSessionId: string;
+    role: "user" | "assistant" | "tool" | "system" | "other";
+    text: string;
+    occurredAt: Date | null;
+}
+export interface ProviderAdapter {
+    readonly name: ProviderName;
+    doctor(): Promise<ProviderDiagnostic>;
+    listSessions(): Promise<ProviderSession[]>;
+    readTranscript(vendorSessionId: string): Promise<TranscriptEntry[]>;
+}
+export interface ProviderDiagnostic {
+    provider: ProviderName;
+    available: boolean;
+    version: string | null;
+    detail: string;
+}

package/dist/src/provider/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/provider/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/provider/types.ts"],"names":[],"mappings":""}

package/dist/src/recall/embedding.d.ts

@@ -0,0 +1,28 @@
+export interface EmbeddingProvider {
+    /** Changes whenever embeddings produced by the provider are incompatible. */
+    readonly id: string;
+    readonly dimensions: number;
+    embed(text: string): readonly number[] | Promise<readonly number[]>;
+}
+export interface FeatureHashEmbeddingOptions {
+    dimensions?: number;
+    aliases?: Readonly<Record<string, readonly string[]>>;
+}
+/**
+ * A zero-dependency embedding for offline use and deterministic tests.
+ *
+ * It hashes word, word-pair, stem, character-trigram, and small alias features
+ * into a normalized vector. It is deliberately a lexical-semantic baseline,
+ * not a replacement for a learned embedding model.
+ */
+export declare class DeterministicFeatureHashEmbedding implements EmbeddingProvider {
+    readonly id: string;
+    readonly dimensions: number;
+    private readonly aliases;
+    private readonly aliasLookup;
+    constructor(options?: FeatureHashEmbeddingOptions);
+    embed(text: string): readonly number[];
+}
+export declare function cosineSimilarity(left: readonly number[], right: readonly number[]): number;
+/** High-entropy signed feature pairs used to select candidates without scanning chunks. */
+export declare function embeddingBuckets(vector: readonly number[], limit?: number): string[];

package/dist/src/recall/embedding.js

@@ -0,0 +1,142 @@
+const DEFAULT_ALIASES = {
+    authentication: ["auth", "login", "signin"],
+    database: ["db", "sqlite", "postgres", "mysql"],
+    failure: ["error", "failed", "outage", "incident"],
+    migration: ["migrate", "schema"],
+    retry: ["retries", "backoff", "reattempt"],
+};
+/**
+ * A zero-dependency embedding for offline use and deterministic tests.
+ *
+ * It hashes word, word-pair, stem, character-trigram, and small alias features
+ * into a normalized vector. It is deliberately a lexical-semantic baseline,
+ * not a replacement for a learned embedding model.
+ */
+export class DeterministicFeatureHashEmbedding {
+    id;
+    dimensions;
+    aliases;
+    aliasLookup;
+    constructor(options = {}) {
+        this.dimensions = options.dimensions ?? 384;
+        if (!Number.isInteger(this.dimensions) || this.dimensions < 32) {
+            throw new RangeError("feature-hash dimensions must be an integer of at least 32");
+        }
+        this.aliases = options.aliases ?? DEFAULT_ALIASES;
+        this.aliasLookup = buildAliasLookup(this.aliases);
+        this.id = `feature-hash-v2:${this.dimensions}:${hashString(JSON.stringify(this.aliases)).toString(16)}`;
+    }
+    embed(text) {
+        const vector = new Float64Array(this.dimensions);
+        const words = normalizeWords(text);
+        const features = [];
+        for (let index = 0; index < words.length; index += 1) {
+            const word = words[index];
+            if (word === undefined)
+                continue;
+            features.push([`w:${word}`, 1]);
+            const stem = simpleStem(word);
+            if (stem !== word)
+                features.push([`s:${stem}`, 0.7]);
+            const concept = this.aliasLookup.get(word);
+            if (concept !== undefined)
+                features.push([`a:${concept}`, 1.1]);
+            const next = words[index + 1];
+            if (next !== undefined)
+                features.push([`b:${word}_${next}`, 0.8]);
+            if (word.length >= 4) {
+                const padded = `^${word}$`;
+                for (let offset = 0; offset <= padded.length - 3; offset += 1) {
+                    features.push([`c:${padded.slice(offset, offset + 3)}`, 0.25]);
+                }
+            }
+        }
+        for (const [feature, weight] of features) {
+            const hash = hashString(feature);
+            const position = hash % this.dimensions;
+            const sign = (hash & 0x80000000) === 0 ? 1 : -1;
+            vector[position] = (vector[position] ?? 0) + sign * weight;
+        }
+        let magnitude = 0;
+        for (const value of vector)
+            magnitude += value * value;
+        magnitude = Math.sqrt(magnitude);
+        if (magnitude > 0) {
+            for (let index = 0; index < vector.length; index += 1) {
+                vector[index] = (vector[index] ?? 0) / magnitude;
+            }
+        }
+        return Array.from(vector);
+    }
+}
+export function cosineSimilarity(left, right) {
+    if (left.length !== right.length || left.length === 0)
+        return 0;
+    let dot = 0;
+    let leftMagnitude = 0;
+    let rightMagnitude = 0;
+    for (let index = 0; index < left.length; index += 1) {
+        const leftValue = left[index] ?? 0;
+        const rightValue = right[index] ?? 0;
+        dot += leftValue * rightValue;
+        leftMagnitude += leftValue * leftValue;
+        rightMagnitude += rightValue * rightValue;
+    }
+    if (leftMagnitude === 0 || rightMagnitude === 0)
+        return 0;
+    return dot / Math.sqrt(leftMagnitude * rightMagnitude);
+}
+/** High-entropy signed feature pairs used to select candidates without scanning chunks. */
+export function embeddingBuckets(vector, limit = 8) {
+    const features = vector
+        .map((value, index) => ({ index, value }))
+        .filter(({ value }) => Math.abs(value) > 1e-9)
+        .sort((left, right) => Math.abs(right.value) - Math.abs(left.value) || left.index - right.index)
+        .slice(0, limit);
+    if (features.length === 1) {
+        const feature = features[0];
+        return [`single:${feature.index}:${feature.value >= 0 ? "+" : "-"}`];
+    }
+    const buckets = [];
+    for (let left = 0; left < features.length; left += 1) {
+        for (let right = left + 1; right < features.length; right += 1) {
+            const first = features[left];
+            const second = features[right];
+            if (first === undefined || second === undefined)
+                continue;
+            const ordered = first.index < second.index ? [first, second] : [second, first];
+            buckets.push(`pair:${ordered.map(({ index, value }) => `${index}:${value >= 0 ? "+" : "-"}`).join("|")}`);
+        }
+    }
+    return buckets;
+}
+function normalizeWords(text) {
+    return (text
+        .normalize("NFKD")
+        .replace(/\p{Mark}/gu, "")
+        .toLocaleLowerCase("en-US")
+        .match(/[\p{Letter}\p{Number}]+/gu) ?? []);
+}
+function simpleStem(word) {
+    if (word.length <= 4)
+        return word;
+    return word.replace(/(ingly|edly|ation|ments|ment|ing|ies|ied|ed|es|s)$/u, (suffix) => suffix === "ies" || suffix === "ied" ? "y" : "");
+}
+function buildAliasLookup(aliases) {
+    const lookup = new Map();
+    for (const [concept, words] of Object.entries(aliases)) {
+        lookup.set(concept, concept);
+        for (const word of words)
+            lookup.set(word, concept);
+    }
+    return lookup;
+}
+function hashString(value) {
+    let hash = 0x811c9dc5;
+    for (let index = 0; index < value.length; index += 1) {
+        hash ^= value.charCodeAt(index);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return hash >>> 0;
+}
+//# sourceMappingURL=embedding.js.map

package/dist/src/recall/embedding.js.map

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

package/dist/src/recall/types.d.ts

@@ -0,0 +1,35 @@
+import type { ProviderName } from "../provider/types.js";
+export interface RecallOptions {
+    workspace: string;
+    providers?: readonly ProviderName[];
+    occurredAfter?: Date;
+    occurredBefore?: Date;
+    limit?: number;
+    maxPerSession?: number;
+    candidateLimit?: number;
+}
+export interface RecallCitation {
+    portalSessionId: string;
+    vendorSessionId: string;
+    provider: ProviderName;
+    workspace: string;
+    sourceId: string;
+    entryId: string;
+    occurredAt: Date | null;
+    uri: string;
+}
+export interface RecallEvidence {
+    chunkId: string;
+    excerpt: string;
+    score: number;
+    lexicalScore: number | null;
+    semanticScore: number | null;
+    citation: RecallCitation;
+}
+export interface RecallBundle {
+    query: string;
+    workspace: string;
+    evidence: RecallEvidence[];
+    truncated: boolean;
+    indexFreshness: Date | null;
+}

package/dist/src/recall/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/recall/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/recall/types.ts"],"names":[],"mappings":""}

package/dist/src/rpc/client.d.ts

@@ -0,0 +1,6 @@
+export interface RpcClientOptions {
+    socketPath: string;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export declare function callRpc<T>(options: RpcClientOptions, method: string, params?: unknown): Promise<T>;

package/dist/src/rpc/client.js

@@ -0,0 +1,58 @@
+import net from "node:net";
+import { randomUUID } from "node:crypto";
+import { isRpcFailure } from "./protocol.js";
+export async function callRpc(options, method, params) {
+    const id = randomUUID();
+    const socket = net.createConnection(options.socketPath);
+    socket.setEncoding("utf8");
+    const timeoutMs = options.timeoutMs ?? 5_000;
+    return new Promise((resolve, reject) => {
+        let buffered = "";
+        let settled = false;
+        const timer = setTimeout(() => {
+            socket.destroy();
+            finish(() => reject(new Error(`RPC ${method} timed out after ${timeoutMs}ms`)));
+        }, timeoutMs);
+        const finish = (callback) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            options.signal?.removeEventListener("abort", onAbort);
+            socket.end();
+            callback();
+        };
+        const onAbort = () => {
+            socket.destroy();
+            finish(() => reject(options.signal?.reason ?? new Error(`RPC ${method} aborted`)));
+        };
+        if (options.signal?.aborted === true) {
+            onAbort();
+            return;
+        }
+        options.signal?.addEventListener("abort", onAbort, { once: true });
+        socket.once("error", (error) => finish(() => reject(error)));
+        socket.on("data", (chunk) => {
+            buffered += chunk;
+            const newline = buffered.indexOf("\n");
+            if (newline < 0)
+                return;
+            try {
+                const response = JSON.parse(buffered.slice(0, newline));
+                if (response.id !== id)
+                    throw new Error("RPC response ID mismatch");
+                if (isRpcFailure(response))
+                    throw new Error(`${response.error.code}: ${response.error.message}`);
+                finish(() => resolve(response.result));
+            }
+            catch (error) {
+                finish(() => reject(error));
+            }
+        });
+        socket.once("connect", () => {
+            const request = params === undefined ? { id, method } : { id, method, params };
+            socket.write(`${JSON.stringify(request)}\n`);
+        });
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/src/rpc/client.js.map

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

package/dist/src/rpc/protocol.d.ts

@@ -0,0 +1,21 @@
+export declare const MAX_RPC_LINE_BYTES: number;
+export interface RpcRequest {
+    id: string;
+    method: string;
+    params?: unknown;
+}
+export interface RpcSuccess {
+    id: string;
+    result: unknown;
+}
+export interface RpcFailure {
+    id: string;
+    error: {
+        code: string;
+        message: string;
+        data?: unknown;
+    };
+}
+export type RpcResponse = RpcSuccess | RpcFailure;
+export declare function isRpcRequest(value: unknown): value is RpcRequest;
+export declare function isRpcFailure(response: RpcResponse): response is RpcFailure;

package/dist/src/rpc/protocol.js

@@ -0,0 +1,11 @@
+export const MAX_RPC_LINE_BYTES = 1024 * 1024;
+export function isRpcRequest(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const candidate = value;
+    return typeof candidate.id === "string" && typeof candidate.method === "string";
+}
+export function isRpcFailure(response) {
+    return "error" in response;
+}
+//# sourceMappingURL=protocol.js.map

package/dist/src/rpc/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../src/rpc/protocol.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAAC;AAwB9C,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,SAAS,GAAG,KAAgC,CAAC;IACnD,OAAO,OAAO,SAAS,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,SAAS,CAAC,MAAM,KAAK,QAAQ,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAqB;IAChD,OAAO,OAAO,IAAI,QAAQ,CAAC;AAC7B,CAAC"}

package/dist/src/rpc/server.d.ts

@@ -0,0 +1,12 @@
+import { type RpcRequest } from "./protocol.js";
+export type RpcHandler = (request: RpcRequest) => Promise<unknown>;
+export interface RpcServerOptions {
+    socketPath: string;
+    handler: RpcHandler;
+}
+export declare class RpcServer {
+    #private;
+    constructor(options: RpcServerOptions);
+    start(): Promise<void>;
+    close(): Promise<void>;
+}