@effect-uai/discord 0.14.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Betalyra Sociedade Unipessoal Lda.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+# @effect-uai/discord
+
+Discord provider for [`@effect-uai/core`](https://www.npmjs.com/package/@effect-uai/core).
+
+Implements the `Messenger` contract over the gateway and the v10 REST API, so
+your agent runs as a Discord bot: DMs, channel mentions, threads and button
+presses in, streamed markdown replies, media and reactions out. One gateway
+websocket, so no public URL, and no discord.js.
+
+## Install
+
+```sh
+pnpm add @effect-uai/discord @effect-uai/core effect
+```
+
+ESM-only. Requires `effect@4.x` and `@effect-uai/core` as peers.
+
+## Usage
+
+```ts
+import { Effect, Redacted } from "effect"
+import { NodeHttpClient } from "@effect/platform-node"
+import { layer as discordLayer } from "@effect-uai/discord/Discord"
+
+const provider = discordLayer({ token: Redacted.make(process.env.DISCORD_BOT_TOKEN!) })
+
+await Effect.runPromise(
+  program.pipe(Effect.scoped, Effect.provide(provider), Effect.provide(NodeHttpClient.layerUndici)),
+)
+```
+
+The layer registers both the provider-typed `Discord` tag and the generic
+`Messenger` tag. Building it waits for Discord's `READY`, so a bad token
+fails at wiring time; the session stays live until the scope closes.
+
+## Intents
+
+The default intents cover DMs and mentions. Reading every channel message
+needs the privileged Message Content intent:
+`intents: Discord.defaultIntents | Discord.Intents.MessageContent`.
+
+## Docs
+
+<https://effect-uai.betalyra.com/messenger/providers/discord/>
+
+## License
+
+MIT

package/dist/Discord.d.mts

@@ -0,0 +1,55 @@
+import { t as BotIdentity } from "./events-Du1u-kVV.mjs";
+import { r as Config$1 } from "./rest-CZSW-VJK.mjs";
+import { s as classifyClose, t as CloseAction } from "./gateway-C_Ae1HYB.mjs";
+import { Context, Effect, Layer, Scope } from "effect";
+import { HttpClient } from "effect/unstable/http";
+import { Messenger, MessengerLimits, MessengerService } from "@effect-uai/core/Messenger";
+import { StreamViaEditsOptions } from "@effect-uai/core/MessengerAdapter";
+import * as MessengerError from "@effect-uai/core/MessengerError";
+declare namespace Discord_d_exports {
+  export { BotIdentity, CloseAction, Config, Discord, DiscordService, Intents, classifyClose, defaultIntents, layer, limits, make };
+}
+/** Gateway intent bits. `MessageContent` is the one Discord gates behind review. */
+declare const Intents: {
+  readonly Guilds: number;
+  readonly GuildMessages: number;
+  readonly GuildMessageReactions: number;
+  readonly DirectMessages: number;
+  readonly DirectMessageReactions: number;
+  readonly MessageContent: number;
+};
+/**
+ * What a mention-or-DM bot needs. Even without the privileged
+ * `MessageContent` intent, `content` arrives for DMs and for messages that
+ * mention the bot, which is exactly the set `addressed` covers.
+ */
+declare const defaultIntents: number;
+type Config = Config$1 & {
+  /** Gateway intents mask. Defaults to {@link defaultIntents}. */
+  readonly intents?: number;
+  /** Tuning for `stream`, which is post-then-edit on Discord. */
+  readonly stream?: StreamViaEditsOptions;
+};
+type DiscordService = MessengerService & {
+  /** From `READY` at layer build: the identity behind `addressed`. */
+  readonly bot: BotIdentity;
+};
+declare const Discord_base: Context.ServiceClass<Discord, "@betalyra/effect-uai/providers/discord/Discord", DiscordService>;
+/**
+ * Provider-typed tag. Yield this for the bot identity; yield the generic
+ * `Messenger` tag for provider-portable code. Both are registered by {@link layer}.
+ */
+declare class Discord extends Discord_base {}
+declare const limits: MessengerLimits;
+declare const make: (cfg: Config) => Effect.Effect<DiscordService, MessengerError.MessengerConnectFailed, HttpClient.HttpClient | Scope.Scope>;
+/**
+ * One gateway session, registered under both the `Discord` and `Messenger`
+ * tags. Building the layer identifies and waits for `READY`, so a bad token
+ * or an intent the portal has not granted fails here; the connection lives
+ * until the scope closes and `events` ends with it. Run one instance per
+ * bot token.
+ */
+declare const layer: (cfg: Config) => Layer.Layer<Discord | Messenger, MessengerError.MessengerConnectFailed, HttpClient.HttpClient>;
+//#endregion
+export { type BotIdentity, type CloseAction, Config, Discord, DiscordService, Intents, classifyClose, defaultIntents, layer, limits, make, Discord_d_exports as t };
+//# sourceMappingURL=Discord.d.mts.map

package/dist/Discord.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Discord.d.mts","names":[],"sources":["../src/Discord.ts"],"mappings":";;;;;;;;;;;;cA8Ca;WACX;WACA;WACA;WACA;WACA;WACA;;;;;;;cAQW;KAOD,SAAS;;WAEV;;WAEA,SAAS;;KAGR,iBAAiB;;WAElB,KAAK;;;;;;;cAOH,gBAAgB;cAIhB,QAAQ;cAwFR,OAAI,KACV,WACJ,OAAO,OACR,gBACA,eAAe,wBACf,WAAW,aAAa,MAAM;;;;;;;;cA6MnB,QAAK,KACX,WACJ,MAAM,MAAM,UAAU,WAAW,eAAe,wBAAwB,WAAW"}

package/dist/Discord.mjs

@@ -0,0 +1,196 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { toEvents } from "./internal/events.mjs";
+import { call, decoded, provider, upload } from "./internal/rest.mjs";
+import { GatewayInfo, classifyClose, connect } from "./internal/gateway.mjs";
+import { Array, Context, Effect, Encoding, Layer, Match, Option, Queue, Schedule, Schema, Stream } from "effect";
+import { HttpClient } from "effect/unstable/http";
+import { CurrentConversation, MessageId, Messenger } from "@effect-uai/core/Messenger";
+import { splitForLimit, streamViaEdits } from "@effect-uai/core/MessengerAdapter";
+import * as MessengerError from "@effect-uai/core/MessengerError";
+//#region src/Discord.ts
+var Discord_exports = /* @__PURE__ */ __exportAll({
+	Discord: () => Discord,
+	Intents: () => Intents,
+	classifyClose: () => classifyClose,
+	defaultIntents: () => defaultIntents,
+	layer: () => layer,
+	limits: () => limits,
+	make: () => make
+});
+/** Gateway intent bits. `MessageContent` is the one Discord gates behind review. */
+const Intents = {
+	Guilds: 1,
+	GuildMessages: 512,
+	GuildMessageReactions: 1024,
+	DirectMessages: 4096,
+	DirectMessageReactions: 8192,
+	MessageContent: 32768
+};
+/**
+* What a mention-or-DM bot needs. Even without the privileged
+* `MessageContent` intent, `content` arrives for DMs and for messages that
+* mention the bot, which is exactly the set `addressed` covers.
+*/
+const defaultIntents = Intents.Guilds | Intents.GuildMessages | Intents.GuildMessageReactions | Intents.DirectMessages | Intents.DirectMessageReactions;
+/**
+* Provider-typed tag. Yield this for the bot identity; yield the generic
+* `Messenger` tag for provider-portable code. Both are registered by {@link layer}.
+*/
+var Discord = class extends Context.Service()("@betalyra/effect-uai/providers/discord/Discord") {};
+const limits = {
+	maxText: 2e3,
+	maxCaption: 2e3
+};
+const defaultStream = { every: "1200 millis" };
+const DEFERRED_UPDATE = 6;
+const Me = Schema.Struct({
+	id: Schema.String,
+	username: Schema.String
+});
+const Sent = Schema.Struct({ id: Schema.String });
+const RawCall = Schema.Struct({
+	method: Schema.Literals([
+		"GET",
+		"POST",
+		"PATCH",
+		"PUT",
+		"DELETE"
+	]),
+	path: Schema.String,
+	body: Schema.optional(Schema.Unknown)
+});
+const isApiFailure = (e) => e._tag === "DiscordApiFailure";
+const describes = (needle) => (e) => isApiFailure(e) && e.message.includes(needle);
+const reasonOf = (e) => isApiFailure(e) ? e.message : "rate limited";
+/** An API rejection becomes the verb's `MessengerRequestFailed`; typed errors pass through. */
+const requestFailed = (operation) => (e) => Match.value(e).pipe(Match.tag("DiscordApiFailure", (failure) => new MessengerError.MessengerRequestFailed({
+	provider,
+	operation,
+	reason: failure.message,
+	raw: failure.raw
+})), Match.orElse((typed) => typed));
+const unsupported = (capability, reason) => new MessengerError.MessengerUnsupported({
+	provider,
+	capability,
+	reason
+});
+const noMentions = { allowed_mentions: { parse: [] } };
+const replyFields = (msg) => msg.replyTo === void 0 ? {} : { message_reference: {
+	message_id: msg.replyTo,
+	fail_if_not_exists: false
+} };
+const messages = (at) => `/channels/${at.channel}/messages`;
+const captionField = (caption) => caption === void 0 ? {} : { content: caption };
+const defaultFilename = (media) => `file.${media.mimeType?.split("/")[1] ?? "bin"}`;
+const invalidMedia = (raw) => new MessengerError.MessengerRequestFailed({
+	provider,
+	operation: "post",
+	reason: "invalid base64 media",
+	raw
+});
+const make = (cfg) => Effect.gen(function* () {
+	const client = yield* HttpClient.HttpClient;
+	const withClient = Effect.provideService(HttpClient.HttpClient, client);
+	const call$1 = (method, path, body) => withClient(call(cfg)(method, path, body));
+	const upload$1 = (path, payload, file) => withClient(upload(cfg)(path, payload, file));
+	const connectFailed = (e) => new MessengerError.MessengerConnectFailed({
+		provider,
+		reason: reasonOf(e),
+		raw: isApiFailure(e) ? e.raw : e
+	});
+	yield* call$1("GET", "/users/@me").pipe(decoded("GET /users/@me", Me), Effect.mapError(connectFailed));
+	const { url } = yield* call$1("GET", "/gateway/bot").pipe(decoded("GET /gateway/bot", GatewayInfo), Effect.mapError(connectFailed));
+	const session = yield* connect({
+		token: cfg.token,
+		intents: cfg.intents ?? defaultIntents,
+		url
+	});
+	const toEvents$1 = toEvents(session.bot);
+	const inbox = yield* Queue.unbounded();
+	const acknowledge = (dispatch) => Match.value(dispatch).pipe(Match.when({ t: "INTERACTION_CREATE" }, ({ d }) => d.type === 3 ? call$1("POST", `/interactions/${d.id}/${d.token}/callback`, { type: DEFERRED_UPDATE }).pipe(Effect.ignore) : Effect.void), Match.orElse(() => Effect.void));
+	yield* Stream.fromQueue(session.dispatches).pipe(Stream.runForEach(({ dispatch, raw }) => acknowledge(dispatch).pipe(Effect.andThen(Queue.offerAll(inbox, toEvents$1(dispatch, raw))))), Effect.catch((closed) => Queue.fail(inbox, closed)), Effect.ensuring(Queue.end(inbox)), Effect.forkScoped);
+	const sendRaw = (payload) => Effect.gen(function* () {
+		const { method, path, body } = yield* Schema.decodeUnknownEffect(RawCall)(payload).pipe(Effect.mapError(() => new MessengerError.MessengerRequestFailed({
+			provider,
+			operation: "post",
+			reason: "raw payload must be { method, path, body? }",
+			raw: payload
+		})));
+		return yield* call$1(method, path, body);
+	});
+	const sendUrl = (at, fields, body, url) => call$1("POST", messages(at), {
+		...fields,
+		content: Array.getSomes([Option.fromNullishOr(body.caption), Option.some(url)]).join("\n")
+	});
+	const sendMedia = (at, msg, body) => {
+		const fields = {
+			...noMentions,
+			...replyFields(msg)
+		};
+		const send = (bytes, mimeType) => upload$1(messages(at), {
+			...fields,
+			...captionField(body.caption)
+		}, {
+			bytes,
+			filename: body.filename ?? defaultFilename(body.media),
+			mimeType
+		});
+		return Match.value(body.media).pipe(Match.tag("url", ({ url }) => sendUrl(at, fields, body, url)), Match.tag("bytes", ({ bytes, mimeType }) => send(bytes, mimeType)), Match.tag("base64", ({ base64, mimeType }) => Effect.fromResult(Encoding.decodeBase64(base64)).pipe(Effect.mapError(invalidMedia), Effect.flatMap((bytes) => send(bytes, mimeType)))), Match.exhaustive);
+	};
+	const sendChunks = (at, msg, text) => Effect.gen(function* () {
+		const [first, ...rest] = splitForLimit(text, limits.maxText);
+		const send = (chunk, extra) => call$1("POST", messages(at), {
+			...noMentions,
+			...extra,
+			content: chunk
+		}).pipe(decoded("POST message", Sent));
+		const head = yield* send(first, replyFields(msg));
+		const tail = yield* Effect.forEach(rest, (chunk) => send(chunk, {}));
+		return Option.getOrElse(Array.last(tail), () => head);
+	});
+	const post = (msg) => Effect.gen(function* () {
+		const at = yield* CurrentConversation;
+		const sent = yield* Match.value(msg.body).pipe(Match.tag("Text", ({ text }) => sendChunks(at, msg, text)), Match.tag("Media", (body) => sendMedia(at, msg, body).pipe(decoded("POST media", Sent))), Match.tag("Raw", ({ payload }) => sendRaw(payload).pipe(decoded("raw", Sent))), Match.exhaustive);
+		return MessageId(sent.id);
+	}).pipe(Effect.mapError(requestFailed("post")));
+	const edit = (ref, next) => Match.value(next.body).pipe(Match.tag("Text", ({ text }) => call$1("PATCH", `${messages(ref.conversation)}/${ref.id}`, {
+		...noMentions,
+		content: text
+	}).pipe(Effect.asVoid, Effect.mapError(requestFailed("edit")))), Match.tag("Raw", ({ payload }) => sendRaw(payload).pipe(Effect.asVoid, Effect.mapError(requestFailed("edit")))), Match.tag("Media", () => Effect.fail(unsupported("media edits", "send a new message instead"))), Match.exhaustive);
+	const react = (ref, emoji) => call$1("PUT", `${messages(ref.conversation)}/${ref.id}/reactions/${encodeURIComponent(emoji)}/@me`).pipe(Effect.asVoid, Effect.catchIf(describes("Unknown Emoji"), () => Effect.fail(unsupported("reaction", `${emoji} is not an emoji Discord knows`))), Effect.mapError(requestFailed("react")));
+	const typing = Effect.gen(function* () {
+		const at = yield* CurrentConversation;
+		const once = call$1("POST", `/channels/${at.channel}/typing`);
+		yield* once.pipe(Effect.mapError(requestFailed("typing")));
+		yield* once.pipe(Effect.ignore, Effect.schedule(Schedule.spaced("8 seconds")), Effect.forkScoped);
+	});
+	return {
+		bot: session.bot,
+		events: Stream.fromQueue(inbox),
+		post,
+		edit,
+		react,
+		typing,
+		stream: streamViaEdits({
+			post,
+			edit,
+			limits
+		}, {
+			...defaultStream,
+			...cfg.stream
+		}),
+		limits
+	};
+});
+/**
+* One gateway session, registered under both the `Discord` and `Messenger`
+* tags. Building the layer identifies and waits for `READY`, so a bad token
+* or an intent the portal has not granted fails here; the connection lives
+* until the scope closes and `events` ends with it. Run one instance per
+* bot token.
+*/
+const layer = (cfg) => Layer.effectContext(Effect.map(make(cfg), (service) => Context.make(Discord, service).pipe(Context.add(Messenger, service))));
+//#endregion
+export { Discord, Intents, classifyClose, defaultIntents, layer, limits, make, Discord_exports as t };
+
+//# sourceMappingURL=Discord.mjs.map

package/dist/Discord.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Discord.mjs","names":["Rest.provider","call","Rest.call","upload","Rest.upload","Rest.decoded","Gateway.GatewayInfo","Gateway.connect","toEvents","Events.toEvents","Arr"],"sources":["../src/Discord.ts"],"sourcesContent":["import {\n  Array as Arr,\n  type Cause,\n  Context,\n  Effect,\n  Encoding,\n  Layer,\n  Match,\n  Option,\n  Queue,\n  Schedule,\n  Schema,\n  type Scope,\n  Stream,\n} from \"effect\"\nimport { HttpClient } from \"effect/unstable/http\"\nimport type { MediaSource } from \"@effect-uai/core/Media\"\nimport {\n  CurrentConversation,\n  type ConversationRef,\n  type InboundEvent,\n  MessageId,\n  Messenger,\n  type MessengerLimits,\n  type MessengerService,\n  type Outbound,\n  type OutboundBody,\n} from \"@effect-uai/core/Messenger\"\nimport {\n  type StreamViaEditsOptions,\n  splitForLimit,\n  streamViaEdits,\n} from \"@effect-uai/core/MessengerAdapter\"\nimport * as MessengerError from \"@effect-uai/core/MessengerError\"\nimport * as Events from \"./internal/events.js\"\nimport * as Gateway from \"./internal/gateway.js\"\nimport * as Rest from \"./internal/rest.js\"\n\nexport type { BotIdentity } from \"./internal/events.js\"\nexport { classifyClose, type CloseAction } from \"./internal/gateway.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/** Gateway intent bits. `MessageContent` is the one Discord gates behind review. */\nexport const Intents = {\n  Guilds: 1 << 0,\n  GuildMessages: 1 << 9,\n  GuildMessageReactions: 1 << 10,\n  DirectMessages: 1 << 12,\n  DirectMessageReactions: 1 << 13,\n  MessageContent: 1 << 15,\n} as const\n\n/**\n * What a mention-or-DM bot needs. Even without the privileged\n * `MessageContent` intent, `content` arrives for DMs and for messages that\n * mention the bot, which is exactly the set `addressed` covers.\n */\nexport const defaultIntents: number =\n  Intents.Guilds |\n  Intents.GuildMessages |\n  Intents.GuildMessageReactions |\n  Intents.DirectMessages |\n  Intents.DirectMessageReactions\n\nexport type Config = Rest.Config & {\n  /** Gateway intents mask. Defaults to {@link defaultIntents}. */\n  readonly intents?: number\n  /** Tuning for `stream`, which is post-then-edit on Discord. */\n  readonly stream?: StreamViaEditsOptions\n}\n\nexport type DiscordService = MessengerService & {\n  /** From `READY` at layer build: the identity behind `addressed`. */\n  readonly bot: Events.BotIdentity\n}\n\n/**\n * Provider-typed tag. Yield this for the bot identity; yield the generic\n * `Messenger` tag for provider-portable code. Both are registered by {@link layer}.\n */\nexport class Discord extends Context.Service<Discord, DiscordService>()(\n  \"@betalyra/effect-uai/providers/discord/Discord\",\n) {}\n\nexport const limits: MessengerLimits = { maxText: 2000, maxCaption: 2000 }\n\n// Under the observed five-edits-per-five-seconds-per-channel bucket.\nconst defaultStream: StreamViaEditsOptions = { every: \"1200 millis\" }\n\n// A deferred update: the interaction is answered, nothing changes on screen.\nconst DEFERRED_UPDATE = 6\n\n// ---------------------------------------------------------------------------\n// Wire results\n// ---------------------------------------------------------------------------\n\nconst Me = Schema.Struct({ id: Schema.String, username: Schema.String })\nconst Sent = Schema.Struct({ id: Schema.String })\nconst RawCall = Schema.Struct({\n  method: Schema.Literals([\"GET\", \"POST\", \"PATCH\", \"PUT\", \"DELETE\"]),\n  path: Schema.String,\n  body: Schema.optional(Schema.Unknown),\n})\n\n// ---------------------------------------------------------------------------\n// Errors\n// ---------------------------------------------------------------------------\n\nconst isApiFailure = (e: Rest.ApiError): e is Rest.ApiFailure => e._tag === \"DiscordApiFailure\"\n\nconst describes = (needle: string) => (e: Rest.ApiError) =>\n  isApiFailure(e) && e.message.includes(needle)\n\nconst reasonOf = (e: Rest.ApiError): string => (isApiFailure(e) ? e.message : \"rate limited\")\n\n/** An API rejection becomes the verb's `MessengerRequestFailed`; typed errors pass through. */\nconst requestFailed =\n  (operation: MessengerError.MessengerOperation) =>\n  (e: Rest.ApiError | MessengerError.MessengerError): MessengerError.MessengerError =>\n    Match.value(e).pipe(\n      Match.tag(\n        \"DiscordApiFailure\",\n        (failure) =>\n          new MessengerError.MessengerRequestFailed({\n            provider: Rest.provider,\n            operation,\n            reason: failure.message,\n            raw: failure.raw,\n          }),\n      ),\n      Match.orElse((typed) => typed),\n    )\n\nconst unsupported = (capability: string, reason: string) =>\n  new MessengerError.MessengerUnsupported({ provider: Rest.provider, capability, reason })\n\n// ---------------------------------------------------------------------------\n// Outbound params\n// ---------------------------------------------------------------------------\n\ntype Fields = Rest.Fields\n\ntype MediaFields = Extract<OutboundBody, { _tag: \"Media\" }>\n\n// Model output must never be able to ping anyone, so nothing is ever parsed.\nconst noMentions: Fields = { allowed_mentions: { parse: [] } }\n\nconst replyFields = (msg: Outbound): Fields =>\n  msg.replyTo === undefined\n    ? {}\n    : { message_reference: { message_id: msg.replyTo, fail_if_not_exists: false } }\n\nconst messages = (at: ConversationRef): string => `/channels/${at.channel}/messages`\n\nconst captionField = (caption: string | undefined): Fields =>\n  caption === undefined ? {} : { content: caption }\n\nconst defaultFilename = (media: MediaSource): string =>\n  `file.${media.mimeType?.split(\"/\")[1] ?? \"bin\"}`\n\nconst invalidMedia = (raw: unknown) =>\n  new MessengerError.MessengerRequestFailed({\n    provider: Rest.provider,\n    operation: \"post\",\n    reason: \"invalid base64 media\",\n    raw,\n  })\n\n// ---------------------------------------------------------------------------\n// Service\n// ---------------------------------------------------------------------------\n\nexport const make = (\n  cfg: Config,\n): Effect.Effect<\n  DiscordService,\n  MessengerError.MessengerConnectFailed,\n  HttpClient.HttpClient | Scope.Scope\n> =>\n  Effect.gen(function* () {\n    // Captured once so the verbs need no `HttpClient` of their own.\n    const client = yield* HttpClient.HttpClient\n    const withClient = Effect.provideService(HttpClient.HttpClient, client)\n    const call = (method: Rest.Method, path: string, body?: unknown) =>\n      withClient(Rest.call(cfg)(method, path, body))\n    const upload = (path: string, payload: Fields, file: Rest.Upload) =>\n      withClient(Rest.upload(cfg)(path, payload, file))\n\n    const connectFailed = (e: Rest.ApiError) =>\n      new MessengerError.MessengerConnectFailed({\n        provider: Rest.provider,\n        reason: reasonOf(e),\n        raw: isApiFailure(e) ? e.raw : e,\n      })\n\n    // A bad token fails here rather than as a gateway close a moment later.\n    yield* call(\"GET\", \"/users/@me\").pipe(\n      Rest.decoded(\"GET /users/@me\", Me),\n      Effect.mapError(connectFailed),\n    )\n    const { url } = yield* call(\"GET\", \"/gateway/bot\").pipe(\n      Rest.decoded(\"GET /gateway/bot\", Gateway.GatewayInfo),\n      Effect.mapError(connectFailed),\n    )\n\n    // -- inbound -----------------------------------------------------------\n\n    const session = yield* Gateway.connect({\n      token: cfg.token,\n      intents: cfg.intents ?? defaultIntents,\n      url,\n    })\n    const toEvents = Events.toEvents(session.bot)\n    const inbox = yield* Queue.unbounded<InboundEvent, MessengerError.MessengerError | Cause.Done>()\n\n    // Discord drops a component interaction that goes unanswered for three\n    // seconds, so it is acknowledged in the reader fiber rather than by the\n    // recipe, the twin of Telegram's `answerCallbackQuery`.\n    const acknowledge = (dispatch: Events.Dispatch) =>\n      Match.value(dispatch).pipe(\n        Match.when({ t: \"INTERACTION_CREATE\" }, ({ d }) =>\n          d.type === Events.MESSAGE_COMPONENT\n            ? call(\"POST\", `/interactions/${d.id}/${d.token}/callback`, {\n                type: DEFERRED_UPDATE,\n              }).pipe(Effect.ignore)\n            : Effect.void,\n        ),\n        Match.orElse(() => Effect.void),\n      )\n\n    yield* Stream.fromQueue(session.dispatches).pipe(\n      Stream.runForEach(({ dispatch, raw }) =>\n        acknowledge(dispatch).pipe(Effect.andThen(Queue.offerAll(inbox, toEvents(dispatch, raw)))),\n      ),\n      Effect.catch((closed) => Queue.fail(inbox, closed)),\n      Effect.ensuring(Queue.end(inbox)),\n      Effect.forkScoped,\n    )\n\n    // -- outbound ----------------------------------------------------------\n\n    const sendRaw = (payload: unknown) =>\n      Effect.gen(function* () {\n        const { method, path, body } = yield* Schema.decodeUnknownEffect(RawCall)(payload).pipe(\n          Effect.mapError(\n            () =>\n              new MessengerError.MessengerRequestFailed({\n                provider: Rest.provider,\n                operation: \"post\",\n                reason: \"raw payload must be { method, path, body? }\",\n                raw: payload,\n              }),\n          ),\n        )\n        return yield* call(method, path, body)\n      })\n\n    // Discord has no attachment-by-URL, so a URL goes as content and Discord\n    // unfurls it. Not as an embed: embeds need the Embed Links permission and\n    // are silently stripped without it, which Discord then rejects as an\n    // empty message.\n    const sendUrl = (at: ConversationRef, fields: Fields, body: MediaFields, url: string) =>\n      call(\"POST\", messages(at), {\n        ...fields,\n        content: Arr.getSomes([Option.fromNullishOr(body.caption), Option.some(url)]).join(\"\\n\"),\n      })\n\n    const sendMedia = (at: ConversationRef, msg: Outbound, body: MediaFields) => {\n      const fields = { ...noMentions, ...replyFields(msg) }\n      const send = (bytes: Uint8Array, mimeType: string) =>\n        upload(\n          messages(at),\n          { ...fields, ...captionField(body.caption) },\n          { bytes, filename: body.filename ?? defaultFilename(body.media), mimeType },\n        )\n      return Match.value(body.media).pipe(\n        Match.tag(\"url\", ({ url }) => sendUrl(at, fields, body, url)),\n        Match.tag(\"bytes\", ({ bytes, mimeType }) => send(bytes, mimeType)),\n        Match.tag(\"base64\", ({ base64, mimeType }) =>\n          Effect.fromResult(Encoding.decodeBase64(base64)).pipe(\n            Effect.mapError(invalidMedia),\n            Effect.flatMap((bytes) => send(bytes, mimeType)),\n          ),\n        ),\n        Match.exhaustive,\n      )\n    }\n\n    // The reply lands on the first chunk; the id is the last one's.\n    const sendChunks = (at: ConversationRef, msg: Outbound, text: string) =>\n      Effect.gen(function* () {\n        const [first, ...rest] = splitForLimit(text, limits.maxText)\n        const send = (chunk: string, extra: Fields) =>\n          call(\"POST\", messages(at), { ...noMentions, ...extra, content: chunk }).pipe(\n            Rest.decoded(\"POST message\", Sent),\n          )\n        const head = yield* send(first, replyFields(msg))\n        const tail = yield* Effect.forEach(rest, (chunk) => send(chunk, {}))\n        return Option.getOrElse(Arr.last(tail), () => head)\n      })\n\n    const post: MessengerService[\"post\"] = (msg) =>\n      Effect.gen(function* () {\n        const at = yield* CurrentConversation\n        const sent = yield* Match.value(msg.body).pipe(\n          Match.tag(\"Text\", ({ text }) => sendChunks(at, msg, text)),\n          Match.tag(\"Media\", (body) =>\n            sendMedia(at, msg, body).pipe(Rest.decoded(\"POST media\", Sent)),\n          ),\n          Match.tag(\"Raw\", ({ payload }) => sendRaw(payload).pipe(Rest.decoded(\"raw\", Sent))),\n          Match.exhaustive,\n        )\n        return MessageId(sent.id)\n      }).pipe(Effect.mapError(requestFailed(\"post\")))\n\n    const edit: MessengerService[\"edit\"] = (ref, next) =>\n      Match.value(next.body).pipe(\n        Match.tag(\"Text\", ({ text }) =>\n          call(\"PATCH\", `${messages(ref.conversation)}/${ref.id}`, {\n            ...noMentions,\n            content: text,\n          }).pipe(Effect.asVoid, Effect.mapError(requestFailed(\"edit\"))),\n        ),\n        Match.tag(\"Raw\", ({ payload }) =>\n          sendRaw(payload).pipe(Effect.asVoid, Effect.mapError(requestFailed(\"edit\"))),\n        ),\n        Match.tag(\"Media\", () =>\n          Effect.fail(unsupported(\"media edits\", \"send a new message instead\")),\n        ),\n        Match.exhaustive,\n      )\n\n    // Unicode emoji go URL-encoded and custom ones as `name:id`, which is the\n    // same spelling a `Reaction` event delivers.\n    const react: MessengerService[\"react\"] = (ref, emoji) =>\n      call(\n        \"PUT\",\n        `${messages(ref.conversation)}/${ref.id}/reactions/${encodeURIComponent(emoji)}/@me`,\n      ).pipe(\n        Effect.asVoid,\n        Effect.catchIf(describes(\"Unknown Emoji\"), () =>\n          Effect.fail(unsupported(\"reaction\", `${emoji} is not an emoji Discord knows`)),\n        ),\n        Effect.mapError(requestFailed(\"react\")),\n      )\n\n    // The indicator lasts ten seconds, so it is re-sent every eight until the\n    // scope closes. The first send is awaited so a bad channel fails here.\n    const typing: MessengerService[\"typing\"] = Effect.gen(function* () {\n      const at = yield* CurrentConversation\n      const once = call(\"POST\", `/channels/${at.channel}/typing`)\n      yield* once.pipe(Effect.mapError(requestFailed(\"typing\")))\n      yield* once.pipe(\n        Effect.ignore,\n        Effect.schedule(Schedule.spaced(\"8 seconds\")),\n        Effect.forkScoped,\n      )\n    })\n\n    return {\n      bot: session.bot,\n      events: Stream.fromQueue(inbox),\n      post,\n      edit,\n      react,\n      typing,\n      stream: streamViaEdits({ post, edit, limits }, { ...defaultStream, ...cfg.stream }),\n      limits,\n    }\n  })\n\n// ---------------------------------------------------------------------------\n// Layer\n// ---------------------------------------------------------------------------\n\n/**\n * One gateway session, registered under both the `Discord` and `Messenger`\n * tags. Building the layer identifies and waits for `READY`, so a bad token\n * or an intent the portal has not granted fails here; the connection lives\n * until the scope closes and `events` ends with it. Run one instance per\n * bot token.\n */\nexport const layer = (\n  cfg: Config,\n): Layer.Layer<Discord | Messenger, MessengerError.MessengerConnectFailed, HttpClient.HttpClient> =>\n  Layer.effectContext(\n    Effect.map(make(cfg), (service) =>\n      Context.make(Discord, service).pipe(Context.add(Messenger, service)),\n    ),\n  )\n"],"mappings":"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"}

