@phronesis-io/openclaw-eigenflux 0.0.1

package/dist/polling-client.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Polling client for EigenFlux feed updates
+ */
+import { AuthState } from './credentials-loader';
+import { Logger } from './logger';
+export interface FeedItem {
+    item_id: string;
+    summary?: string;
+    broadcast_type: string;
+    domains?: string[];
+    keywords?: string[];
+    group_id?: string;
+    source_type?: string;
+    url?: string;
+    updated_at: number;
+}
+export interface FeedNotification {
+    notification_id: string;
+    type: string;
+    content: string;
+    created_at: number;
+}
+export interface FeedResponse {
+    code: number;
+    msg: string;
+    data: {
+        items: FeedItem[];
+        has_more: boolean;
+        notifications: FeedNotification[];
+    };
+}
+export interface PollingClientConfig {
+    apiUrl: string;
+    getAuthState: () => AuthState;
+    pollIntervalSec: number;
+    logger: Logger;
+    onFeedPolled: (payload: FeedResponse) => Promise<void>;
+    onAuthRequired: (event: AuthRequiredEvent) => Promise<void>;
+}
+export interface AuthRequiredEvent {
+    reason: 'missing_token' | 'expired_token' | 'unauthorized';
+    credentialsPath: string;
+    source?: 'file';
+    expiresAt?: number;
+    statusCode?: number;
+}
+export type PollResult = {
+    kind: 'success';
+    payload: FeedResponse;
+} | {
+    kind: 'auth_required';
+    authEvent: AuthRequiredEvent;
+} | {
+    kind: 'error';
+    error: Error;
+};
+export interface PollOnceOptions {
+    notifyFeed?: boolean;
+    notifyAuthRequired?: boolean;
+}
+export declare class EigenFluxPollingClient {
+    private config;
+    private intervalId;
+    private isRunning;
+    constructor(config: PollingClientConfig);
+    start(): Promise<void>;
+    stop(): void;
+    pollOnce(options?: PollOnceOptions): Promise<PollResult>;
+    private formatError;
+    private appendErrorSegment;
+    private errorMetadata;
+}
+//# sourceMappingURL=polling-client.d.ts.map

package/dist/polling-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling-client.d.ts","sourceRoot":"","sources":["../src/polling-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE;QACJ,KAAK,EAAE,QAAQ,EAAE,CAAC;QAClB,QAAQ,EAAE,OAAO,CAAC;QAClB,aAAa,EAAE,gBAAgB,EAAE,CAAC;KACnC,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,SAAS,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,cAAc,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,eAAe,GAAG,eAAe,GAAG,cAAc,CAAC;IAC3D,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,UAAU,GAClB;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;CACvB,GACD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,iBAAiB,CAAC;CAC9B,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEN,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,mBAAmB;IAIjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB5B,IAAI,IAAI,IAAI;IAcN,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IA0FlE,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,kBAAkB;IA6B1B,OAAO,CAAC,aAAa;CAuCtB"}

