@aigne/afs-matrix 1.11.0-beta.12

package/dist/index.d.mts

@@ -0,0 +1,156 @@
+import { RouteContext } from "@aigne/afs/provider";
+import { BaseMessageProvider, BotConfig, BufferedMessage, MessageCapabilities, MessageSender, SendOptions } from "@aigne/afs-messaging";
+import { AFSExecResult, AFSListResult, ProviderTreeSchema } from "@aigne/afs";
+
+//#region src/client.d.ts
+/**
+ * MatrixClient — pure Matrix Client-Server API wrapper.
+ *
+ * Zero external dependencies (uses native fetch).
+ * No AFS or application-specific concepts.
+ */
+interface MatrixClientOptions {
+  accessToken: string;
+  homeserver: string;
+  timeout?: number;
+}
+/** Matrix room message event (subset). */
+interface MatrixEvent {
+  event_id: string;
+  type: string;
+  sender: string;
+  content: {
+    msgtype?: string;
+    body?: string;
+    [key: string]: unknown;
+  };
+  origin_server_ts: number;
+  room_id?: string;
+}
+/** Matrix sync response (subset). */
+interface MatrixSyncResponse {
+  next_batch: string;
+  rooms?: {
+    join?: Record<string, {
+      timeline?: {
+        events?: MatrixEvent[];
+      };
+    }>;
+  };
+}
+/** Matrix whoami response. */
+interface MatrixWhoamiResponse {
+  user_id: string;
+  device_id?: string;
+}
+declare class MatrixClient {
+  private readonly _accessToken;
+  private readonly _homeserver;
+  private readonly _timeout;
+  constructor(options: MatrixClientOptions);
+  sendMessage(roomId: string, text: string): Promise<{
+    event_id: string;
+  }>;
+  sendTyping(roomId: string, userId: string, timeout?: number): Promise<void>;
+  sync(since?: string, timeout?: number): Promise<MatrixSyncResponse>;
+  whoami(): Promise<MatrixWhoamiResponse>;
+  private _call;
+}
+//#endregion
+//#region src/index.d.ts
+interface AFSMatrixOptions {
+  /** Multi-bot config */
+  bots?: Array<{
+    name: string;
+    token: string;
+    homeserver: string;
+    conversations?: string[];
+  }>;
+  /** Single-bot shorthand: access token */
+  accessToken?: string;
+  /** Single-bot shorthand: homeserver URL */
+  homeserver?: string;
+  /** Single-bot shorthand: room IDs to monitor */
+  rooms?: string[];
+  bufferSize?: number;
+}
+declare class AFSMatrix extends BaseMessageProvider {
+  static manifest(): {
+    name: string;
+    description: string;
+    uriTemplate: string;
+    category: string;
+    schema: {
+      type: string;
+      properties: {
+        homeserver: {
+          type: string;
+          description: string;
+        };
+        accessToken: {
+          type: string;
+          description: string;
+          sensitive: boolean;
+        };
+        rooms: {
+          type: string;
+          items: {
+            type: string;
+          };
+          description: string;
+        };
+      };
+      required: string[];
+    };
+    tags: string[];
+    capabilityTags: string[];
+    security: {
+      riskLevel: string;
+      resourceAccess: string[];
+      notes: string[];
+    };
+    capabilities: {
+      network: {
+        egress: boolean;
+      };
+    };
+  };
+  static treeSchema(): ProviderTreeSchema;
+  readonly providerName = "matrix";
+  readonly eventPrefix = "matrix";
+  private readonly _syncStates;
+  private readonly _userIds;
+  constructor(options: AFSMatrixOptions);
+  getMessageCapabilities(): MessageCapabilities;
+  createBotClient(config: BotConfig): MatrixClient;
+  sendMessage(client: unknown, convId: string, text: string, _opts?: SendOptions): Promise<{
+    messageId: string;
+  }>;
+  sendTypingIndicator(client: unknown, convId: string): Promise<void>;
+  normalizeMessage(raw: Record<string, unknown>): BufferedMessage;
+  normalizeSender(raw: Record<string, unknown>): MessageSender;
+  start(botName?: string): void;
+  stop(botName?: string): void;
+  dispose(): void;
+  listRootActions(_ctx: RouteContext): Promise<AFSListResult>;
+  execStart(_ctx: RouteContext): Promise<AFSExecResult>;
+  execStop(_ctx: RouteContext): Promise<AFSExecResult>;
+  execProcessEvent(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  private _syncLoop;
+  /** Process an externally-provided Matrix event. Public for testing. */
+  _processEvent(payload: Record<string, unknown>): void;
+  /** Add a room to a bot. Defaults to first bot. */
+  addRoom(roomId: string, botName?: string): void;
+  /** Remove a room from a bot. */
+  removeRoom(roomId: string, botName?: string): void;
+  /** Add a message to the ring buffer directly. Public for testing/conformance. */
+  _addToBuffer(roomId: string, msg: {
+    event_id: string;
+    sender: string;
+    body: string;
+    origin_server_ts?: number;
+  }): void;
+}
+//#endregion
+export { AFSMatrix, AFSMatrixOptions, type MatrixClient, type MatrixEvent, type MatrixSyncResponse, type MatrixWhoamiResponse };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/client.ts","../src/index.ts"],"mappings":";;;;;;;;;;AASA;UAAiB,mBAAA;EACf,WAAA;EACA,UAAA;EACA,OAAA;AAAA;;UAIe,WAAA;EACf,QAAA;EACA,IAAA;EACA,MAAA;EACA,OAAA;IACE,OAAA;IACA,IAAA;IAAA,CACC,GAAA;EAAA;EAEH,gBAAA;EACA,OAAA;AAAA;;UAIe,kBAAA;EACf,UAAA;EACA,KAAA;IACE,IAAA,GAAO,MAAA;MAGH,QAAA;QACE,MAAA,GAAS,WAAA;MAAA;IAAA;EAAA;AAAA;;UAQF,oBAAA;EACf,OAAA;EACA,SAAA;AAAA;AAAA,cAKW,YAAA;EAAA,iBACM,YAAA;EAAA,iBACA,WAAA;EAAA,iBACA,QAAA;cAEL,OAAA,EAAS,mBAAA;EAUf,WAAA,CAAY,MAAA,UAAgB,IAAA,WAAe,OAAA;IAAU,QAAA;EAAA;EASrD,UAAA,CAAW,MAAA,UAAgB,MAAA,UAAgB,OAAA,YAAkB,OAAA;EAQ7D,IAAA,CAAK,KAAA,WAAgB,OAAA,YAAmB,OAAA,CAAQ,kBAAA;EAOhD,MAAA,CAAA,GAAU,OAAA,CAAQ,oBAAA;EAAA,QAMV,KAAA;AAAA;;;UC1DC,gBAAA;EDbf;ECeA,IAAA,GAAO,KAAA;IACL,IAAA;IACA,KAAA;IACA,UAAA;IACA,aAAA;EAAA;EDdF;ECiBA,WAAA;EDfE;ECiBF,UAAA;EDdM;ECgBN,KAAA;EACA,UAAA;AAAA;AAAA,cAWW,SAAA,SAAkB,mBAAA;EAAA,OACtB,QAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SA6BA,UAAA,CAAA,GAAc,kBAAA;EAAA,SA6BZ,YAAA;EAAA,SACA,WAAA;EAAA,iBAEQ,WAAA;EAAA,iBACA,QAAA;cAEL,OAAA,EAAS,gBAAA;EAyCrB,sBAAA,CAAA,GAA0B,mBAAA;EAqB1B,eAAA,CAAgB,MAAA,EAAQ,SAAA,GAAY,YAAA;EAO9B,WAAA,CACJ,MAAA,WACA,MAAA,UACA,IAAA,UACA,KAAA,GAAQ,WAAA,GACP,OAAA;IAAU,SAAA;EAAA;EAMP,mBAAA,CAAoB,MAAA,WAAiB,MAAA,WAAiB,OAAA;EAa5D,gBAAA,CAAiB,GAAA,EAAK,MAAA,oBAA0B,eAAA;EAchD,eAAA,CAAgB,GAAA,EAAK,MAAA,oBAA0B,aAAA;EAa/C,KAAA,CAAM,OAAA;EAUN,IAAA,CAAK,OAAA;EAaL,OAAA,CAAA;EAcM,eAAA,CAAgB,IAAA,EAAM,YAAA,GAAe,OAAA,CAAQ,aAAA;EAuB7C,SAAA,CAAU,IAAA,EAAM,YAAA,GAAe,OAAA,CAAQ,aAAA;EAMvC,QAAA,CAAS,IAAA,EAAM,YAAA,GAAe,OAAA,CAAQ,aAAA;EAMtC,gBAAA,CACJ,IAAA,EAAM,YAAA,EACN,IAAA,EAAM,MAAA,oBACL,OAAA,CAAQ,aAAA;EAAA,QAOG,SAAA;EAtRJ;EA+UV,aAAA,CAAc,OAAA,EAAS,MAAA;EApUF;EAgWrB,OAAA,CAAQ,MAAA,UAAgB,OAAA;EAlUH;EA+UrB,UAAA,CAAW,MAAA,UAAgB,OAAA;EAnQD;EA6Q1B,YAAA,CACE,MAAA,UACA,GAAA;IACE,QAAA;IACA,MAAA;IACA,IAAA;IACA,gBAAA;EAAA;AAAA"}

package/dist/index.mjs

@@ -0,0 +1,458 @@
+import { Actions } from "@aigne/afs/provider";
+import { BaseMessageProvider } from "@aigne/afs-messaging";
+
+//#region src/client.ts
+/**
+* MatrixClient — pure Matrix Client-Server API wrapper.
+*
+* Zero external dependencies (uses native fetch).
+* No AFS or application-specific concepts.
+*/
+const DEFAULT_TIMEOUT = 3e4;
+let _txnCounter = 0;
+var MatrixClient = class {
+	_accessToken;
+	_homeserver;
+	_timeout;
+	constructor(options) {
+		if (!options.accessToken) throw new Error("MatrixClient requires an accessToken");
+		if (!options.homeserver) throw new Error("MatrixClient requires a homeserver");
+		this._accessToken = options.accessToken;
+		this._homeserver = options.homeserver.replace(/\/+$/, "");
+		this._timeout = options.timeout ?? DEFAULT_TIMEOUT;
+	}
+	async sendMessage(roomId, text) {
+		const txnId = `m${Date.now()}.${_txnCounter++}`;
+		return this._call("PUT", `/_matrix/client/v3/rooms/${encodeURIComponent(roomId)}/send/m.room.message/${txnId}`, {
+			msgtype: "m.text",
+			body: text
+		});
+	}
+	async sendTyping(roomId, userId, timeout = 1e4) {
+		await this._call("PUT", `/_matrix/client/v3/rooms/${encodeURIComponent(roomId)}/typing/${encodeURIComponent(userId)}`, {
+			typing: true,
+			timeout
+		});
+	}
+	async sync(since, timeout) {
+		const params = new URLSearchParams();
+		if (since) params.set("since", since);
+		if (timeout !== void 0) params.set("timeout", String(timeout));
+		return this._call("GET", `/_matrix/client/v3/sync?${params.toString()}`);
+	}
+	async whoami() {
+		return this._call("GET", "/_matrix/client/v3/account/whoami");
+	}
+	async _call(method, path, body) {
+		const headers = { Authorization: `Bearer ${this._accessToken}` };
+		const init = {
+			method,
+			headers,
+			signal: AbortSignal.timeout(this._timeout)
+		};
+		if (body) {
+			headers["Content-Type"] = "application/json";
+			init.body = JSON.stringify(body);
+		}
+		const response = await fetch(`${this._homeserver}${path}`, init);
+		if (!response.ok) {
+			const desc = (await response.text().catch(() => "")).replace(this._accessToken, "***");
+			throw new Error(`Matrix API error ${response.status}: ${desc}`);
+		}
+		return response.json();
+	}
+};
+
+//#endregion
+//#region \0@oxc-project+runtime@0.108.0/helpers/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+//#endregion
+//#region src/index.ts
+var AFSMatrix = class extends BaseMessageProvider {
+	static manifest() {
+		return {
+			name: "matrix",
+			description: "Matrix messaging — decentralized, federated chat protocol.\n- Sync long-poll for real-time message reception\n- Multi-bot support with per-bot room monitoring\n- Path: /:bot/conversations/:roomId/messages/:eventId",
+			uriTemplate: "matrix://{homeserver}",
+			category: "messaging",
+			schema: {
+				type: "object",
+				properties: {
+					homeserver: {
+						type: "string",
+						description: "Matrix homeserver URL"
+					},
+					accessToken: {
+						type: "string",
+						description: "Matrix access token",
+						sensitive: true
+					},
+					rooms: {
+						type: "array",
+						items: { type: "string" },
+						description: "Room IDs to monitor"
+					}
+				},
+				required: ["homeserver", "accessToken"]
+			},
+			tags: [
+				"matrix",
+				"messaging",
+				"chat",
+				"decentralized",
+				"federated"
+			],
+			capabilityTags: [
+				"read-write",
+				"crud",
+				"search",
+				"auth:token",
+				"remote",
+				"http",
+				"real-time"
+			],
+			security: {
+				riskLevel: "external",
+				resourceAccess: ["internet"],
+				notes: ["Connects to Matrix homeserver — requires access token"]
+			},
+			capabilities: { network: { egress: true } }
+		};
+	}
+	static treeSchema() {
+		return {
+			operations: [
+				"list",
+				"read",
+				"exec",
+				"stat",
+				"explain"
+			],
+			tree: {
+				"/": {
+					kind: "messaging:root",
+					operations: ["list", "exec"],
+					actions: [
+						"add-bot",
+						"remove-bot",
+						"start",
+						"stop",
+						"process-event"
+					]
+				},
+				"/{bot}": {
+					kind: "messaging:bot",
+					operations: ["list", "read"]
+				},
+				"/{bot}/ctl": {
+					kind: "messaging:status",
+					operations: ["read"]
+				},
+				"/{bot}/conversations": {
+					kind: "messaging:conversations",
+					operations: ["list"]
+				},
+				"/{bot}/conversations/{convId}": {
+					kind: "messaging:conversation",
+					operations: ["list"]
+				},
+				"/{bot}/conversations/{convId}/messages": {
+					kind: "messaging:messages",
+					operations: ["list", "exec"],
+					actions: ["send"]
+				},
+				"/{bot}/conversations/{convId}/messages/{msgId}": {
+					kind: "messaging:message",
+					operations: ["read"]
+				}
+			},
+			auth: {
+				type: "token",
+				env: ["MATRIX_ACCESS_TOKEN"]
+			},
+			bestFor: [
+				"decentralized chat",
+				"federated messaging",
+				"privacy-focused comms"
+			],
+			notFor: ["file storage", "database queries"]
+		};
+	}
+	providerName = "matrix";
+	eventPrefix = "matrix";
+	_syncStates = /* @__PURE__ */ new Map();
+	_userIds = /* @__PURE__ */ new Map();
+	constructor(options) {
+		let bots;
+		if (options.bots) {
+			bots = options.bots.map((b) => ({
+				name: b.name,
+				accessToken: b.token,
+				homeserver: b.homeserver,
+				conversations: b.conversations
+			}));
+			for (const bot of options.bots) {
+				if (!bot.token) throw new Error(`AFSMatrix bot "${bot.name}" requires a token`);
+				if (!bot.homeserver) throw new Error(`AFSMatrix bot "${bot.name}" requires a homeserver`);
+			}
+		} else {
+			if (!options.accessToken) throw new Error("AFSMatrix requires an accessToken");
+			if (!options.homeserver) throw new Error("AFSMatrix requires a homeserver");
+			bots = [{
+				name: "default",
+				accessToken: options.accessToken,
+				homeserver: options.homeserver,
+				conversations: options.rooms ?? []
+			}];
+		}
+		super({
+			bots,
+			bufferSize: options.bufferSize
+		});
+		for (const bot of bots) this._syncStates.set(bot.name, {
+			syncing: false,
+			disposed: false,
+			abort: null,
+			backoff: 1e3,
+			nextBatch: null
+		});
+	}
+	getMessageCapabilities() {
+		return {
+			formats: {
+				send: ["text", "markdown"],
+				receive: ["text"]
+			},
+			maxMessageLength: 65536,
+			features: {
+				edit: true,
+				delete: false,
+				reply: true,
+				thread: true,
+				reaction: true,
+				inlineKeyboard: false
+			},
+			limits: { messagesPerSecond: 10 }
+		};
+	}
+	createBotClient(config) {
+		return new MatrixClient({
+			accessToken: config.accessToken,
+			homeserver: config.homeserver
+		});
+	}
+	async sendMessage(client, convId, text, _opts) {
+		return { messageId: (await client.sendMessage(convId, text)).event_id };
+	}
+	async sendTypingIndicator(client, convId) {
+		const mc = client;
+		const botName = [...this._botClients.entries()].find(([, c]) => c === client)?.[0] ?? "";
+		let userId = this._userIds.get(botName);
+		if (!userId) {
+			userId = (await mc.whoami()).user_id;
+			this._userIds.set(botName, userId);
+		}
+		await mc.sendTyping(convId, userId);
+	}
+	normalizeMessage(raw) {
+		const evt = raw;
+		return {
+			id: String(evt.event_id ?? "0"),
+			text: String(evt.content?.body ?? ""),
+			from: this.normalizeSender({ sender: evt.sender }),
+			timestamp: evt.origin_server_ts ? Math.floor(evt.origin_server_ts / 1e3) : Math.floor(Date.now() / 1e3),
+			conversationId: String(evt.room_id ?? ""),
+			platform: { event_id: evt.event_id }
+		};
+	}
+	normalizeSender(raw) {
+		const sender = String(raw.sender ?? raw.id ?? "");
+		return {
+			id: sender,
+			name: sender.match(/^@([^:]+):/)?.[1] ?? sender
+		};
+	}
+	start(botName) {
+		const names = botName ? [botName] : [...this._syncStates.keys()];
+		for (const name of names) {
+			const state = this._syncStates.get(name);
+			if (!state || state.syncing || state.disposed) continue;
+			state.syncing = true;
+			this._syncLoop(name);
+		}
+	}
+	stop(botName) {
+		const names = botName ? [botName] : [...this._syncStates.keys()];
+		for (const name of names) {
+			const state = this._syncStates.get(name);
+			if (!state) continue;
+			state.syncing = false;
+			if (state.abort) {
+				state.abort.abort();
+				state.abort = null;
+			}
+		}
+	}
+	dispose() {
+		for (const [, state] of this._syncStates) {
+			state.syncing = false;
+			state.disposed = true;
+			if (state.abort) {
+				state.abort.abort();
+				state.abort = null;
+			}
+		}
+	}
+	async listRootActions(_ctx) {
+		return { data: [
+			this.buildEntry("/.actions/add-bot", { meta: { description: "Add a bot instance at runtime" } }),
+			this.buildEntry("/.actions/remove-bot", { meta: { description: "Remove a bot instance" } }),
+			this.buildEntry("/.actions/start", { meta: { description: "Start sync loop for updates" } }),
+			this.buildEntry("/.actions/stop", { meta: { description: "Stop sync loop" } }),
+			this.buildEntry("/.actions/process-event", { meta: { description: "Inject a Matrix event externally" } })
+		] };
+	}
+	async execStart(_ctx) {
+		this.start();
+		return {
+			success: true,
+			data: {
+				ok: true,
+				syncing: true
+			}
+		};
+	}
+	async execStop(_ctx) {
+		this.stop();
+		return {
+			success: true,
+			data: {
+				ok: true,
+				syncing: false
+			}
+		};
+	}
+	async execProcessEvent(_ctx, args) {
+		this._processEvent(args);
+		return {
+			success: true,
+			data: { ok: true }
+		};
+	}
+	async _syncLoop(botName) {
+		const state = this._syncStates.get(botName);
+		const client = this._getClient(botName);
+		if (!state || !client) return;
+		while (state.syncing && !state.disposed) try {
+			state.abort = new AbortController();
+			const response = await client.sync(state.nextBatch ?? void 0, 3e4);
+			state.nextBatch = response.next_batch;
+			if (response.rooms?.join) for (const [roomId, room] of Object.entries(response.rooms.join)) {
+				const events = room.timeline?.events ?? [];
+				for (const evt of events) if (evt.type === "m.room.message" && evt.content?.msgtype === "m.text") {
+					const text = String(evt.content.body ?? "").trim();
+					if (!text) continue;
+					this.emitMessageReceived(botName, {
+						id: String(evt.event_id),
+						text,
+						from: this.normalizeSender({ sender: evt.sender }),
+						timestamp: evt.origin_server_ts ? Math.floor(evt.origin_server_ts / 1e3) : Math.floor(Date.now() / 1e3),
+						conversationId: roomId,
+						platform: { event_id: evt.event_id }
+					});
+				}
+			}
+			state.backoff = 1e3;
+		} catch (err) {
+			if (state.disposed) break;
+			const msg = err instanceof Error ? err.message : "";
+			if (/API error (401|403)/.test(msg)) {
+				state.syncing = false;
+				break;
+			}
+			await new Promise((r) => setTimeout(r, state.backoff));
+			state.backoff = Math.min(state.backoff * 2, 6e4);
+		}
+	}
+	/** Process an externally-provided Matrix event. Public for testing. */
+	_processEvent(payload) {
+		const botName = payload.botName ?? this._botOrder[0] ?? "default";
+		const evt = payload;
+		const eventId = String(evt.event_id ?? evt.id ?? Date.now());
+		const sender = String(evt.sender ?? "");
+		const body = String(evt.content?.body ?? evt.body ?? "").trim();
+		const roomId = String(evt.room_id ?? evt.roomId ?? "");
+		const originServerTs = evt.origin_server_ts ?? evt.timestamp;
+		if (!body) return;
+		this.emitMessageReceived(botName, {
+			id: eventId,
+			text: body,
+			from: this.normalizeSender({ sender }),
+			timestamp: originServerTs ? Math.floor(Number(originServerTs) / 1e3) : Math.floor(Date.now() / 1e3),
+			conversationId: roomId,
+			platform: { event_id: eventId }
+		});
+	}
+	/** Add a room to a bot. Defaults to first bot. */
+	addRoom(roomId, botName) {
+		const name = botName ?? this._botOrder[0];
+		if (!name) return;
+		const convs = this._botConversations.get(name);
+		if (!convs || convs.has(roomId)) return;
+		convs.add(roomId);
+		const buffers = this._botBuffers.get(name);
+		if (buffers && !buffers.has(roomId)) buffers.set(roomId, []);
+	}
+	/** Remove a room from a bot. */
+	removeRoom(roomId, botName) {
+		const name = botName ?? this._botOrder[0];
+		if (!name) return;
+		const convs = this._botConversations.get(name);
+		if (convs) convs.delete(roomId);
+		const buffers = this._botBuffers.get(name);
+		if (buffers) buffers.delete(roomId);
+	}
+	/** Add a message to the ring buffer directly. Public for testing/conformance. */
+	_addToBuffer(roomId, msg) {
+		const botName = this._botOrder[0] ?? "default";
+		const convs = this._botConversations.get(botName);
+		if (convs && !convs.has(roomId)) convs.add(roomId);
+		let botBuffers = this._botBuffers.get(botName);
+		if (!botBuffers) {
+			botBuffers = /* @__PURE__ */ new Map();
+			this._botBuffers.set(botName, botBuffers);
+		}
+		let buffer = botBuffers.get(roomId);
+		if (!buffer) {
+			buffer = [];
+			botBuffers.set(roomId, buffer);
+		}
+		const senderName = msg.sender.match(/^@([^:]+):/)?.[1] ?? msg.sender;
+		buffer.push({
+			id: msg.event_id,
+			text: msg.body,
+			from: {
+				id: msg.sender,
+				name: senderName
+			},
+			timestamp: msg.origin_server_ts ? Math.floor(msg.origin_server_ts / 1e3) : Math.floor(Date.now() / 1e3),
+			conversationId: roomId,
+			platform: { event_id: msg.event_id }
+		});
+		while (buffer.length > this._bufferSize) buffer.shift();
+	}
+};
+__decorate([Actions("/")], AFSMatrix.prototype, "listRootActions", null);
+__decorate([Actions.Exec("/", "start")], AFSMatrix.prototype, "execStart", null);
+__decorate([Actions.Exec("/", "stop")], AFSMatrix.prototype, "execStop", null);
+__decorate([Actions.Exec("/", "process-event")], AFSMatrix.prototype, "execProcessEvent", null);
+
+//#endregion
+export { AFSMatrix };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/client.ts","../src/index.ts"],"sourcesContent":["/**\n * MatrixClient — pure Matrix Client-Server API wrapper.\n *\n * Zero external dependencies (uses native fetch).\n * No AFS or application-specific concepts.\n */\n\nconst DEFAULT_TIMEOUT = 30_000;\n\nexport interface MatrixClientOptions {\n  accessToken: string;\n  homeserver: string;\n  timeout?: number;\n}\n\n/** Matrix room message event (subset). */\nexport interface MatrixEvent {\n  event_id: string;\n  type: string;\n  sender: string;\n  content: {\n    msgtype?: string;\n    body?: string;\n    [key: string]: unknown;\n  };\n  origin_server_ts: number;\n  room_id?: string;\n}\n\n/** Matrix sync response (subset). */\nexport interface MatrixSyncResponse {\n  next_batch: string;\n  rooms?: {\n    join?: Record<\n      string,\n      {\n        timeline?: {\n          events?: MatrixEvent[];\n        };\n      }\n    >;\n  };\n}\n\n/** Matrix whoami response. */\nexport interface MatrixWhoamiResponse {\n  user_id: string;\n  device_id?: string;\n}\n\nlet _txnCounter = 0;\n\nexport class MatrixClient {\n  private readonly _accessToken: string;\n  private readonly _homeserver: string;\n  private readonly _timeout: number;\n\n  constructor(options: MatrixClientOptions) {\n    if (!options.accessToken) throw new Error(\"MatrixClient requires an accessToken\");\n    if (!options.homeserver) throw new Error(\"MatrixClient requires a homeserver\");\n    this._accessToken = options.accessToken;\n    this._homeserver = options.homeserver.replace(/\\/+$/, \"\");\n    this._timeout = options.timeout ?? DEFAULT_TIMEOUT;\n  }\n\n  // ─── API Methods ─────────────────────────────────────────\n\n  async sendMessage(roomId: string, text: string): Promise<{ event_id: string }> {\n    const txnId = `m${Date.now()}.${_txnCounter++}`;\n    return this._call(\n      \"PUT\",\n      `/_matrix/client/v3/rooms/${encodeURIComponent(roomId)}/send/m.room.message/${txnId}`,\n      { msgtype: \"m.text\", body: text },\n    );\n  }\n\n  async sendTyping(roomId: string, userId: string, timeout = 10000): Promise<void> {\n    await this._call(\n      \"PUT\",\n      `/_matrix/client/v3/rooms/${encodeURIComponent(roomId)}/typing/${encodeURIComponent(userId)}`,\n      { typing: true, timeout },\n    );\n  }\n\n  async sync(since?: string, timeout?: number): Promise<MatrixSyncResponse> {\n    const params = new URLSearchParams();\n    if (since) params.set(\"since\", since);\n    if (timeout !== undefined) params.set(\"timeout\", String(timeout));\n    return this._call(\"GET\", `/_matrix/client/v3/sync?${params.toString()}`);\n  }\n\n  async whoami(): Promise<MatrixWhoamiResponse> {\n    return this._call(\"GET\", \"/_matrix/client/v3/account/whoami\");\n  }\n\n  // ─── Internal ────────────────────────────────────────────\n\n  private async _call(method: string, path: string, body?: Record<string, unknown>): Promise<any> {\n    const headers: Record<string, string> = {\n      Authorization: `Bearer ${this._accessToken}`,\n    };\n    const init: RequestInit = {\n      method,\n      headers,\n      signal: AbortSignal.timeout(this._timeout),\n    };\n\n    if (body) {\n      headers[\"Content-Type\"] = \"application/json\";\n      init.body = JSON.stringify(body);\n    }\n\n    const response = await fetch(`${this._homeserver}${path}`, init);\n\n    if (!response.ok) {\n      const text = await response.text().catch(() => \"\");\n      const desc = text.replace(this._accessToken, \"***\");\n      throw new Error(`Matrix API error ${response.status}: ${desc}`);\n    }\n\n    return response.json();\n  }\n}\n","/**\n * AFSMatrix — AFS provider for Matrix (Element).\n *\n * Extends BaseMessageProvider (Plan 9 model).\n * Path structure (from base):\n *   /                                              → List bots\n *   /:botName/ctl                                  → Bot status\n *   /:botName/conversations/:roomId/messages        → List messages\n *   /:botName/conversations/:roomId/messages/:evId  → Read message\n *\n * Additional Matrix actions:\n *   /.actions/start          → Start sync loop\n *   /.actions/stop           → Stop sync loop\n *   /.actions/process-event  → Inject event externally\n *\n * Standard events (from base):\n *   messaging:message → Inbound text message\n *   messaging:command → Inbound /command\n */\n\nimport type { AFSExecResult, AFSListResult, ProviderTreeSchema } from \"@aigne/afs\";\nimport { Actions, type RouteContext } from \"@aigne/afs/provider\";\nimport type {\n  BotConfig,\n  BufferedMessage,\n  MessageCapabilities,\n  MessageSender,\n  SendOptions,\n} from \"@aigne/afs-messaging\";\nimport { BaseMessageProvider } from \"@aigne/afs-messaging\";\nimport { MatrixClient, type MatrixEvent } from \"./client.js\";\n\nexport type {\n  MatrixClient,\n  MatrixEvent,\n  MatrixSyncResponse,\n  MatrixWhoamiResponse,\n} from \"./client.js\";\n\nexport interface AFSMatrixOptions {\n  /** Multi-bot config */\n  bots?: Array<{\n    name: string;\n    token: string;\n    homeserver: string;\n    conversations?: string[];\n  }>;\n  /** Single-bot shorthand: access token */\n  accessToken?: string;\n  /** Single-bot shorthand: homeserver URL */\n  homeserver?: string;\n  /** Single-bot shorthand: room IDs to monitor */\n  rooms?: string[];\n  bufferSize?: number;\n}\n\ninterface SyncState {\n  syncing: boolean;\n  disposed: boolean;\n  abort: AbortController | null;\n  backoff: number;\n  nextBatch: string | null;\n}\n\nexport class AFSMatrix extends BaseMessageProvider {\n  static manifest() {\n    return {\n      name: \"matrix\",\n      description:\n        \"Matrix messaging — decentralized, federated chat protocol.\\n- Sync long-poll for real-time message reception\\n- Multi-bot support with per-bot room monitoring\\n- Path: /:bot/conversations/:roomId/messages/:eventId\",\n      uriTemplate: \"matrix://{homeserver}\",\n      category: \"messaging\",\n      schema: {\n        type: \"object\",\n        properties: {\n          homeserver: { type: \"string\", description: \"Matrix homeserver URL\" },\n          accessToken: { type: \"string\", description: \"Matrix access token\", sensitive: true },\n          rooms: { type: \"array\", items: { type: \"string\" }, description: \"Room IDs to monitor\" },\n        },\n        required: [\"homeserver\", \"accessToken\"],\n      },\n      tags: [\"matrix\", \"messaging\", \"chat\", \"decentralized\", \"federated\"],\n      capabilityTags: [\"read-write\", \"crud\", \"search\", \"auth:token\", \"remote\", \"http\", \"real-time\"],\n      security: {\n        riskLevel: \"external\",\n        resourceAccess: [\"internet\"],\n        notes: [\"Connects to Matrix homeserver — requires access token\"],\n      },\n      capabilities: {\n        network: { egress: true },\n      },\n    };\n  }\n\n  static treeSchema(): ProviderTreeSchema {\n    return {\n      operations: [\"list\", \"read\", \"exec\", \"stat\", \"explain\"],\n      tree: {\n        \"/\": {\n          kind: \"messaging:root\",\n          operations: [\"list\", \"exec\"],\n          actions: [\"add-bot\", \"remove-bot\", \"start\", \"stop\", \"process-event\"],\n        },\n        \"/{bot}\": { kind: \"messaging:bot\", operations: [\"list\", \"read\"] },\n        \"/{bot}/ctl\": { kind: \"messaging:status\", operations: [\"read\"] },\n        \"/{bot}/conversations\": { kind: \"messaging:conversations\", operations: [\"list\"] },\n        \"/{bot}/conversations/{convId}\": { kind: \"messaging:conversation\", operations: [\"list\"] },\n        \"/{bot}/conversations/{convId}/messages\": {\n          kind: \"messaging:messages\",\n          operations: [\"list\", \"exec\"],\n          actions: [\"send\"],\n        },\n        \"/{bot}/conversations/{convId}/messages/{msgId}\": {\n          kind: \"messaging:message\",\n          operations: [\"read\"],\n        },\n      },\n      auth: { type: \"token\", env: [\"MATRIX_ACCESS_TOKEN\"] },\n      bestFor: [\"decentralized chat\", \"federated messaging\", \"privacy-focused comms\"],\n      notFor: [\"file storage\", \"database queries\"],\n    };\n  }\n\n  readonly providerName = \"matrix\";\n  readonly eventPrefix = \"matrix\";\n\n  private readonly _syncStates = new Map<string, SyncState>();\n  private readonly _userIds = new Map<string, string>();\n\n  constructor(options: AFSMatrixOptions) {\n    let bots: BotConfig[];\n    if (options.bots) {\n      bots = options.bots.map((b) => ({\n        name: b.name,\n        accessToken: b.token,\n        homeserver: b.homeserver,\n        conversations: b.conversations,\n      }));\n      for (const bot of options.bots) {\n        if (!bot.token) throw new Error(`AFSMatrix bot \"${bot.name}\" requires a token`);\n        if (!bot.homeserver) throw new Error(`AFSMatrix bot \"${bot.name}\" requires a homeserver`);\n      }\n    } else {\n      if (!options.accessToken) throw new Error(\"AFSMatrix requires an accessToken\");\n      if (!options.homeserver) throw new Error(\"AFSMatrix requires a homeserver\");\n      bots = [\n        {\n          name: \"default\",\n          accessToken: options.accessToken,\n          homeserver: options.homeserver,\n          conversations: options.rooms ?? [],\n        },\n      ];\n    }\n\n    super({ bots, bufferSize: options.bufferSize });\n\n    for (const bot of bots) {\n      this._syncStates.set(bot.name, {\n        syncing: false,\n        disposed: false,\n        abort: null,\n        backoff: 1000,\n        nextBatch: null,\n      });\n    }\n  }\n\n  // ─── Abstract Implementation ─────────────────────────\n\n  getMessageCapabilities(): MessageCapabilities {\n    return {\n      formats: {\n        send: [\"text\", \"markdown\"],\n        receive: [\"text\"],\n      },\n      maxMessageLength: 65536,\n      features: {\n        edit: true,\n        delete: false,\n        reply: true,\n        thread: true,\n        reaction: true,\n        inlineKeyboard: false,\n      },\n      limits: {\n        messagesPerSecond: 10,\n      },\n    };\n  }\n\n  createBotClient(config: BotConfig): MatrixClient {\n    return new MatrixClient({\n      accessToken: config.accessToken as string,\n      homeserver: config.homeserver as string,\n    });\n  }\n\n  async sendMessage(\n    client: unknown,\n    convId: string,\n    text: string,\n    _opts?: SendOptions,\n  ): Promise<{ messageId: string }> {\n    const mc = client as MatrixClient;\n    const result = await mc.sendMessage(convId, text);\n    return { messageId: result.event_id };\n  }\n\n  async sendTypingIndicator(client: unknown, convId: string): Promise<void> {\n    const mc = client as MatrixClient;\n    // Resolve user ID (cached after first call)\n    const botName = [...this._botClients.entries()].find(([, c]) => c === client)?.[0] ?? \"\";\n    let userId = this._userIds.get(botName);\n    if (!userId) {\n      const whoami = await mc.whoami();\n      userId = whoami.user_id;\n      this._userIds.set(botName, userId);\n    }\n    await mc.sendTyping(convId, userId);\n  }\n\n  normalizeMessage(raw: Record<string, unknown>): BufferedMessage {\n    const evt = raw as unknown as MatrixEvent;\n    return {\n      id: String(evt.event_id ?? \"0\"),\n      text: String(evt.content?.body ?? \"\"),\n      from: this.normalizeSender({ sender: evt.sender } as unknown as Record<string, unknown>),\n      timestamp: evt.origin_server_ts\n        ? Math.floor(evt.origin_server_ts / 1000)\n        : Math.floor(Date.now() / 1000),\n      conversationId: String(evt.room_id ?? \"\"),\n      platform: { event_id: evt.event_id },\n    };\n  }\n\n  normalizeSender(raw: Record<string, unknown>): MessageSender {\n    const sender = String(raw.sender ?? raw.id ?? \"\");\n    // Extract localpart from @user:server format\n    const match = sender.match(/^@([^:]+):/);\n    const name = match?.[1] ?? sender;\n    return {\n      id: sender,\n      name,\n    };\n  }\n\n  // ─── Lifecycle ─────────────────────────────────────────\n\n  start(botName?: string): void {\n    const names = botName ? [botName] : [...this._syncStates.keys()];\n    for (const name of names) {\n      const state = this._syncStates.get(name);\n      if (!state || state.syncing || state.disposed) continue;\n      state.syncing = true;\n      this._syncLoop(name);\n    }\n  }\n\n  stop(botName?: string): void {\n    const names = botName ? [botName] : [...this._syncStates.keys()];\n    for (const name of names) {\n      const state = this._syncStates.get(name);\n      if (!state) continue;\n      state.syncing = false;\n      if (state.abort) {\n        state.abort.abort();\n        state.abort = null;\n      }\n    }\n  }\n\n  dispose(): void {\n    for (const [, state] of this._syncStates) {\n      state.syncing = false;\n      state.disposed = true;\n      if (state.abort) {\n        state.abort.abort();\n        state.abort = null;\n      }\n    }\n  }\n\n  // ─── Matrix-specific Actions ─────────────────────────\n\n  @Actions(\"/\")\n  async listRootActions(_ctx: RouteContext): Promise<AFSListResult> {\n    return {\n      data: [\n        this.buildEntry(\"/.actions/add-bot\", {\n          meta: { description: \"Add a bot instance at runtime\" },\n        }),\n        this.buildEntry(\"/.actions/remove-bot\", {\n          meta: { description: \"Remove a bot instance\" },\n        }),\n        this.buildEntry(\"/.actions/start\", {\n          meta: { description: \"Start sync loop for updates\" },\n        }),\n        this.buildEntry(\"/.actions/stop\", {\n          meta: { description: \"Stop sync loop\" },\n        }),\n        this.buildEntry(\"/.actions/process-event\", {\n          meta: { description: \"Inject a Matrix event externally\" },\n        }),\n      ],\n    };\n  }\n\n  @Actions.Exec(\"/\", \"start\")\n  async execStart(_ctx: RouteContext): Promise<AFSExecResult> {\n    this.start();\n    return { success: true, data: { ok: true, syncing: true } };\n  }\n\n  @Actions.Exec(\"/\", \"stop\")\n  async execStop(_ctx: RouteContext): Promise<AFSExecResult> {\n    this.stop();\n    return { success: true, data: { ok: true, syncing: false } };\n  }\n\n  @Actions.Exec(\"/\", \"process-event\")\n  async execProcessEvent(\n    _ctx: RouteContext,\n    args: Record<string, unknown>,\n  ): Promise<AFSExecResult> {\n    this._processEvent(args);\n    return { success: true, data: { ok: true } };\n  }\n\n  // ─── Sync Loop ──────────────────────────────────────\n\n  private async _syncLoop(botName: string): Promise<void> {\n    const state = this._syncStates.get(botName);\n    const client = this._getClient(botName) as MatrixClient | undefined;\n    if (!state || !client) return;\n\n    while (state.syncing && !state.disposed) {\n      try {\n        state.abort = new AbortController();\n        const response = await client.sync(state.nextBatch ?? undefined, 30000);\n\n        state.nextBatch = response.next_batch;\n\n        // Process joined room events\n        if (response.rooms?.join) {\n          for (const [roomId, room] of Object.entries(response.rooms.join)) {\n            const events = room.timeline?.events ?? [];\n            for (const evt of events) {\n              if (evt.type === \"m.room.message\" && evt.content?.msgtype === \"m.text\") {\n                const text = String(evt.content.body ?? \"\").trim();\n                if (!text) continue;\n\n                this.emitMessageReceived(botName, {\n                  id: String(evt.event_id),\n                  text,\n                  from: this.normalizeSender({ sender: evt.sender } as unknown as Record<\n                    string,\n                    unknown\n                  >),\n                  timestamp: evt.origin_server_ts\n                    ? Math.floor(evt.origin_server_ts / 1000)\n                    : Math.floor(Date.now() / 1000),\n                  conversationId: roomId,\n                  platform: { event_id: evt.event_id },\n                });\n              }\n            }\n          }\n        }\n\n        state.backoff = 1000;\n      } catch (err) {\n        if (state.disposed) break;\n        // Fail fast on auth errors — retrying won't help and may cause lockout\n        const msg = err instanceof Error ? err.message : \"\";\n        if (/API error (401|403)/.test(msg)) {\n          state.syncing = false;\n          break;\n        }\n        await new Promise((r) => setTimeout(r, state.backoff));\n        state.backoff = Math.min(state.backoff * 2, 60_000);\n      }\n    }\n  }\n\n  // ─── External Event Injection ──────────────────────────\n\n  /** Process an externally-provided Matrix event. Public for testing. */\n  _processEvent(payload: Record<string, unknown>): void {\n    const botName = (payload.botName as string) ?? this._botOrder[0] ?? \"default\";\n    const evt = payload as any;\n\n    // Support both wrapped and direct event formats\n    const eventId = String(evt.event_id ?? evt.id ?? Date.now());\n    const sender = String(evt.sender ?? \"\");\n    const body = String(evt.content?.body ?? evt.body ?? \"\").trim();\n    const roomId = String(evt.room_id ?? evt.roomId ?? \"\");\n    const originServerTs = evt.origin_server_ts ?? evt.timestamp;\n\n    if (!body) return;\n\n    this.emitMessageReceived(botName, {\n      id: eventId,\n      text: body,\n      from: this.normalizeSender({ sender } as unknown as Record<string, unknown>),\n      timestamp: originServerTs\n        ? Math.floor(Number(originServerTs) / 1000)\n        : Math.floor(Date.now() / 1000),\n      conversationId: roomId,\n      platform: { event_id: eventId },\n    });\n  }\n\n  // ─── Convenience Methods (test helpers) ─────────────\n\n  /** Add a room to a bot. Defaults to first bot. */\n  addRoom(roomId: string, botName?: string): void {\n    const name = botName ?? this._botOrder[0];\n    if (!name) return;\n    const convs = this._botConversations.get(name);\n    if (!convs || convs.has(roomId)) return;\n    convs.add(roomId);\n    const buffers = this._botBuffers.get(name);\n    if (buffers && !buffers.has(roomId)) {\n      buffers.set(roomId, []);\n    }\n  }\n\n  /** Remove a room from a bot. */\n  removeRoom(roomId: string, botName?: string): void {\n    const name = botName ?? this._botOrder[0];\n    if (!name) return;\n    const convs = this._botConversations.get(name);\n    if (convs) convs.delete(roomId);\n    const buffers = this._botBuffers.get(name);\n    if (buffers) buffers.delete(roomId);\n  }\n\n  /** Add a message to the ring buffer directly. Public for testing/conformance. */\n  _addToBuffer(\n    roomId: string,\n    msg: {\n      event_id: string;\n      sender: string;\n      body: string;\n      origin_server_ts?: number;\n    },\n  ): void {\n    const botName = this._botOrder[0] ?? \"default\";\n\n    // Auto-add conversation\n    const convs = this._botConversations.get(botName);\n    if (convs && !convs.has(roomId)) {\n      convs.add(roomId);\n    }\n\n    // Add to buffer directly (no event emission — for test setup)\n    let botBuffers = this._botBuffers.get(botName);\n    if (!botBuffers) {\n      botBuffers = new Map();\n      this._botBuffers.set(botName, botBuffers);\n    }\n    let buffer = botBuffers.get(roomId);\n    if (!buffer) {\n      buffer = [];\n      botBuffers.set(roomId, buffer);\n    }\n\n    // Extract localpart from @user:server\n    const match = msg.sender.match(/^@([^:]+):/);\n    const senderName = match?.[1] ?? msg.sender;\n\n    buffer.push({\n      id: msg.event_id,\n      text: msg.body,\n      from: { id: msg.sender, name: senderName },\n      timestamp: msg.origin_server_ts\n        ? Math.floor(msg.origin_server_ts / 1000)\n        : Math.floor(Date.now() / 1000),\n      conversationId: roomId,\n      platform: { event_id: msg.event_id },\n    });\n    while (buffer.length > this._bufferSize) {\n      buffer.shift();\n    }\n  }\n}\n"],"mappings":"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"}