@relaymessenger/pi 0.1.0-staging.0

package/LICENSE

@@ -0,0 +1,3 @@
+MIT License
+
+Copyright (c) Relay Messenger

package/README.md

@@ -0,0 +1,8 @@
+# @relaymessenger/pi
+
+Relay channel for Pi. It consumes Relay's acknowledged Agent WebSocket, runs
+each inbound Message through Pi RPC mode, and sends one final text reply.
+
+`relay connect pi` configures and runs this path for you. For a direct
+integration, pass `agentToken`, optionally `baseURL` and `piCommand`, then use
+`runPiChannel()`.

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import Relay from "@relaymessenger/sdk";
+export interface PiChannelOptions {
+    readonly agentToken: string;
+    readonly baseURL?: string;
+    readonly piCommand?: string;
+    readonly piArgs?: readonly string[];
+    readonly spawnPi?: (command: string, args: readonly string[]) => PiProcess;
+    readonly relay?: Relay;
+}
+export interface PiProcess {
+    readonly stdin: {
+        write(data: string): void;
+        end(): void;
+    };
+    readonly stdout: AsyncIterable<string>;
+    readonly kill: () => void;
+}
+export declare class PiChannel {
+    #private;
+    constructor(options: PiChannelOptions);
+    run(signal?: AbortSignal): Promise<void>;
+}
+export declare const runPiChannel: (options: PiChannelOptions, signal?: AbortSignal) => Promise<void>;

package/dist/index.js

@@ -0,0 +1,92 @@
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+import Relay, {} from "@relaymessenger/sdk";
+class ChildPiProcess {
+    #child;
+    constructor(command, args) {
+        this.#child = spawn(command, [...args], { stdio: ["pipe", "pipe", "pipe"] });
+        this.#child.stderr.resume();
+    }
+    get stdin() { return this.#child.stdin; }
+    get stdout() { return createInterface({ input: this.#child.stdout }); }
+    kill = () => { this.#child.kill(); };
+}
+const textFromEvent = (event) => {
+    if (event.event_type !== "message.received" || event.data.direction !== "inbound")
+        return null;
+    return event.data.parts.filter((part) => part.type === "text" || part.type === "link").map((part) => part.value).join("\n").trim() || null;
+};
+export class PiChannel {
+    #relay;
+    #options;
+    #spawnPi;
+    constructor(options) {
+        if (!options.agentToken.trim())
+            throw new Error("Relay Agent Token is required");
+        this.#options = options;
+        this.#relay = options.relay ?? new Relay({
+            apiKey: options.agentToken,
+            ...(options.baseURL ? { baseURL: options.baseURL } : {}),
+        });
+        this.#spawnPi = options.spawnPi ?? ((command, args) => new ChildPiProcess(command, args));
+    }
+    async run(signal) {
+        await this.#relay.websocket.run({
+            ...(signal ? { signal } : {}),
+            onEvent: async (event) => { await this.#handle(event); },
+            onFullSync: async () => { },
+        });
+    }
+    async #handle(event) {
+        const message = textFromEvent(event);
+        if (!message)
+            return;
+        const pi = this.#spawnPi(this.#options.piCommand ?? "pi", ["--mode", "rpc", ...(this.#options.piArgs ?? [])]);
+        try {
+            const lines = pi.stdout[Symbol.asyncIterator]();
+            let id = 0;
+            const readResponse = async (requestId, command) => {
+                for (;;) {
+                    const item = await lines.next();
+                    if (item.done)
+                        throw new Error("Pi RPC process exited before responding");
+                    const record = JSON.parse(item.value);
+                    if (record.type === "response" && record.id === requestId) {
+                        if (record.success === false)
+                            throw new Error(record.error ?? `Pi RPC ${command} failed`);
+                        return record;
+                    }
+                }
+            };
+            const promptId = String(++id);
+            pi.stdin.write(JSON.stringify({ id: promptId, type: "prompt", message }) + "\n");
+            await readResponse(promptId, "prompt");
+            let settled = false;
+            while (!settled) {
+                const item = await lines.next();
+                if (item.done)
+                    throw new Error("Pi RPC process exited before settling");
+                const record = JSON.parse(item.value);
+                settled = record.type === "agent_settled";
+            }
+            const textId = String(++id);
+            pi.stdin.write(JSON.stringify({ id: textId, type: "get_last_assistant_text" }) + "\n");
+            const response = await readResponse(textId, "get_last_assistant_text");
+            const answer = response.data?.text?.trim();
+            if (!answer)
+                throw new Error("Pi returned no final text answer");
+            const data = event.data;
+            await this.#relay.chats.messages.send(data.chat.id, {
+                message: {
+                    parts: [{ type: "text", value: answer }],
+                    idempotency_key: `pi-${event.event_id}`,
+                },
+            });
+        }
+        finally {
+            pi.stdin.end();
+            pi.kill();
+        }
+    }
+}
+export const runPiChannel = (options, signal) => new PiChannel(options).run(signal);

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@relaymessenger/pi",
+  "version": "0.1.0-staging.0",
+  "description": "Relay Messenger channel for Pi over Relay v1 WebSocket delivery.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "license": "MIT",
+  "packageManager": "npm@12.0.2",
+  "engines": { "node": ">=22.22.3" },
+  "files": ["dist/", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": { "@relaymessenger/sdk": "0.3.3-staging.7" },
+  "devDependencies": {
+    "@types/node": "26.0.0",
+    "typescript": "7.0.2",
+    "vitest": "4.1.10"
+  },
+  "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org/", "tag": "staging", "provenance": true },
+  "repository": { "type": "git", "url": "git+https://github.com/RelayMessenger/Relay-SDK.git", "directory": "packages/pi" },
+  "homepage": "https://github.com/RelayMessenger/Relay-SDK/tree/main/packages/pi#readme",
+  "keywords": ["relay", "pi", "channel", "messaging"]
+}