package/dist/events-Du1u-kVV.d.mts

@@ -0,0 +1,172 @@
+import { Schema } from "effect";
+import { InboundEvent } from "@effect-uai/core/Messenger";
+//#region src/internal/events.d.ts
+declare const User: Schema.Struct<{
+  readonly id: Schema.String;
+  readonly username: Schema.optional<Schema.String>;
+  readonly bot: Schema.optional<Schema.Boolean>;
+}>;
+type User = typeof User.Type;
+/** Unicode reactions carry a `name` and a null `id`; custom ones carry both. */
+declare const Emoji: Schema.Struct<{
+  readonly id: Schema.optional<Schema.NullOr<Schema.String>>;
+  readonly name: Schema.optional<Schema.NullOr<Schema.String>>;
+}>;
+type Emoji = typeof Emoji.Type;
+declare const ReplyTarget: Schema.Struct<{
+  readonly id: Schema.String;
+  readonly author: Schema.optional<Schema.Struct<{
+    readonly id: Schema.String;
+    readonly username: Schema.optional<Schema.String>;
+    readonly bot: Schema.optional<Schema.Boolean>;
+  }>>;
+}>;
+type ReplyTarget = typeof ReplyTarget.Type;
+declare const MessageCreate: Schema.Struct<{
+  readonly id: Schema.String;
+  readonly channel_id: Schema.String;
+  readonly guild_id: Schema.optional<Schema.String>;
+  readonly author: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly username: Schema.optional<Schema.String>;
+    readonly bot: Schema.optional<Schema.Boolean>;
+  }>;
+  readonly content: Schema.optional<Schema.String>;
+  readonly mentions: Schema.optional<Schema.$Array<Schema.Struct<{
+    readonly id: Schema.String;
+    readonly username: Schema.optional<Schema.String>;
+    readonly bot: Schema.optional<Schema.Boolean>;
+  }>>>;
+  readonly referenced_message: Schema.optional<Schema.NullOr<Schema.Struct<{
+    readonly id: Schema.String;
+    readonly author: Schema.optional<Schema.Struct<{
+      readonly id: Schema.String;
+      readonly username: Schema.optional<Schema.String>;
+      readonly bot: Schema.optional<Schema.Boolean>;
+    }>>;
+  }>>>;
+}>;
+type MessageCreate = typeof MessageCreate.Type;
+declare const ReactionAdd: Schema.Struct<{
+  readonly user_id: Schema.String;
+  readonly channel_id: Schema.String;
+  readonly message_id: Schema.String;
+  readonly emoji: Schema.Struct<{
+    readonly id: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly name: Schema.optional<Schema.NullOr<Schema.String>>;
+  }>;
+}>;
+type ReactionAdd = typeof ReactionAdd.Type;
+declare const InteractionData: Schema.Struct<{
+  readonly custom_id: Schema.optional<Schema.String>;
+  readonly values: Schema.optional<Schema.$Array<Schema.String>>;
+}>;
+type InteractionData = typeof InteractionData.Type;
+declare const InteractionCreate: Schema.Struct<{
+  readonly id: Schema.String;
+  readonly token: Schema.String;
+  /** 1 ping, 2 slash command, 3 message component, 4 autocomplete, 5 modal. */
+  readonly type: Schema.Number;
+  readonly channel_id: Schema.optional<Schema.String>;
+  readonly user: Schema.optional<Schema.Struct<{
+    readonly id: Schema.String;
+    readonly username: Schema.optional<Schema.String>;
+    readonly bot: Schema.optional<Schema.Boolean>;
+  }>>;
+  readonly member: Schema.optional<Schema.Struct<{
+    readonly user: Schema.optional<Schema.Struct<{
+      readonly id: Schema.String;
+      readonly username: Schema.optional<Schema.String>;
+      readonly bot: Schema.optional<Schema.Boolean>;
+    }>>;
+  }>>;
+  readonly data: Schema.optional<Schema.Struct<{
+    readonly custom_id: Schema.optional<Schema.String>;
+    readonly values: Schema.optional<Schema.$Array<Schema.String>>;
+  }>>;
+}>;
+type InteractionCreate = typeof InteractionCreate.Type;
+/** The component interaction type; every other one is ignored in v1. */
+declare const MESSAGE_COMPONENT = 3;
+/**
+ * The dispatches this adapter reads, discriminated by the gateway's `t`.
+ * Anything else fails to decode and is dropped by the session.
+ */
+declare const Dispatch: Schema.Union<readonly [Schema.Struct<{
+  readonly t: Schema.Literal<"MESSAGE_CREATE">;
+  readonly d: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly channel_id: Schema.String;
+    readonly guild_id: Schema.optional<Schema.String>;
+    readonly author: Schema.Struct<{
+      readonly id: Schema.String;
+      readonly username: Schema.optional<Schema.String>;
+      readonly bot: Schema.optional<Schema.Boolean>;
+    }>;
+    readonly content: Schema.optional<Schema.String>;
+    readonly mentions: Schema.optional<Schema.$Array<Schema.Struct<{
+      readonly id: Schema.String;
+      readonly username: Schema.optional<Schema.String>;
+      readonly bot: Schema.optional<Schema.Boolean>;
+    }>>>;
+    readonly referenced_message: Schema.optional<Schema.NullOr<Schema.Struct<{
+      readonly id: Schema.String;
+      readonly author: Schema.optional<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly username: Schema.optional<Schema.String>;
+        readonly bot: Schema.optional<Schema.Boolean>;
+      }>>;
+    }>>>;
+  }>;
+}>, Schema.Struct<{
+  readonly t: Schema.Literal<"MESSAGE_REACTION_ADD">;
+  readonly d: Schema.Struct<{
+    readonly user_id: Schema.String;
+    readonly channel_id: Schema.String;
+    readonly message_id: Schema.String;
+    readonly emoji: Schema.Struct<{
+      readonly id: Schema.optional<Schema.NullOr<Schema.String>>;
+      readonly name: Schema.optional<Schema.NullOr<Schema.String>>;
+    }>;
+  }>;
+}>, Schema.Struct<{
+  readonly t: Schema.Literal<"INTERACTION_CREATE">;
+  readonly d: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly token: Schema.String;
+    /** 1 ping, 2 slash command, 3 message component, 4 autocomplete, 5 modal. */
+    readonly type: Schema.Number;
+    readonly channel_id: Schema.optional<Schema.String>;
+    readonly user: Schema.optional<Schema.Struct<{
+      readonly id: Schema.String;
+      readonly username: Schema.optional<Schema.String>;
+      readonly bot: Schema.optional<Schema.Boolean>;
+    }>>;
+    readonly member: Schema.optional<Schema.Struct<{
+      readonly user: Schema.optional<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly username: Schema.optional<Schema.String>;
+        readonly bot: Schema.optional<Schema.Boolean>;
+      }>>;
+    }>>;
+    readonly data: Schema.optional<Schema.Struct<{
+      readonly custom_id: Schema.optional<Schema.String>;
+      readonly values: Schema.optional<Schema.$Array<Schema.String>>;
+    }>>;
+  }>;
+}>]>;
+type Dispatch = typeof Dispatch.Type;
+type BotIdentity = {
+  readonly id: string;
+  readonly username: string;
+};
+/**
+ * Everything one dispatch says to the agent. `raw` is the payload as it came
+ * off the wire, since decoding keeps only the fields above. Discord has no
+ * text-command convention, so nothing here becomes a `Command`: slash
+ * commands are a follow-up and need an interaction response of their own.
+ */
+declare const toEvents: (bot: BotIdentity) => (dispatch: Dispatch, raw: unknown) => ReadonlyArray<InboundEvent>;
+//#endregion
+export { InteractionData as a, ReactionAdd as c, toEvents as d, InteractionCreate as i, ReplyTarget as l, Dispatch as n, MESSAGE_COMPONENT as o, Emoji as r, MessageCreate as s, BotIdentity as t, User as u };
+//# sourceMappingURL=events-Du1u-kVV.d.mts.map

