happy2 0.0.5 → 0.0.11

package/packages/happy2-server/dist/modules/plugin/types.d.ts

@@ -0,0 +1,157 @@
+export type PluginVariableKind = "secret" | "text";
+export type PluginInstallationStatus = "preparing" | "starting" | "ready" | "broken_configuration" | "failed";
+export interface PluginVariableDefinition {
+    key: string;
+    displayName: string;
+    description: string;
+    kind: PluginVariableKind;
+}
+export interface PluginStdioMcp {
+    type: "stdio";
+    command: string;
+    args: string[];
+    container?: {
+        dockerfile: string;
+    };
+}
+export interface PluginRemoteMcp {
+    type: "remote";
+    url: string;
+    headers: Readonly<Record<string, string>>;
+}
+export type PluginMcp = PluginStdioMcp | PluginRemoteMcp;
+export interface PluginManifest {
+    schemaVersion: 1;
+    version: string;
+    displayName: string;
+    shortName: string;
+    description: string;
+    variables: PluginVariableDefinition[];
+    mcp?: PluginMcp;
+}
+export interface PluginSkillSummary {
+    name: string;
+    description: string;
+    directory: string;
+}
+export interface PluginImageMetadata {
+    contentType: "image/png";
+    size: number;
+    width: number;
+    height: number;
+    thumbhash: string;
+    checksumSha256: string;
+}
+export interface PluginPackage {
+    manifest: PluginManifest;
+    skills: PluginSkillSummary[];
+    directory: string;
+    iconPath: string;
+    image: PluginImageMetadata;
+    packageDigest: string;
+    source: {
+        kind: "builtin";
+        reference: string;
+    };
+}
+export interface SystemPluginSummary {
+    id: string;
+    displayName: string;
+    shortName: string;
+    description: string;
+    sourceKind: "builtin";
+    sourceReference: string;
+    sourceVersion: string;
+    packageDigest: string;
+    variables: PluginVariableDefinition[];
+    mcp?: {
+        type: "remote" | "stdio";
+        container: "bundled" | "selection_required" | "none";
+    };
+    image: PluginImageMetadata & {
+        url: string;
+    };
+    installedByUserId?: string;
+    installedAt: string;
+    updatedAt: string;
+}
+export interface PluginInstallationSummary {
+    id: string;
+    pluginId: string;
+    shortName: string;
+    sourceKind: "builtin";
+    sourceReference: string;
+    sourceVersion: string;
+    packageDigest: string;
+    status: PluginInstallationStatus;
+    statusDetail?: string;
+    lastError?: string;
+    containerImageId?: string;
+    installedByUserId?: string;
+    installedAt: string;
+    updatedAt: string;
+    readyAt?: string;
+}
+export interface PluginFunctionDefinition {
+    description: string;
+    label: string;
+    name: string;
+    parameters: Readonly<Record<string, unknown>>;
+}
+export type PluginFunctionResult = {
+    status: "completed";
+    output?: unknown;
+} | {
+    status: "failed";
+    error: {
+        code?: string;
+        data?: unknown;
+        message: string;
+    };
+};
+export interface PluginCatalogItem {
+    displayName: string;
+    shortName: string;
+    description: string;
+    version: string;
+    packageDigest: string;
+    iconUrl: string;
+    skills: PluginSkillSummary[];
+    mcp?: {
+        type: "remote" | "stdio";
+        container: "bundled" | "selection_required" | "none";
+    };
+    variables: PluginVariableDefinition[];
+    systemPlugin?: SystemPluginSummary & {
+        updateAvailable: boolean;
+        installations: PluginInstallationSummary[];
+    };
+}
+interface PluginRuntimePackage {
+    installationId: string;
+    pluginId: string;
+    shortName: string;
+    packageDirectory: string;
+    packageDigest: string;
+}
+export type PluginRuntimeConfiguration = PluginRuntimePackage & ({
+    type: "stdio";
+    command: string;
+    args: string[];
+    environment: Readonly<Record<string, string>>;
+    containerName: string;
+    imageTag: string;
+    bundledDockerfile?: string;
+} | {
+    type: "remote";
+    url: string;
+    headers: Readonly<Record<string, string>>;
+} | {
+    type: "skills_only";
+});
+export declare class PluginError extends Error {
+    readonly code: "broken_configuration" | "forbidden" | "not_found" | "not_ready";
+    constructor(code: "broken_configuration" | "forbidden" | "not_found" | "not_ready", message: string);
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/packages/happy2-server/dist/modules/plugin/types.d.ts.map

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

package/packages/happy2-server/dist/modules/plugin/types.js

@@ -0,0 +1,9 @@
+export class PluginError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "PluginError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/packages/happy2-server/dist/modules/plugin/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../sources/modules/plugin/types.ts"],"names":[],"mappings":"AAqKA,MAAM,OAAO,WAAY,SAAQ,KAAK;IAErB,IAAI;IADjB,YACa,IAAsE,EAC/E,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;oBAHN,IAAI;QAIb,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC9B,CAAC;CACJ"}

