@mquan/portal 0.0.1

package/dist/src/rpc/server.js

@@ -0,0 +1,154 @@
+import { mkdir, chmod, lstat, unlink } from "node:fs/promises";
+import net from "node:net";
+import path from "node:path";
+import { isRpcRequest, MAX_RPC_LINE_BYTES } from "./protocol.js";
+function failure(id, code, message, data) {
+    return data === undefined ? { id, error: { code, message } } : { id, error: { code, message, data } };
+}
+async function removeStaleSocket(socketPath) {
+    try {
+        const stat = await lstat(socketPath);
+        if (!stat.isSocket())
+            throw new Error(`Refusing to replace non-socket path: ${socketPath}`);
+        if (await socketAcceptsConnections(socketPath)) {
+            throw new Error(`Portal daemon is already listening at ${socketPath}`);
+        }
+        await unlink(socketPath);
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+}
+async function socketAcceptsConnections(socketPath) {
+    return new Promise((resolve, reject) => {
+        const socket = net.createConnection(socketPath);
+        let settled = false;
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            socket.destroy();
+            resolve(value);
+        };
+        const timer = setTimeout(() => finish(true), 500);
+        timer.unref();
+        socket.once("connect", () => finish(true));
+        socket.once("error", (error) => {
+            if (settled)
+                return;
+            if (error.code === "ECONNREFUSED" || error.code === "ENOENT")
+                finish(false);
+            else {
+                settled = true;
+                clearTimeout(timer);
+                reject(error);
+            }
+        });
+    });
+}
+export class RpcServer {
+    #options;
+    #server = null;
+    #sockets = new Set();
+    constructor(options) {
+        this.#options = options;
+    }
+    async start() {
+        if (this.#server !== null)
+            return;
+        const directory = path.dirname(this.#options.socketPath);
+        await mkdir(directory, { recursive: true, mode: 0o700 });
+        await chmod(directory, 0o700);
+        await removeStaleSocket(this.#options.socketPath);
+        const server = net.createServer((socket) => {
+            this.#sockets.add(socket);
+            socket.once("close", () => this.#sockets.delete(socket));
+            this.#serve(socket);
+        });
+        this.#server = server;
+        try {
+            await new Promise((resolve, reject) => {
+                server.once("error", reject);
+                server.listen(this.#options.socketPath, () => {
+                    server.off("error", reject);
+                    resolve();
+                });
+            });
+        }
+        catch (error) {
+            this.#server = null;
+            throw error;
+        }
+        await chmod(this.#options.socketPath, 0o600);
+    }
+    async close() {
+        const server = this.#server;
+        this.#server = null;
+        if (server !== null) {
+            await new Promise((resolve) => {
+                let settled = false;
+                const finish = () => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    clearTimeout(deadline);
+                    resolve();
+                };
+                const deadline = setTimeout(() => {
+                    for (const socket of this.#sockets)
+                        socket.destroy();
+                    finish();
+                }, 1_000);
+                deadline.unref();
+                server.close(() => finish());
+            });
+        }
+        await removeStaleSocket(this.#options.socketPath);
+    }
+    #serve(socket) {
+        socket.setEncoding("utf8");
+        let buffered = "";
+        socket.on("data", (chunk) => {
+            buffered += chunk;
+            if (Buffer.byteLength(buffered) > MAX_RPC_LINE_BYTES) {
+                socket.end(`${JSON.stringify(failure("unknown", "request_too_large", "RPC request exceeded size limit"))}\n`);
+                return;
+            }
+            let newline = buffered.indexOf("\n");
+            while (newline >= 0) {
+                const line = buffered.slice(0, newline);
+                buffered = buffered.slice(newline + 1);
+                if (line.trim())
+                    void this.#handleLine(socket, line);
+                newline = buffered.indexOf("\n");
+            }
+        });
+    }
+    async #handleLine(socket, line) {
+        let response;
+        let value;
+        try {
+            value = JSON.parse(line);
+        }
+        catch {
+            response = failure("unknown", "invalid_json", "Request is not valid JSON");
+            socket.write(`${JSON.stringify(response)}\n`);
+            return;
+        }
+        if (!isRpcRequest(value)) {
+            response = failure("unknown", "invalid_request", "Request requires string id and method");
+        }
+        else {
+            try {
+                response = { id: value.id, result: await this.#options.handler(value) };
+            }
+            catch (error) {
+                response = failure(value.id, "handler_error", error instanceof Error ? error.message : "Unknown handler error");
+            }
+        }
+        socket.write(`${JSON.stringify(response)}\n`);
+    }
+}
+//# sourceMappingURL=server.js.map

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

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

package/dist/src/runtime/paths.d.ts

@@ -0,0 +1,8 @@
+export interface PortalPaths {
+    stateDir: string;
+    databasePath: string;
+    runtimeDir: string;
+    socketPath: string;
+    controlTokenPath: string;
+}
+export declare function resolvePortalPaths(environment?: NodeJS.ProcessEnv): PortalPaths;

package/dist/src/runtime/paths.js

@@ -0,0 +1,18 @@
+import os from "node:os";
+import path from "node:path";
+export function resolvePortalPaths(environment = process.env) {
+    const stateDir = environment.PORTAL_STATE_DIR ??
+        (process.platform === "darwin"
+            ? path.join(os.homedir(), "Library", "Application Support", "Portal")
+            : path.join(environment.XDG_STATE_HOME ?? path.join(os.homedir(), ".local", "state"), "portal"));
+    const runtimeDir = environment.PORTAL_RUNTIME_DIR ??
+        path.join(environment.XDG_RUNTIME_DIR ?? os.tmpdir(), `portal-${process.getuid?.() ?? "user"}`);
+    return {
+        stateDir,
+        databasePath: path.join(stateDir, "portal.db"),
+        runtimeDir,
+        socketPath: path.join(runtimeDir, "portald.sock"),
+        controlTokenPath: path.join(runtimeDir, "control.token"),
+    };
+}
+//# sourceMappingURL=paths.js.map

package/dist/src/runtime/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/runtime/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAU7B,MAAM,UAAU,kBAAkB,CAAC,WAAW,GAAsB,OAAO,CAAC,GAAG;IAC7E,MAAM,QAAQ,GACZ,WAAW,CAAC,gBAAgB;QAC5B,CAAC,OAAO,CAAC,QAAQ,KAAK,QAAQ;YAC5B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE,QAAQ,CAAC;YACrE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,cAAc,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IAErG,MAAM,UAAU,GACd,WAAW,CAAC,kBAAkB;QAC9B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,eAAe,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,UAAU,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,MAAM,EAAE,CAAC,CAAC;IAElG,OAAO;QACL,QAAQ;QACR,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC;QAC9C,UAAU;QACV,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC;QACjD,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC;KACzD,CAAC;AACJ,CAAC"}

package/dist/src/service.d.ts

@@ -0,0 +1,127 @@
+import type { ProviderAdapter, ProviderName } from "./provider/types.js";
+import type { RecallBundle, RecallOptions } from "./recall/types.js";
+import { type SessionReachability } from "./session-profile.js";
+import { PortalIndex } from "./portal-index.js";
+import type { MessageReceipt, StoredMessage, StoredRemoteTaskEvent, StoredSession, StoredSessionProfile } from "./storage/repository.js";
+export interface RefreshError {
+    provider: ProviderName;
+    vendorSessionId: string | null;
+    message: string;
+}
+export interface RefreshResult {
+    observed: number;
+    indexed: number;
+    unchanged: number;
+    errors: RefreshError[];
+    sessions: StoredSession[];
+}
+export interface PortalServiceOptions {
+    databasePath: string;
+    providers?: readonly ProviderAdapter[];
+}
+export interface SendMessageInput {
+    senderSessionId: string;
+    targetSessionId?: string;
+    targetReference?: string;
+    body: string;
+    idempotencyKey?: string;
+    replyTo?: string | null;
+}
+export interface ResolutionCandidate {
+    portalSessionId: string;
+    displayName: string;
+    description: string;
+    reachability: SessionReachability;
+    score: number;
+    reasons: string[];
+}
+export interface MessageResolution {
+    status: "resolved" | "ambiguous" | "unresolved";
+    query: string;
+    strategy?: "id" | "exact" | "normalized" | "profile" | "intent" | "idempotent";
+    targetSessionId?: string;
+    candidates: ResolutionCandidate[];
+}
+export interface SentMessageResult {
+    message: StoredMessage;
+    delivery: "completed" | "failed" | "delivered" | "queued_inbox" | "queued_unavailable";
+    receipt?: MessageReceipt;
+    resolution: MessageResolution;
+}
+export interface UnresolvedMessageResult {
+    message: null;
+    delivery: "not_sent";
+    resolution: MessageResolution;
+}
+export type SendMessageResult = SentMessageResult | UnresolvedMessageResult;
+export interface SessionView extends StoredSession {
+    profile: StoredSessionProfile | null;
+    reachability: SessionReachability;
+}
+export interface RunnerDelivery {
+    source: "local" | "remote";
+    message: StoredMessage;
+    senderLabel: string;
+    senderReference: string;
+    authenticated: boolean;
+    remoteEvent?: StoredRemoteTaskEvent;
+}
+export type RunnerCompletion = MessageReceipt | StoredRemoteTaskEvent;
+export interface PreparedManagedSession {
+    session: StoredSession;
+    token: string;
+}
+/** Coordinates adapters, the durable index, recall, and the message queue. */
+export declare class PortalService {
+    #private;
+    readonly index: PortalIndex;
+    readonly providers: readonly ProviderAdapter[];
+    constructor(options: PortalServiceOptions);
+    close(): Promise<void>;
+    refresh(options?: {
+        workspace?: string;
+        providers?: readonly ProviderName[];
+    }): Promise<RefreshResult>;
+    listSessions(workspace?: string): SessionView[];
+    resolveSession(reference: string, workspace?: string): StoredSession;
+    issueSessionCredential(reference: string, workspace?: string): {
+        sessionId: string;
+        token: string;
+    };
+    prepareManagedSession(input: {
+        provider: ProviderName;
+        vendorSessionId: string;
+        workspace: string;
+        title?: string | null;
+        managedName?: string | null;
+        initialPrompt?: string | null;
+    }): PreparedManagedSession;
+    authenticateSession(sessionId: string, token: string): StoredSession;
+    disconnectSession(sessionId: string, token: string): void;
+    finishManagedSession(sessionId: string, token: string): void;
+    bindManagedSession(sessionId: string, token: string, vendorSessionId: string): StoredSession;
+    recall(query: string, options: RecallOptions & {
+        refresh?: boolean;
+    }): Promise<RecallBundle>;
+    send(input: SendMessageInput): Promise<SendMessageResult>;
+    private resolveMessageTarget;
+    private rankedRoutingCandidates;
+    private saveDerivedProfile;
+    private sessionReachability;
+    nextRunnerMessage(sessionId: string, token: string, waitMs?: number): Promise<RunnerDelivery | null>;
+    runnerMessageReceived(sessionId: string, token: string, messageId: string, turnId: string): RunnerCompletion;
+    runnerMessageStarting(sessionId: string, token: string, messageId: string): RunnerCompletion;
+    heartbeatRunner(sessionId: string, token: string): {
+        active: true;
+    };
+    runnerMessageCompleted(sessionId: string, token: string, messageId: string, input: {
+        turnId: string;
+        answer: string | null;
+        toolResults: readonly unknown[];
+    }): RunnerCompletion;
+    runnerMessageFailed(sessionId: string, token: string, messageId: string, error: string): RunnerCompletion;
+    disconnectRunner(sessionId: string, token: string): void;
+    private waitForRunnerCompletion;
+    inbox(targetSessionId: string): StoredMessage[];
+    receiveInbox(targetSessionId: string, acknowledgements?: readonly string[]): StoredMessage[];
+}