package/dist/events-Du1u-kVV.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-Du1u-kVV.d.mts","names":[],"sources":["../src/internal/events.ts"],"mappings":";;;cAaa,MAAI,OAAA;;;;;KAKL,cAAc,KAAK;;cAGlB,OAAK,OAAA;;;;KAIN,eAAe,MAAM;cAEpB,aAAW,OAAA;;;;;;;;KAIZ,qBAAqB,YAAY;cAEhC,eAAa,OAAA;;;;;;;;;;;;;;;;;;;;;;;;KAUd,uBAAuB,cAAc;cAEpC,aAAW,OAAA;;;;;;;;;KAMZ,qBAAqB,YAAY;cAEhC,iBAAe,OAAA;;;;KAIhB,yBAAyB,gBAAgB;cAExC,mBAAiB,OAAA;;;;;;;;;;;;;;;;;;;;;;;KAUlB,2BAA2B,kBAAkB;;cAG5C;;;;;cAMA,UAAQ,OAAA,gBAAA,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAKT,kBAAkB,SAAS;KAE3B;WACD;WACA;;;;;;;;cAmGE,WAAQ,KACb,iBAAW,UACN,UAAQ,iBAAiB,cAAc"}

package/dist/gateway-C_Ae1HYB.d.mts

@@ -0,0 +1,57 @@
+import { n as Dispatch, t as BotIdentity } from "./events-Du1u-kVV.mjs";
+import { Cause, Effect, Queue, Redacted, Schema, Scope } from "effect";
+import * as MessengerError from "@effect-uai/core/MessengerError";
+//#region src/internal/gateway.d.ts
+declare const Ready: Schema.Struct<{
+  readonly user: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly username: Schema.String;
+  }>;
+  readonly session_id: Schema.String;
+  readonly resume_gateway_url: Schema.String;
+}>;
+type Ready = typeof Ready.Type;
+/** `GET /gateway/bot`, the only REST call the session needs. */
+declare const GatewayInfo: Schema.Struct<{
+  readonly url: Schema.String;
+}>;
+/** What the session does once a connection is gone. */
+type CloseAction = "resume" | "reidentify" | "fatal";
+/**
+ * Everything else, transport drops included, resumes: Discord only names the
+ * codes that must not be retried, so an unknown code is a reconnect.
+ */
+declare const classifyClose: (code: number) => CloseAction;
+/** Discord's own words for a fatal code, since its close frames carry no reason. */
+declare const closeReason: (code: number, reason?: string) => string;
+type Config = {
+  readonly token: Redacted.Redacted;
+  readonly intents: number;
+  /** From `GET /gateway/bot`. Resumes go to `resume_gateway_url` instead. */
+  readonly url: string;
+};
+/** A decoded dispatch beside the payload it came from, which `raw` carries. */
+type Incoming = {
+  readonly dispatch: Dispatch;
+  readonly raw: unknown;
+};
+type Session = {
+  readonly bot: BotIdentity;
+  /**
+   * Dispatches in arrival order, ended when the scope closes and failed with
+   * `MessengerTransportClosed` on a fatal gateway close.
+   */
+  readonly dispatches: Queue.Queue<Incoming, MessengerError.MessengerError | Cause.Done>;
+};
+/**
+ * One gateway session: connect, identify, heartbeat, resume, reconnect.
+ *
+ * Returns once `READY` has arrived, so a bad token or a disallowed intent is
+ * a `MessengerConnectFailed` at layer build rather than a stream that dies a
+ * moment later. From then on reconnects are silent and only a fatal close
+ * ends `dispatches`.
+ */
+declare const connect: (cfg: Config) => Effect.Effect<Session, MessengerError.MessengerConnectFailed, Scope.Scope>;
+//#endregion
+export { Ready as a, closeReason as c, Incoming as i, connect as l, Config as n, Session as o, GatewayInfo as r, classifyClose as s, CloseAction as t };
+//# sourceMappingURL=gateway-C_Ae1HYB.d.mts.map