package/packages/happy2-server/dist/modules/plugin/utils/ndjsonStreamTransport.d.ts

@@ -0,0 +1,19 @@
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import { type JSONRPCMessage } from "@modelcontextprotocol/sdk/types.js";
+import type { SandboxTerminalHandle } from "../../sandbox/index.js";
+/** MCP transport over one long-lived newline-delimited stdio process in a plugin container. */
+export declare class NdjsonStreamTransport implements Transport {
+    private readonly handle;
+    onclose?: () => void;
+    onerror?: (error: Error) => void;
+    onmessage?: (message: JSONRPCMessage) => void;
+    private buffer;
+    private started;
+    private closed;
+    constructor(handle: SandboxTerminalHandle);
+    start(): Promise<void>;
+    send(message: JSONRPCMessage): Promise<void>;
+    close(): Promise<void>;
+    private read;
+}
+//# sourceMappingURL=ndjsonStreamTransport.d.ts.map

package/packages/happy2-server/dist/modules/plugin/utils/ndjsonStreamTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjsonStreamTransport.d.ts","sourceRoot":"","sources":["../../../../sources/modules/plugin/utils/ndjsonStreamTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC/F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAKpE,+FAA+F;AAC/F,qBAAa,qBAAsB,YAAW,SAAS;IAQvC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPnC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9C,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IAEvB,YAA6B,MAAM,EAAE,qBAAqB,EAAI;IAExD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAqB3B;IAEK,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjD;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAgB3B;IAED,OAAO,CAAC,IAAI;CA+Bf"}

package/packages/happy2-server/dist/modules/plugin/utils/ndjsonStreamTransport.js

@@ -0,0 +1,97 @@
+import { JSONRPCMessageSchema } from "@modelcontextprotocol/sdk/types.js";
+const MAX_MESSAGE_BYTES = 8 * 1024 * 1024;
+const GRACEFUL_CLOSE_MS = 250;
+/** MCP transport over one long-lived newline-delimited stdio process in a plugin container. */
+export class NdjsonStreamTransport {
+    handle;
+    onclose;
+    onerror;
+    onmessage;
+    buffer = "";
+    started = false;
+    closed = false;
+    constructor(handle) {
+        this.handle = handle;
+    }
+    async start() {
+        if (this.started)
+            throw new Error("Plugin MCP transport was already started");
+        this.started = true;
+        this.handle.stdout.setEncoding("utf8");
+        this.handle.stdout.on("data", (chunk) => this.read(chunk));
+        this.handle.stdout.on("error", (error) => this.onerror?.(error));
+        this.handle.stdin.on("error", (error) => this.onerror?.(error));
+        this.handle.stderr.on("data", () => undefined);
+        void this.handle.wait.then(({ exitCode, signal }) => {
+            if (this.closed)
+                return;
+            const detail = signal ? `signal ${signal}` : `exit code ${exitCode ?? -1}`;
+            this.onerror?.(new Error(`Plugin MCP process stopped with ${detail}`));
+            void this.close();
+        }, (error) => {
+            if (!this.closed)
+                this.onerror?.(error instanceof Error ? error : new Error(String(error)));
+            void this.close();
+        });
+    }
+    async send(message) {
+        if (!this.started || this.closed)
+            throw new Error("Plugin MCP transport is not open");
+        const line = `${JSON.stringify(message)}\n`;
+        if (Buffer.byteLength(line, "utf8") > MAX_MESSAGE_BYTES)
+            throw new Error("Plugin MCP message exceeds the 8 MiB limit");
+        await new Promise((resolve, reject) => this.handle.stdin.write(line, "utf8", (error) => (error ? reject(error) : resolve())));
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.handle.stdin.end();
+        const exited = await Promise.race([
+            this.handle.wait.then(() => true, () => true),
+            new Promise((resolve) => {
+                const timer = setTimeout(() => resolve(false), GRACEFUL_CLOSE_MS);
+                timer.unref();
+            }),
+        ]);
+        if (!exited)
+            this.handle.close();
+        this.onclose?.();
+    }
+    read(chunk) {
+        if (this.closed)
+            return;
+        this.buffer += chunk;
+        for (;;) {
+            const newline = this.buffer.indexOf("\n");
+            if (newline < 0) {
+                if (Buffer.byteLength(this.buffer, "utf8") > MAX_MESSAGE_BYTES) {
+                    this.onerror?.(new Error("Plugin MCP output exceeded the 8 MiB message limit"));
+                    void this.close();
+                }
+                return;
+            }
+            const line = this.buffer.slice(0, newline).replace(/\r$/, "");
+            this.buffer = this.buffer.slice(newline + 1);
+            if (!line)
+                continue;
+            if (Buffer.byteLength(line, "utf8") > MAX_MESSAGE_BYTES) {
+                this.onerror?.(new Error("Plugin MCP output exceeded the 8 MiB message limit"));
+                void this.close();
+                return;
+            }
+            try {
+                const message = JSONRPCMessageSchema.parse(JSON.parse(line));
+                this.onmessage?.(message);
+                if (this.closed)
+                    return;
+            }
+            catch {
+                this.onerror?.(new Error("Plugin MCP process emitted invalid JSON-RPC"));
+                void this.close();
+                return;
+            }
+        }
+    }
+}
+//# sourceMappingURL=ndjsonStreamTransport.js.map