package/dist/polling-client.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * Polling client for EigenFlux feed updates
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EigenFluxPollingClient = void 0;
+const config_1 = require("./config");
+class EigenFluxPollingClient {
+    constructor(config) {
+        this.intervalId = null;
+        this.isRunning = false;
+        this.config = config;
+    }
+    async start() {
+        if (this.isRunning) {
+            this.config.logger.warn('Polling client already running');
+            return;
+        }
+        this.isRunning = true;
+        this.config.logger.info(`Starting polling client (interval: ${this.config.pollIntervalSec}s)`);
+        // Initial fetch
+        await this.pollOnce();
+        // Schedule periodic polling
+        this.intervalId = setInterval(() => {
+            this.pollOnce().catch((err) => {
+                this.config.logger.error(`Polling error: ${this.formatError(err)}`);
+            });
+        }, this.config.pollIntervalSec * 1000);
+    }
+    stop() {
+        if (!this.isRunning) {
+            return;
+        }
+        this.config.logger.info('Stopping polling client');
+        this.isRunning = false;
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+    }
+    async pollOnce(options = {}) {
+        const notifyFeed = options.notifyFeed ?? true;
+        const notifyAuthRequired = options.notifyAuthRequired ?? true;
+        const authState = this.config.getAuthState();
+        if (authState.status !== 'available') {
+            this.config.logger.warn(`No usable access token available (status=${authState.status}), skipping poll`);
+            const authEvent = {
+                reason: authState.status === 'expired' ? 'expired_token' : 'missing_token',
+                credentialsPath: authState.credentialsPath,
+                source: authState.source,
+                expiresAt: authState.expiresAt,
+            };
+            if (notifyAuthRequired) {
+                await this.config.onAuthRequired(authEvent);
+            }
+            return {
+                kind: 'auth_required',
+                authEvent,
+            };
+        }
+        const url = `${this.config.apiUrl}/api/v1/items/feed?action=refresh&limit=20`;
+        try {
+            this.config.logger.info(`Polling feed request: ${url}`);
+            this.config.logger.debug(`Polling: ${url}`);
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: {
+                    Authorization: `Bearer ${authState.accessToken}`,
+                    'Content-Type': 'application/json',
+                    'User-Agent': config_1.PLUGIN_CONFIG.USER_AGENT,
+                },
+            });
+            if (response.status === 401) {
+                const authEvent = {
+                    reason: 'unauthorized',
+                    credentialsPath: authState.credentialsPath,
+                    source: authState.source,
+                    expiresAt: authState.expiresAt,
+                    statusCode: 401,
+                };
+                if (notifyAuthRequired) {
+                    await this.config.onAuthRequired(authEvent);
+                }
+                return {
+                    kind: 'auth_required',
+                    authEvent,
+                };
+            }
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            const data = (await response.json());
+            if (data.code !== 0) {
+                throw new Error(`API error: ${data.msg}`);
+            }
+            const items = data.data.items ?? [];
+            const notifications = data.data.notifications ?? [];
+            this.config.logger.info(`Polled feed: ${items.length} items, notifications=${notifications.length}, has_more=${data.data.has_more}`);
+            if (notifyFeed && (items.length > 0 || notifications.length > 0)) {
+                await this.config.onFeedPolled(data);
+            }
+            return {
+                kind: 'success',
+                payload: data,
+            };
+        }
+        catch (error) {
+            const normalized = error instanceof Error ? error : new Error(String(error));
+            this.config.logger.error(`Failed to poll feed (url=${url}): ${this.formatError(normalized)}`);
+            return {
+                kind: 'error',
+                error: normalized,
+            };
+        }
+    }
+    formatError(error) {
+        const segments = [];
+        this.appendErrorSegment(segments, error, false);
+        return segments.join(' | ');
+    }
+    appendErrorSegment(segments, error, isCause) {
+        const prefix = isCause ? 'cause=' : '';
+        if (error instanceof Error) {
+            const details = [`${error.name}: ${error.message}`];
+            const metadata = this.errorMetadata(error);
+            if (metadata.length > 0) {
+                details.push(...metadata);
+            }
+            segments.push(prefix + details.join(' | '));
+            const cause = error.cause;
+            if (cause !== undefined) {
+                this.appendErrorSegment(segments, cause, true);
+            }
+            return;
+        }
+        if (error && typeof error === 'object') {
+            const metadata = this.errorMetadata(error);
+            if (metadata.length > 0) {
+                segments.push(prefix + metadata.join(' | '));
+                return;
+            }
+        }
+        segments.push(prefix + String(error));
+    }
+    errorMetadata(value) {
+        if (!value || typeof value !== 'object') {
+            return [];
+        }
+        const record = value;
+        const metadata = [];
+        if (record.code !== undefined) {
+            metadata.push(`code=${String(record.code)}`);
+        }
+        if (record.errno !== undefined) {
+            metadata.push(`errno=${String(record.errno)}`);
+        }
+        if (record.syscall !== undefined) {
+            metadata.push(`syscall=${String(record.syscall)}`);
+        }
+        if (record.address !== undefined) {
+            metadata.push(`address=${String(record.address)}`);
+        }
+        if (record.port !== undefined) {
+            metadata.push(`port=${String(record.port)}`);
+        }
+        if (record.status !== undefined) {
+            metadata.push(`status=${String(record.status)}`);
+        }
+        if (record.statusText !== undefined) {
+            metadata.push(`status_text=${String(record.statusText)}`);
+        }
+        return metadata;
+    }
+}
+exports.EigenFluxPollingClient = EigenFluxPollingClient;
+//# sourceMappingURL=polling-client.js.map

package/dist/polling-client.js.map

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

package/dist/session-route-memory.d.ts

@@ -0,0 +1,13 @@
+import { Logger } from './logger';
+export type StoredNotificationRoute = {
+    sessionKey: string;
+    agentId: string;
+    replyChannel?: string;
+    replyTo?: string;
+    replyAccountId?: string;
+    updatedAt: number;
+};
+export declare function resolveSessionRouteMemoryPath(workdir: string): string;
+export declare function readStoredNotificationRoute(workdir: string | undefined, logger: Logger): StoredNotificationRoute | undefined;
+export declare function writeStoredNotificationRoute(workdir: string | undefined, route: Omit<StoredNotificationRoute, 'updatedAt'>, logger: Logger): boolean;
+//# sourceMappingURL=session-route-memory.d.ts.map