package/dist/gateway-C_Ae1HYB.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-C_Ae1HYB.d.mts","names":[],"sources":["../src/internal/gateway.ts"],"mappings":";;;;cAmCa,OAAK,OAAA;;;;;;;;KAKN,eAAe,MAAM;;cAGpB,aAAW,OAAA;gBAAX,OAAA;;;KAoBD;;;;;cAmBC,gBAAa,iBAAmB;;cAchC,cAAW,cAAgB;KAY5B;WACD,OAAO,SAAS;WAChB;;WAEA;;;KAIC;WACD,UAAU;WACV;;KAGC;WACD,KAAK;;;;;WAKL,YAAY,MAAM,MAAM,UAAU,eAAe,iBAAiB,MAAM;;;;;;;;;;cAgCtE,UAAO,KACb,WACJ,OAAO,OAAO,SAAS,eAAe,wBAAwB,MAAM"}

package/dist/index.d.mts

@@ -0,0 +1,2 @@
+import { t as Discord_d_exports } from "./Discord.mjs";
+export { Discord_d_exports as Discord };

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { t as Discord_exports } from "./Discord.mjs";
+export { Discord_exports as Discord };

package/dist/internal/events.d.mts

@@ -0,0 +1,2 @@
+import { a as InteractionData, c as ReactionAdd, d as toEvents, i as InteractionCreate, l as ReplyTarget, n as Dispatch, o as MESSAGE_COMPONENT, r as Emoji, s as MessageCreate, t as BotIdentity, u as User } from "../events-Du1u-kVV.mjs";
+export { BotIdentity, Dispatch, Emoji, InteractionCreate, InteractionData, MESSAGE_COMPONENT, MessageCreate, ReactionAdd, ReplyTarget, User, toEvents };