package/packages/happy2-server/dist/modules/plugin/utils/ndjsonStreamTransport.js.map

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

package/packages/happy2-server/dist/modules/plugin/utils/ndjsonStreamTransport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ndjsonStreamTransport.test.d.ts.map

package/packages/happy2-server/dist/modules/plugin/utils/ndjsonStreamTransport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjsonStreamTransport.test.d.ts","sourceRoot":"","sources":["../../../../sources/modules/plugin/utils/ndjsonStreamTransport.test.ts"],"names":[],"mappings":""}

package/packages/happy2-server/dist/modules/plugin/utils/ndjsonStreamTransport.test.js

@@ -0,0 +1,74 @@
+import { PassThrough } from "node:stream";
+import { describe, expect, it } from "vitest";
+import { NdjsonStreamTransport } from "./ndjsonStreamTransport.js";
+describe("NdjsonStreamTransport", () => {
+    it("limits individual frames rather than a chunk containing several valid frames", async () => {
+        const stdin = new PassThrough();
+        const stdout = new PassThrough();
+        const stderr = new PassThrough();
+        const wait = new Promise((resolve) => stdin.once("finish", () => resolve({ exitCode: 0, signal: null })));
+        const handle = {
+            stdin,
+            stdout,
+            stderr,
+            wait,
+            close: () => undefined,
+        };
+        const transport = new NdjsonStreamTransport(handle);
+        const messages = [];
+        transport.onmessage = (message) => messages.push(message);
+        await transport.start();
+        const payload = "x".repeat(5 * 1024 * 1024);
+        stdout.write(`${JSON.stringify({ jsonrpc: "2.0", method: "first", params: { payload } })}\n${JSON.stringify({ jsonrpc: "2.0", method: "second", params: { payload } })}\n`);
+        expect(messages).toHaveLength(2);
+        expect(messages.map((message) => ("method" in message ? message.method : undefined))).toEqual(["first", "second"]);
+        await transport.close();
+    });
+    it("rejects parsed JSON that is not a JSON-RPC message", async () => {
+        const stdin = new PassThrough();
+        const stdout = new PassThrough();
+        const stderr = new PassThrough();
+        const wait = new Promise((resolve) => stdin.once("finish", () => resolve({ exitCode: 0, signal: null })));
+        const transport = new NdjsonStreamTransport({
+            stdin,
+            stdout,
+            stderr,
+            wait,
+            close: () => undefined,
+        });
+        const failure = new Promise((resolve) => {
+            transport.onerror = resolve;
+        });
+        await transport.start();
+        stdout.write("{}\n");
+        await expect(failure).resolves.toMatchObject({
+            message: "Plugin MCP process emitted invalid JSON-RPC",
+        });
+        await transport.close();
+    });
+    it("stops dispatching buffered frames when a message callback closes the transport", async () => {
+        const stdin = new PassThrough();
+        const stdout = new PassThrough();
+        const stderr = new PassThrough();
+        const wait = new Promise((resolve) => stdin.once("finish", () => resolve({ exitCode: 0, signal: null })));
+        const transport = new NdjsonStreamTransport({
+            stdin,
+            stdout,
+            stderr,
+            wait,
+            close: () => undefined,
+        });
+        const messages = [];
+        let closed;
+        transport.onmessage = (message) => {
+            messages.push(message);
+            closed = transport.close();
+        };
+        await transport.start();
+        stdout.write(`${JSON.stringify({ jsonrpc: "2.0", method: "first" })}\n${JSON.stringify({ jsonrpc: "2.0", method: "second" })}\n`);
+        await closed;
+        expect(messages).toHaveLength(1);
+        expect(messages[0]).toMatchObject({ method: "first" });
+    });
+});
+//# sourceMappingURL=ndjsonStreamTransport.test.js.map