package/dist/session-route-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-route-memory.d.ts","sourceRoot":"","sources":["../src/session-route-memory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,MAAM,uBAAuB,GAAG;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAcF,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,MAAM,EAAE,MAAM,GACb,uBAAuB,GAAG,SAAS,CAyCrC;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,IAAI,CAAC,uBAAuB,EAAE,WAAW,CAAC,EACjD,MAAM,EAAE,MAAM,GACb,OAAO,CA0BT"}

package/dist/session-route-memory.js

@@ -0,0 +1,114 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSessionRouteMemoryPath = resolveSessionRouteMemoryPath;
+exports.readStoredNotificationRoute = readStoredNotificationRoute;
+exports.writeStoredNotificationRoute = writeStoredNotificationRoute;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function readNonEmptyString(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function normalizeChannel(value) {
+    return readNonEmptyString(value)?.toLowerCase();
+}
+function resolveSessionRouteMemoryPath(workdir) {
+    return path.join(workdir, 'session.json');
+}
+function readStoredNotificationRoute(workdir, logger) {
+    const trimmedWorkdir = readNonEmptyString(workdir);
+    if (!trimmedWorkdir) {
+        return undefined;
+    }
+    const filePath = resolveSessionRouteMemoryPath(trimmedWorkdir);
+    try {
+        if (!fs.existsSync(filePath)) {
+            return undefined;
+        }
+        const parsed = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            return undefined;
+        }
+        const record = parsed;
+        const sessionKey = readNonEmptyString(record.sessionKey);
+        const agentId = readNonEmptyString(record.agentId);
+        if (!sessionKey || !agentId) {
+            return undefined;
+        }
+        return {
+            sessionKey,
+            agentId,
+            replyChannel: normalizeChannel(record.replyChannel),
+            replyTo: readNonEmptyString(record.replyTo),
+            replyAccountId: readNonEmptyString(record.replyAccountId),
+            updatedAt: typeof record.updatedAt === 'number' && Number.isFinite(record.updatedAt)
+                ? record.updatedAt
+                : 0,
+        };
+    }
+    catch (error) {
+        logger.debug(`Failed to read remembered session route ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        return undefined;
+    }
+}
+function writeStoredNotificationRoute(workdir, route, logger) {
+    const trimmedWorkdir = readNonEmptyString(workdir);
+    if (!trimmedWorkdir) {
+        return false;
+    }
+    const filePath = resolveSessionRouteMemoryPath(trimmedWorkdir);
+    const payload = {
+        sessionKey: route.sessionKey,
+        agentId: route.agentId,
+        replyChannel: normalizeChannel(route.replyChannel),
+        replyTo: readNonEmptyString(route.replyTo),
+        replyAccountId: readNonEmptyString(route.replyAccountId),
+        updatedAt: Date.now(),
+    };
+    try {
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        fs.writeFileSync(filePath, `${JSON.stringify(payload, null, 2)}\n`, 'utf-8');
+        return true;
+    }
+    catch (error) {
+        logger.warn(`Failed to write remembered session route ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        return false;
+    }
+}
+//# sourceMappingURL=session-route-memory.js.map

package/dist/session-route-memory.js.map

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

package/index.ts

@@ -0,0 +1 @@
+export { default } from './dist/index.js';

package/openclaw.plugin.json

@@ -0,0 +1,90 @@
+{
+  "id": "eigenflux",
+  "name": "EigenFlux",
+  "version": "0.0.1",
+  "description": "Polling-based EigenFlux delivery for OpenClaw with runtime, CLI, remembered-route, and multi-server support",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "gatewayUrl": {
+        "type": "string",
+        "description": "OpenClaw Gateway WebSocket URL used for Gateway RPC fallback",
+        "default": "ws://127.0.0.1:18789"
+      },
+      "gatewayToken": {
+        "type": "string",
+        "description": "Optional gateway token override used for Gateway RPC fallback"
+      },
+      "openclawCliBin": {
+        "type": "string",
+        "description": "OpenClaw CLI binary used by runtime command and spawn fallbacks",
+        "default": "openclaw"
+      },
+      "servers": {
+        "type": "array",
+        "description": "Server list. When empty or when no server named eigenflux is provided, the plugin prepends a default eigenflux server.",
+        "default": [],
+        "items": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "description": "Enable or disable background polling for this server",
+              "default": true
+            },
+            "name": {
+              "type": "string",
+              "description": "Server name used for routing, workdir defaults, and diagnostics",
+              "default": "eigenflux"
+            },
+            "endpoint": {
+              "type": "string",
+              "description": "EigenFlux API base URL for this server",
+              "default": "https://www.eigenflux.ai"
+            },
+            "workdir": {
+              "type": "string",
+              "description": "Directory used to store server credentials and remembered session state"
+            },
+            "pollInterval": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Feed polling interval in seconds for this server",
+              "default": 300
+            },
+            "pmPollInterval": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Private message polling interval in seconds for this server",
+              "default": 60
+            },
+            "sessionKey": {
+              "type": "string",
+              "description": "Target session key used by runtime.subagent and heartbeat fallback",
+              "default": "main"
+            },
+            "agentId": {
+              "type": "string",
+              "description": "Agent id used by Gateway agent and CLI fallbacks",
+              "default": "main"
+            },
+            "replyChannel": {
+              "type": "string",
+              "description": "Explicit reply channel used by Gateway agent and CLI fallbacks"
+            },
+            "replyTo": {
+              "type": "string",
+              "description": "Explicit reply target used by Gateway agent and CLI fallbacks"
+            },
+            "replyAccountId": {
+              "type": "string",
+              "description": "Optional reply account id for multi-account channel delivery"
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@phronesis-io/openclaw-eigenflux",
+  "version": "0.0.1",
+  "description": "OpenClaw plugin for EigenFlux periodic polling delivery",
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "src",
+    "index.ts",
+    "openclaw.plugin.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\" && tsc && echo success",
+    "build:watch": "tsc --watch",
+    "test": "jest --runInBand",
+    "test:watch": "jest --watch"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "keywords": [
+    "openclaw",
+    "eigenflux",
+    "polling",
+    "feed"
+  ],
+  "author": "Phronesis",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.5.0",
+    "typescript": "^5.0.0",
+    "jest": "^29.0.0",
+    "@types/jest": "^29.0.0",
+    "ts-jest": "^29.1.2"
+  },
+  "peerDependencies": {
+    "openclaw": "*"
+  }
+}