package/packages/happy2-server/dist/modules/plugin/utils/ndjsonStreamTransport.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjsonStreamTransport.test.js","sourceRoot":"","sources":["../../../../sources/modules/plugin/utils/ndjsonStreamTransport.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAG9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,8EAA8E,EAAE,KAAK,IAAI,EAAE;QAC1F,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,IAAI,OAAO,CACpB,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAClF,CAAC;QACF,MAAM,MAAM,GAA0B;YAClC,KAAK;YACL,MAAM;YACN,MAAM;YACN,IAAI;YACJ,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;SACzB,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAqB,EAAE,CAAC;QACtC,SAAS,CAAC,SAAS,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;QAExB,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CACR,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAChK,CAAC;QAEF,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CACF,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAChF,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC/B,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,IAAI,OAAO,CACpB,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAClF,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,qBAAqB,CAAC;YACxC,KAAK;YACL,MAAM;YACN,MAAM;YACN,IAAI;YACJ,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;SACzB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,OAAO,EAAE,EAAE;YAC3C,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC;QAChC,CAAC,CAAC,CAAC;QACH,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;QAExB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAErB,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;YACzC,OAAO,EAAE,6CAA6C;SACzD,CAAC,CAAC;QACH,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gFAAgF,EAAE,KAAK,IAAI,EAAE;QAC5F,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,IAAI,OAAO,CACpB,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAClF,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,qBAAqB,CAAC;YACxC,KAAK;YACL,MAAM;YACN,MAAM;YACN,IAAI;YACJ,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;SACzB,CAAC,CAAC;QACH,MAAM,QAAQ,GAAqB,EAAE,CAAC;QACtC,IAAI,MAAiC,CAAC;QACtC,SAAS,CAAC,SAAS,GAAG,CAAC,OAAO,EAAE,EAAE;YAC9B,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC;QAC/B,CAAC,CAAC;QACF,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;QAExB,MAAM,CAAC,KAAK,CACR,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,CACtH,CAAC;QAEF,MAAM,MAAM,CAAC;QACb,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/packages/happy2-server/dist/modules/plugin/utils/remoteMcpTransport.d.ts

@@ -0,0 +1,29 @@
+import type { JSONRPCMessage } from "@modelcontextprotocol/sdk/types.js";
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import type { WebhookUrlPolicy } from "../../integrations/ssrf.js";
+import type { WebhookTransport } from "../../integrations/types.js";
+interface RemoteMcpTransportOptions {
+    headers: Readonly<Record<string, string>>;
+    installationId: string;
+    remoteTransport: WebhookTransport;
+    signal?: AbortSignal;
+    url: string;
+    urlPolicy: WebhookUrlPolicy;
+}
+/** MCP client transport that preserves Happy's public-address pinning for every remote request. */
+export declare class RemotePluginMcpTransport implements Transport {
+    private readonly options;
+    onclose?: () => void;
+    onerror?: (error: Error) => void;
+    onmessage?: <T extends JSONRPCMessage>(message: T) => void;
+    sessionId?: string;
+    private closed;
+    private protocolVersion?;
+    constructor(options: RemoteMcpTransportOptions);
+    start(): Promise<void>;
+    setProtocolVersion(version: string): void;
+    send(message: JSONRPCMessage): Promise<void>;
+    close(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=remoteMcpTransport.d.ts.map

package/packages/happy2-server/dist/modules/plugin/utils/remoteMcpTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteMcpTransport.d.ts","sourceRoot":"","sources":["../../../../sources/modules/plugin/utils/remoteMcpTransport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,UAAU,yBAAyB;IAC/B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,gBAAgB,CAAC;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,gBAAgB,CAAC;CAC/B;AAED,mGAAmG;AACnG,qBAAa,wBAAyB,YAAW,SAAS;IAQ1C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,CAAC,SAAS,cAAc,EAAE,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAAC,CAAS;IAEjC,YAA6B,OAAO,EAAE,yBAAyB,EAAI;IAE7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;IAED,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAExC;IAEK,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BjD;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAqC3B;CACJ"}

package/packages/happy2-server/dist/modules/plugin/utils/remoteMcpTransport.js

@@ -0,0 +1,126 @@
+import { createId } from "@paralleldrive/cuid2";
+/** MCP client transport that preserves Happy's public-address pinning for every remote request. */
+export class RemotePluginMcpTransport {
+    options;
+    onclose;
+    onerror;
+    onmessage;
+    sessionId;
+    closed = false;
+    protocolVersion;
+    constructor(options) {
+        this.options = options;
+    }
+    async start() {
+        if (this.closed)
+            throw new Error("Remote plugin MCP transport is closed");
+        this.options.signal?.throwIfAborted();
+    }
+    setProtocolVersion(version) {
+        this.protocolVersion = version;
+    }
+    async send(message) {
+        if (this.closed)
+            throw new Error("Remote plugin MCP transport is closed");
+        this.options.signal?.throwIfAborted();
+        const destination = await this.options.urlPolicy.resolveForDelivery(this.options.url);
+        const eventId = createId();
+        const response = await this.options.remoteTransport.deliver({
+            allowedAddresses: destination.addresses,
+            body: JSON.stringify(message),
+            deliveryId: `plugin-mcp:${this.options.installationId}:${eventId}`,
+            eventId,
+            eventType: "plugin.mcp.request",
+            headers: {
+                ...this.options.headers,
+                accept: "application/json, text/event-stream",
+                "content-type": "application/json",
+                ...(this.protocolVersion ? { "mcp-protocol-version": this.protocolVersion } : {}),
+                ...(this.sessionId ? { "mcp-session-id": this.sessionId } : {}),
+            },
+            url: destination.url,
+        });
+        this.options.signal?.throwIfAborted();
+        if (response.statusCode < 200 || response.statusCode >= 300)
+            throw new Error(`Remote MCP request returned HTTP ${response.statusCode}`);
+        const nextSessionId = response.headers?.["mcp-session-id"];
+        if (nextSessionId)
+            this.sessionId = nextSessionId;
+        for (const received of jsonRpcMessages(response.body ?? ""))
+            this.onmessage?.(received);
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        if (this.sessionId) {
+            try {
+                const destination = await this.options.urlPolicy.resolveForDelivery(this.options.url);
+                const eventId = createId();
+                const response = await this.options.remoteTransport.deliver({
+                    allowedAddresses: destination.addresses,
+                    body: "",
+                    deliveryId: `plugin-mcp-close:${this.options.installationId}:${eventId}`,
+                    eventId,
+                    eventType: "plugin.mcp.close",
+                    headers: {
+                        ...this.options.headers,
+                        ...(this.protocolVersion
+                            ? { "mcp-protocol-version": this.protocolVersion }
+                            : {}),
+                        "mcp-session-id": this.sessionId,
+                    },
+                    method: "DELETE",
+                    url: destination.url,
+                });
+                if ((response.statusCode < 200 || response.statusCode >= 300) &&
+                    response.statusCode !== 405)
+                    throw new Error(`Remote MCP session close returned HTTP ${response.statusCode}`);
+            }
+            catch (error) {
+                this.onerror?.(error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+        this.onclose?.();
+    }
+}
+function jsonRpcMessages(body) {
+    const trimmed = body.trim();
+    if (!trimmed)
+        return [];
+    const direct = jsonRpcMessage(trimmed);
+    if (direct)
+        return [direct];
+    const messages = [];
+    let data = [];
+    const flush = () => {
+        const message = jsonRpcMessage(data.join("\n"));
+        if (message)
+            messages.push(message);
+        data = [];
+    };
+    for (const line of body.split(/\r?\n/)) {
+        if (!line)
+            flush();
+        else if (line.startsWith("data:"))
+            data.push(line.slice(5).trimStart());
+    }
+    flush();
+    if (!messages.length)
+        throw new Error("Remote MCP returned an invalid JSON-RPC response");
+    return messages;
+}
+function jsonRpcMessage(source) {
+    if (!source)
+        return undefined;
+    try {
+        const value = JSON.parse(source);
+        return value && typeof value === "object" && !Array.isArray(value)
+            ? value
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=remoteMcpTransport.js.map

package/packages/happy2-server/dist/modules/plugin/utils/remoteMcpTransport.js.map

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

package/packages/happy2-server/dist/modules/plugin/utils/remoteMcpTransport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=remoteMcpTransport.test.d.ts.map

package/packages/happy2-server/dist/modules/plugin/utils/remoteMcpTransport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteMcpTransport.test.d.ts","sourceRoot":"","sources":["../../../../sources/modules/plugin/utils/remoteMcpTransport.test.ts"],"names":[],"mappings":""}

package/packages/happy2-server/dist/modules/plugin/utils/remoteMcpTransport.test.js

@@ -0,0 +1,75 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { describe, expect, it } from "vitest";
+import { RemotePluginMcpTransport } from "./remoteMcpTransport.js";
+describe("RemotePluginMcpTransport", () => {
+    it("pins every request and carries the negotiated MCP session through tool execution", async () => {
+        const requests = [];
+        const remote = {
+            async deliver(request) {
+                requests.push(structuredClone(request));
+                if (request.method === "DELETE")
+                    return { statusCode: 405 };
+                const message = JSON.parse(request.body);
+                if (message.id === undefined)
+                    return { statusCode: 202 };
+                const result = message.method === "initialize"
+                    ? {
+                        protocolVersion: "2025-06-18",
+                        capabilities: { tools: {} },
+                        serverInfo: { name: "remote-test", version: "1.0.0" },
+                    }
+                    : message.method === "tools/list"
+                        ? {
+                            tools: [
+                                {
+                                    name: "remote_echo",
+                                    description: "Echo input remotely",
+                                    inputSchema: { type: "object" },
+                                },
+                            ],
+                        }
+                        : { content: [{ type: "text", text: "remote result" }] };
+                return {
+                    statusCode: 200,
+                    body: JSON.stringify({ jsonrpc: "2.0", id: message.id, result }),
+                    ...(message.method === "initialize"
+                        ? { headers: { "mcp-session-id": "remote-session" } }
+                        : {}),
+                };
+            },
+        };
+        let resolutions = 0;
+        const transport = new RemotePluginMcpTransport({
+            headers: { authorization: "Bearer secret" },
+            installationId: "installation1",
+            remoteTransport: remote,
+            url: "https://mcp.example.test/service",
+            urlPolicy: {
+                validateForStorage: (url) => url,
+                resolveForDelivery: async (url) => {
+                    resolutions += 1;
+                    return {
+                        url,
+                        addresses: [{ address: "203.0.113.9", family: 4 }],
+                    };
+                },
+            },
+        });
+        const client = new Client({ name: "remote-test-client", version: "1.0.0" });
+        await client.connect(transport);
+        expect((await client.listTools()).tools.map(({ name }) => name)).toEqual(["remote_echo"]);
+        expect(await client.callTool({ name: "remote_echo", arguments: { value: "hello" } })).toMatchObject({ content: [{ type: "text", text: "remote result" }] });
+        await client.close();
+        expect(resolutions).toBe(requests.length);
+        expect(requests[0]?.headers).not.toHaveProperty("mcp-session-id");
+        expect(requests
+            .slice(1)
+            .every(({ headers }) => headers["mcp-session-id"] === "remote-session")).toBe(true);
+        expect(requests.slice(1).every(({ headers }) => headers.authorization === "Bearer secret")).toBe(true);
+        expect(requests.at(-1)).toMatchObject({
+            method: "DELETE",
+            headers: { "mcp-session-id": "remote-session" },
+        });
+    });
+});
+//# sourceMappingURL=remoteMcpTransport.test.js.map