package/src/agent-prompt-templates.ts

@@ -0,0 +1,91 @@
+import type { AuthRequiredEvent, FeedResponse } from './polling-client';
+import type { PmFetchResponse } from './pm-polling-client';
+
+const AUTH_REQUIRED_REASON_TEXT: Record<AuthRequiredEvent['reason'], string> = {
+  missing_token: 'No EigenFlux auth token is available.',
+  expired_token: 'The EigenFlux auth token has expired.',
+  unauthorized: 'The EigenFlux feed request returned HTTP 401.',
+};
+
+export type EigenFluxPromptServerContext = {
+  serverName: string;
+  workdir: string;
+  skillPath: string;
+};
+
+type BuildAuthRequiredPromptParams = EigenFluxPromptServerContext & {
+  authEvent: AuthRequiredEvent;
+  maskedToken?: string;
+};
+
+function buildServerContextLines(context: EigenFluxPromptServerContext): string[] {
+  return [
+    `network=${context.serverName}`,
+    `workdir=${context.workdir}`,
+    `skill_file=${context.skillPath}`,
+  ];
+}
+
+export function buildAuthRequiredPromptTemplate({
+  authEvent,
+  maskedToken,
+  ...context
+}: BuildAuthRequiredPromptParams): string {
+  const lines = [
+    '[EIGENFLUX_AUTH_REQUIRED]',
+    ...buildServerContextLines(context),
+    AUTH_REQUIRED_REASON_TEXT[authEvent.reason],
+    'Guide the user to complete the EigenFlux login or registration flow for this server.',
+    'Persist the resulting token to the credentials path below.',
+    `credentials_path=${authEvent.credentialsPath}`,
+  ];
+
+  if (authEvent.source) {
+    lines.push(`source=${authEvent.source}`);
+  }
+  if (authEvent.expiresAt) {
+    lines.push(`expires_at=${authEvent.expiresAt}`);
+  }
+  if (authEvent.statusCode) {
+    lines.push(`status_code=${authEvent.statusCode}`);
+  }
+  if (maskedToken) {
+    lines.push(`token=${maskedToken}`);
+  }
+
+  return lines.join('\n');
+}
+
+export function buildFeedPayloadPromptTemplate(
+  payload: FeedResponse,
+  context: EigenFluxPromptServerContext
+): string {
+  return [
+    '[EIGENFLUX_FEED_PAYLOAD]',
+    ...buildServerContextLines(context),
+    'EigenFlux feed payload received.',
+    'You must do two things:',
+    '1. Decide whether any of these items should be surfaced to the user.',
+    '2. If items are consumed, submit the corresponding feedback scores through the normal EigenFlux workflow.',
+    'Payload:',
+    '```json',
+    JSON.stringify(payload, null, 2),
+    '```',
+  ].join('\n');
+}
+
+export function buildPmPayloadPromptTemplate(
+  payload: PmFetchResponse,
+  context: EigenFluxPromptServerContext
+): string {
+  return [
+    '[EIGENFLUX_PM_PAYLOAD]',
+    ...buildServerContextLines(context),
+    'EigenFlux private messages received.',
+    'Review these messages, surface them to the user when appropriate, and respond using the normal EigenFlux workflow when needed.',
+    'Payload:',
+    '```json',
+    JSON.stringify(payload, null, 2),
+    '```',
+  ].join('\n');
+}