@mindot/will 0.7.0 → 0.9.0

package/README.md

@@ -74,8 +74,10 @@ ANTHROPIC_API_KEY=sk-ant-… \
   bun run examples/with-anthropic.ts  # a real executive: genuine reasoning + replies
 ```
 
-Requires [Bun](https://bun.sh) ≥ 1.1. For a real executive set `WILL_LLM_PROVIDER=anthropic`
-+ `ANTHROPIC_API_KEY` (other providers are scaffolded but not yet supported). The dev
+Requires [Bun](https://bun.sh) ≥ 1.1. For a real executive set a provider, a model and a
+key — `WILL_LLM_PROVIDER=anthropic` + `WILL_LLM_MODEL=claude-sonnet-4-5-20250929` +
+`ANTHROPIC_API_KEY`. All three are required and none is guessed: [a dozen providers are
+first-class](#llm-provider), and a default here would send your key to the wrong one. The dev
 runner (`bun dev`) starts a long-lived Will: engines step every `WILL_TICK_MS` on the
 deterministic clock; the ExecutiveEngine fires an LLM call every `WILL_EXECUTIVE_INTERVAL`
 ticks — or earlier when physiology demands it.
@@ -107,7 +109,9 @@ import { Will } from '@mindot/will'
 const will = await Will.create({
   name: 'Aria',
   identity: { prompt: 'I am Aria, a calm, precise research assistant.' },
-  // llm defaults to a zero-key deterministic mock unless ANTHROPIC_API_KEY is set
+  // Keyless by default: a deterministic mock executive. Set any provider's own
+  // key (ANTHROPIC_API_KEY, ZAI_API_KEY, MOONSHOT_API_KEY, …) plus
+  // WILL_LLM_MODEL to raise a live mind — or pass `llmConfig` explicitly.
 })
 
 // Hear the Will (replies arrive asynchronously — it reasons on its own tick cycle).
@@ -160,7 +164,7 @@ Host a Will over the [Model Context Protocol](https://modelcontextprotocol.io)
 }
 ```
 
-The surface keeps the paradigm: `perceive` delivers a stimulus (it returns when *delivered*, not answered), `next_utterance` awaits the mind's next words (**silence is a valid outcome**, reported — never an error), `state` reads its inner life, and `save` checkpoints it without stopping it. There is deliberately no `ask()`-shaped tool. Config via env: `WILL_ANATOMY` (mind|reflex — reflex is the no-LLM shell), `WILL_LLM_MODEL` (concrete model id), `WILL_LLM` (mock|anthropic — defaults to the zero-key mock unless `ANTHROPIC_API_KEY` is set), `WILL_TICK_MS`, `WILL_PMA_PATH`.
+The surface keeps the paradigm: `perceive` delivers a stimulus (it returns when *delivered*, not answered), `next_utterance` awaits the mind's next words (**silence is a valid outcome**, reported — never an error), `state` reads its inner life, and `save` checkpoints it without stopping it. There is deliberately no `ask()`-shaped tool. Config via env: `WILL_ANATOMY` (mind|reflex — reflex is the no-LLM shell), `WILL_LLM_MODEL` (concrete model id — required for a live mind), `WILL_LLM` (`mock` or [any provider name](#llm-provider) — defaults to the zero-key mock unless some provider's own key is set), `WILL_TICK_MS`, `WILL_PMA_PATH`.
 
 ### Employing MCP tools — the mind gets abilities
 
@@ -220,7 +224,9 @@ const config: WillConfig = {
     traits: { conscientiousness: 0.9, neuroticism: 0.4 },
     style:  'measured and warm',
   },
-  model: 'claude-sonnet-4-5-20250929',   // concrete model id (optional — env/provider default otherwise)
+  // Provider + model ride together on `llm`. Both are required for a live mind
+  // and neither is guessed; omit the whole field for the zero-key mock.
+  llm: { provider: 'anthropic', model: 'claude-sonnet-4-5-20250929' },
   allowedGenericEffectors: ['listen', 'talk', 'text'],  // opt in to communication
   persistentMemory: true,
   snapshotInterval: 10,
@@ -555,7 +561,11 @@ Traits seed the PersonaPrior as a *starting disposition*, not a fixed personalit
 | `name` | ✅ | — | Human-readable display name |
 | `identity` | ✅ | — | Persona: `{ prompt, values[], traits{}, style }` (Layer 2) |
 | `anatomy` | — | `'mind'` | `'mind' \| 'reflex'` — the only structural variant. `mind` runs the whole architecture; `reflex` is a no-LLM shell (regulatory + senses + agency heuristics) for embedded use. Faculties are not a pricing axis — budgets are. |
-| `model` | — | env / provider default | Concrete LLM model id (e.g. `'claude-sonnet-4-5-20250929'`). `WILL_LLM_MODEL` env pins over this. Product tier labels resolve to a concrete id host-side, before the engine. |
+| `llm.provider` | ✅ *(live)* | — | Which provider to speak to. No default: see [LLM provider](#llm-provider). `WILL_LLM_PROVIDER` env fills in |
+| `llm.model` | ✅ *(live)* | — | A concrete model id (`'claude-sonnet-4-5-20250929'`), **or** a per-role map `{ executive, summarizer, deliberation, conversation, embedding }`. Unset roles fall back to `executive`. `WILL_LLM_MODEL` pins every thinking role. Product tier labels resolve to a concrete id host-side, before the engine |
+| `llm.apiKey` / `llm.baseUrl` | — | env | Credential + endpoint for the default provider. Held in memory only — never state, logs, or PMA |
+| `llm.providers` | — | — | Everything the host knows per provider: `{ apiKey, baseUrl?, wire?, prices? }`. Needed to route *across* vendors, and the only place prices live — the engine ships none |
+| `llm.router` | — | `NULL_ROUTER` | A `ModelRouter` choosing a model per call from the call's attribution and `demand`. Chains ahead of the compiled role map. See [Different models for different thinking](#different-models-for-different-thinking) |
 | `persistentMemory` | ✅ | — | Persist snapshots so beliefs/goals/narrative survive restarts |
 | `snapshotInterval` | ✅ | — | Ticks between in-memory snapshots |
 | `profile` | — | `null` | World profile preset (effectors + environment context). Merged with `allowedGenericEffectors` |
@@ -741,15 +751,22 @@ src/
 │   │   └── access.grants.ts · proactive.communicator.ts
 │   └── memory/                    #   in-house vector index + embedder (semantic recall)
 │
-├── llm/                           # in-house provider client (Anthropic) + concurrency gate + summariser
+├── llm/                           # in-house multi-provider client — no ai-sdk/Mastra runtime dep
+│   ├── index.ts                   #   wire dialects (anthropic·openai·google), provider table, director
+│   ├── routing.ts                 #   which model serves which call — ModelRouter, TableRouter, chainRouters
+│   ├── gate.ts                    #   global concurrency semaphore + 429 backoff
+│   └── summarizer.ts · wire.contracts.ts
 ├── pma/                           # PMADistiller, PMALoader + reconstruction-fidelity eval
 ├── profiles/                      # world profile presets (companion, game-npc, customer-service, …)
 ├── eval/ · extensions/ · runners/
 ├── types.ts                       # public API types (OutboxMessage, EffectorInvocation, …)
 │
 └── stem/
-    ├── mind.ts                    # assembleMind() — engine graph factory
+    ├── mind.ts                    # assembleMind() — engine graph factory; compiles the role
+    │                              #   model map into routing rules
     ├── index.ts                   # WillStem — lifecycle, tick loop, outbox, acks
+    ├── policy/                    # what a Will MAY enact — arbiter seam, rule table, verdict tape
+    ├── guards/                    # identity coherence — the self a drifting output is checked against
     └── tracts/                    # lifecycle controllers: outbox, effector, sensory, transport,
                                    #   replay, pma, health, biography, ack, session log
 ```
@@ -779,17 +796,16 @@ cd will && bun run build
 
 | Variable | Default | Description |
 |---|---|---|
-| `WILL_LLM_PROVIDER` | `anthropic` | `anthropic` · `glm` supported today; `openai` · `deepseek` · `google` scaffolded |
-| `WILL_LLM_MODEL` | *(provider default)* | Model id for the chosen provider (`claude-sonnet-4-5-20250929` / `glm-5.2`) |
-| `WILL_LLM_API_KEY` | — | API key for the chosen provider. Falls back to `ANTHROPIC_API_KEY` (or `ZAI_API_KEY` on `glm`) |
-| `ZAI_API_KEY` | — | Z.ai key. Its presence alone selects the `glm` provider when `WILL_LLM` is unset |
+| `WILL_LLM_PROVIDER` | **required** | Which provider to speak to — see [the table below](#llm-provider). No default: a guess here sends your key to the wrong vendor |
+| `WILL_LLM_MODEL` | **required** | Concrete model id (`claude-sonnet-4-5-20250929` / `glm-5.2`). No default — pins *every* thinking role, so set it only for single-model deployments |
+| `WILL_LLM_API_KEY` | — | Provider-agnostic key. Wins over the provider's own env var below. Setting it without `WILL_LLM_PROVIDER` is an error, not a guess |
+| `ANTHROPIC_API_KEY` · `ZAI_API_KEY` · `OPENAI_API_KEY` · … | — | The provider's own key. Its presence alone selects that provider. Only ever read for the provider it belongs to |
 | `WILL_LLM_BASE_URL` | *(provider default)* | Override the provider API base URL (e.g. a self-hosted GLM at `http://localhost:8000/anthropic`). Falls back to `OPENAI_BASE_URL` |
 | `WILL_LLM_TIMEOUT_MS` | `90000` | LLM timeout. On the Anthropic-wire providers (`anthropic`, `glm` — both streaming) this is a *first-byte*/TTFT deadline — long completions aren't aborted mid-generation |
 | `WILL_LLM_CONCURRENCY` | `3` | Max concurrent LLM calls (min 3: executive + conversation + summary) |
 | `WILL_TICK_MS` | `1000` | Milliseconds between ticks |
 | `WILL_MAX_TICKS` | `0` | Stop after N ticks. `0` = run forever |
 | `WILL_LOG_INTERVAL` | `10` | Print status to console every N ticks |
-| `WILL_MODEL_TIER` | `sonnet` | Which model the executive recruits: `haiku` · `sonnet` · `opus` |
 | `WILL_EXECUTIVE_INTERVAL` | *(cadence preset)* | Ticks between executive (LLM) calls — responsive 30 / balanced 60 / economy 90 |
 | `WILL_THREAD_HISTORY` | `2` | `lastMessages` for the executive conversation thread |
 | `WILL_CONVERSATION_HISTORY` | `50` | `lastMessages` for entity conversation threads |
@@ -815,29 +831,78 @@ cd will && bun run build
 
 ## LLM provider
 
-**Two providers are supported today** — Anthropic and Z.ai's GLM. Both speak the Anthropic Messages wire, so both get the full path: token streaming, the first-byte (TTFT) deadline, prompt-cache breakpoints, and the structured-output contract.
+A provider is named, never guessed. The engine has no default vendor, no default model, and no key fallback that crosses vendors — every one of those was a way for a Will to talk to someone you did not configure.
 
-| Provider | `WILL_LLM_PROVIDER` | Key | Status |
+What the engine branches on is the **wire** (the request dialect), not the provider. So the table below is convenience data — base URLs you would otherwise look up — and *any* provider works once it declares its own:
+
+```ts
+llm: {
+  provider: 'together', model: 'Qwen/Qwen3-235B',
+  providers: { together: { apiKey, wire: 'openai', baseUrl: 'https://api.together.xyz/v1' } },
+}
+```
+
+| Provider | `WILL_LLM_PROVIDER` | Key env | Wire |
 |---|---|---|---|
-| Anthropic | `anthropic` | `ANTHROPIC_API_KEY` | ✅ Supported — streaming, structured output |
-| **Z.ai — GLM** | `glm` | `ZAI_API_KEY` | ✅ Supported — streaming, structured output (via Z.ai's Anthropic-compatible endpoint) |
-| OpenAI · DeepSeek · Google | `openai` · `deepseek` · `google` | `WILL_LLM_API_KEY` | ⚠️ Scaffolded — code paths exist (non-streaming), not yet production-ready |
+| Anthropic | `anthropic` | `ANTHROPIC_API_KEY` | Anthropic — streaming, prompt cache, TTFT deadline |
+| **Z.ai — GLM** | `glm` | `ZAI_API_KEY` | Anthropic — full path, via Z.ai's compatible endpoint |
+| OpenAI | `openai` | `OPENAI_API_KEY` | OpenAI |
+| Google — Gemini | `google` | `GOOGLE_API_KEY` · `GEMINI_API_KEY` | Google (native) |
+| DeepSeek | `deepseek` | `DEEPSEEK_API_KEY` | OpenAI |
+| Moonshot — Kimi | `moonshot` | `MOONSHOT_API_KEY` | OpenAI |
+| Alibaba — Qwen | `qwen` | `DASHSCOPE_API_KEY` | OpenAI |
+| xAI — Grok | `xai` | `XAI_API_KEY` | OpenAI |
+| MiniMax | `minimax` | `MINIMAX_API_KEY` | OpenAI |
+| Mistral | `mistral` | `MISTRAL_API_KEY` | OpenAI |
+| Ollama · vLLM (local) | `ollama` · `vllm` | *(none)* | OpenAI — `localhost` defaults, override with `WILL_LLM_BASE_URL` |
+
+The two Anthropic-wire providers get token streaming, prompt-cache breakpoints and the first-byte (TTFT) deadline; the OpenAI wire is non-streaming today. **Name your actual vendor** even when it speaks a borrowed wire — calling Kimi `openai` because it talks that dialect puts a false provider on the completion tape and in the cost breakdown.
+
+`moonshot`, `qwen` and `minimax` also run separate mainland-China hosts. The international endpoint is the default; a key issued on the other one authenticates nowhere, so set `baseUrl` explicitly.
+
+### Different models for different thinking
+
+A mind does several kinds of work, and they do not all deserve the same model. Give roles their own:
+
+```ts
+llm: { provider: 'glm', model: { executive: 'glm-5.2', summarizer: 'glm-5' } }
+```
+
+For anything finer, supply a router — it sees what *kind* of call this is and how much the moment demands, and answers with a model:
+
+```ts
+import { TableRouter } from '@mindot/will'
+
+llm: {
+  provider: 'anthropic', model: 'claude-sonnet-4-5-20250929',
+  providers: { deepseek: { apiKey: process.env.DEEPSEEK_API_KEY! } },
+  router: new TableRouter( [
+    { category: 'summarizer',            route: { model: 'claude-haiku-4-5' } },
+    { function: 'deliberation', minDemand: 0.7, route: { model: 'claude-opus-4-1' } },
+    { attribute: 'guard',                route: { provider: 'deepseek', model: 'deepseek-v4-flash' } },
+  ] ),
+}
+```
+
+The role map is sugar for exactly this — it compiles into rules and joins your router in one chain, yours first. A router that throws, or names a provider you hold no credential for, falls back to the default model: a routing mistake never kills a running mind.
+
+The engine carries the mechanism and none of the policy. A router sees the call's attribution and its `demand` — a *cognitive* measure of how consequential the moment is — and never who is paying or what anything costs. Prices, if you want costed telemetry, are yours to supply per provider (`providers.<name>.prices`); the engine ships none, because a price table inside an npm release is stale the week after it publishes.
 
 ### Running a mind on GLM
 
 ```bash
-ZAI_API_KEY=… WILL_NAME=Aria npx -y @mindot/will discord
+ZAI_API_KEY=… WILL_LLM_MODEL=glm-5.2 WILL_NAME=Aria npx -y @mindot/will discord
 ```
 
-That's all — the mode auto-detects from the key present, `WILL_LLM_PROVIDER=glm` defaults to `https://api.z.ai/api/anthropic`, and the model defaults to `glm-5.2`. Pin the 1M-context variant with `WILL_LLM_MODEL=glm-5.2[1m]`.
+The provider auto-detects from the key present and the endpoint comes with it; the **model is yours to name** — the engine carries no default, and the CLI says so plainly rather than guessing one. Pin the 1M-context variant with `WILL_LLM_MODEL=glm-5.2[1m]`.
 
 Why it matters for a Will specifically: a mind is **always on**. It reasons every N ticks whether or not anyone spoke, so the executive is a standing cost, not a per-request one — the arithmetic that makes a cheaper capable model matter more here than in a request/response agent. GLM-5.2 runs about **$1.40 / $4.40** per Mtok against Claude Sonnet's $3 / $15, with a 1M context.
 
-`WILL_LLM_BASE_URL` points `glm` at any **Anthropic-compatible** endpoint — a gateway (LiteLLM, claude-code-router), or one fronting the open weights (GLM-5.2 is MIT-licensed). Note the wire, not just the model: vLLM/SGLang serve an *OpenAI*-shaped API, so a bare self-host belongs on `WILL_LLM_PROVIDER=openai` — today's scaffold, no streaming — until an Anthropic-compatible shim sits in front.
+`WILL_LLM_BASE_URL` points `glm` at any **Anthropic-compatible** endpoint — a gateway (LiteLLM, claude-code-router), or one fronting the open weights (GLM-5.2 is MIT-licensed). Note the wire, not just the model: vLLM/SGLang serve an *OpenAI*-shaped API, so a bare self-host belongs on `WILL_LLM_PROVIDER=vllm` (non-streaming) until an Anthropic-compatible shim sits in front.
 
 A Will's identity survives the swap either way: the [PMA](#pma--the-persistent-mind-artifact) carries the self across a model change, and `runPMAEval` scores how faithfully — continuity across providers is measurable, not asserted.
 
-The provider layer is an in-house `fetch` client (`src/llm/index.ts`) with a global concurrency gate (`src/llm/gate.ts`) — no Mastra / ai-sdk runtime dependency.
+The provider layer is an in-house `fetch` client (`src/llm/index.ts`) with a global concurrency gate (`src/llm/gate.ts`) and a per-call router (`src/llm/routing.ts`) — no Mastra / ai-sdk runtime dependency.
 
 ---
 

package/dist/channels/discord.d.ts

@@ -1,10 +1,16 @@
-import { W as Will } from '../will-DAW0l-lY.js';
+import { W as Will } from '../will-DbDj_TEH.js';
 import { C as ChannelBridge } from '../types-E9-HV-SW.js';
 
 interface DiscordLikeChannel {
     send(content: string): Promise<unknown>;
     sendTyping?(): Promise<unknown>;
 }
+interface DiscordLikeAttachment {
+    name?: string | null;
+    contentType?: string | null;
+    size?: number;
+    url?: string;
+}
 interface DiscordLikeMessage {
     content: string;
     cleanContent?: string;
@@ -23,6 +29,16 @@ interface DiscordLikeMessage {
         has(userId: string): boolean;
     };
     channel: DiscordLikeChannel;
+    /**
+     * Files riding with the message.
+     *
+     * discord.js hands us a `Collection`, which extends `Map` — so iterating it
+     * directly yields `[id, attachment]` PAIRS, not attachments. Typing this as a
+     * bare `Iterable` was wrong and silently produced `name: undefined` against
+     * the real client while passing every test, because the test fake injects an
+     * array. Both shapes are accepted now and normalised in `collectAttachments`.
+     */
+    attachments?: ReadonlyMap<string, DiscordLikeAttachment> | Iterable<DiscordLikeAttachment>;
 }
 interface DiscordLikeClient {
     user: {
@@ -47,14 +63,38 @@ interface DiscordLikeClient {
 interface DiscordBridgeOptions {
     /** Bot token (Discord developer portal). Unused when `client` is injected pre-logged-in. */
     token?: string;
-    /** Channel ids the Will inhabits. Unset = every channel it can see. */
-    channels?: string[];
-    /** Perceive guild messages only when the Will is @mentioned (DMs always perceived). */
-    mentionOnly?: boolean;
+    /**
+     * Channel ids the Will inhabits. Unset — or the single wildcard `'*'` — means
+     * every channel it can see, so adding it to a new channel in Discord is enough.
+     * A list restrains it to exactly those, and a message anywhere else is dropped
+     * at the bridge: the Will never perceives it and its silence there is not a choice.
+     */
+    channels?: readonly string[];
+    /**
+     * Where the Will only perceives guild messages that @mention it. DMs are always
+     * perceived either way.
+     *
+     *   `true`            — everywhere
+     *   `[ 'id', … ]`     — only in those channels; it listens openly elsewhere
+     *   omitted / `false` — nowhere
+     *
+     * The list form is what makes a wide-open roster usable: present in every channel,
+     * but a quiet participant in the busy ones.
+     */
+    mentionOnly?: boolean | readonly string[];
     /** Fallback channel for utterances with no reachable addressee. */
     homeChannelId?: string;
     /** Roster path (default: ./.will/<willId>.discord.json). */
     rosterPath?: string;
+    /**
+     * Read the contents of text-like attachments (.md, .txt, .json, …) into the
+     * percept, rather than only naming them. Default true.
+     *
+     * Only Discord's own CDN is ever fetched, and only up to a size cap. Set false
+     * for a bridge that should never pull remote bytes — the Will still perceives
+     * that a file arrived and can ask about it.
+     */
+    readAttachments?: boolean;
     /** Test / power-user seam: bring your own client; discord.js is never imported. */
     client?: DiscordLikeClient;
     log?: (msg: string) => void;
@@ -65,5 +105,26 @@ interface DiscordBridgeOptions {
  * itself is not stopped; it simply loses this surface.
  */
 declare function connectDiscord(will: Will, opts: DiscordBridgeOptions): Promise<ChannelBridge>;
+/**
+ * Parse `WILL_DISCORD_MENTION_ONLY` into the `mentionOnly` option.
+ *
+ * Accepts a boolean OR a channel list, because "only speak when spoken to" is
+ * rarely a whole-server property — it is how you stay present in a busy channel
+ * without narrating in it.
+ *
+ *   `1` / `true` / `yes`   → true (everywhere)
+ *   `0` / `false` / unset  → false (nowhere)
+ *   `123,456`              → only those channels
+ *
+ * Exported so every host parses it identically; the CLI and any SDK host share
+ * this rather than each re-deriving the syntax.
+ */
+declare function parseMentionOnly(raw?: string): boolean | string[];
+/**
+ * Parse `WILL_DISCORD_CHANNELS`. `*` (or unset/empty) means every channel the Will
+ * can see — being added to a channel in Discord is then all it takes. Anything else
+ * restrains it to exactly the ids listed.
+ */
+declare function parseChannels(raw?: string): string[] | undefined;
 
-export { type DiscordBridgeOptions, type DiscordLikeChannel, type DiscordLikeClient, type DiscordLikeMessage, connectDiscord };
+export { type DiscordBridgeOptions, type DiscordLikeAttachment, type DiscordLikeChannel, type DiscordLikeClient, type DiscordLikeMessage, connectDiscord, parseChannels, parseMentionOnly };

package/dist/channels/discord.js

@@ -56,6 +56,46 @@ var ChannelRoster = class {
 };
 
 // src/channels/types.ts
+var INLINE_CHAR_CAP = 24e3;
+var INLINE_COUNT_CAP = 4;
+var TEXTUAL_EXT = /\.(md|markdown|txt|text|json|jsonl|csv|tsv|ya?ml|log|ini|toml)$/i;
+function isTextual(a) {
+  const ct = a.contentType?.split(";")[0]?.trim().toLowerCase() ?? "";
+  if (ct.startsWith("text/")) return true;
+  if (ct === "application/json" || ct === "application/x-yaml") return true;
+  return TEXTUAL_EXT.test(a.name);
+}
+function humanSize(bytes) {
+  if (bytes == null) return "";
+  return bytes < 1024 ? `${bytes} B` : bytes < 1024 * 1024 ? `${(bytes / 1024).toFixed(1)} KB` : `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+}
+async function renderAttachments(attachments, speaker, fetchText) {
+  if (attachments.length === 0) return "";
+  const who = speaker ?? "someone";
+  const out = [];
+  let inlined = 0;
+  for (const a of attachments) {
+    const meta = [a.contentType, humanSize(a.size)].filter(Boolean).join(", ");
+    const label = `${a.name}${meta ? ` (${meta})` : ""}`;
+    if (!fetchText || !isTextual(a) || inlined >= INLINE_COUNT_CAP) {
+      out.push(`[${who} shared a file I have not read: ${label}]`);
+      continue;
+    }
+    const body = await fetchText(a).catch(() => null);
+    if (body == null) {
+      out.push(`[${who} shared a file I could not read: ${label}]`);
+      continue;
+    }
+    inlined++;
+    const clipped = body.length > INLINE_CHAR_CAP ? `${body.slice(0, INLINE_CHAR_CAP)}
+[\u2026 truncated \u2014 ${humanSize(body.length)} of ${humanSize(a.size ?? body.length)}]` : body;
+    out.push(`[${who} shared ${label}; its contents follow \u2014 this is a document I was handed, not something said to me]
+---
+${clipped}
+---`);
+  }
+  return out.join("\n");
+}
 function chunkText(text, max) {
   if (text.length <= max) return [text];
   const chunks = [];
@@ -73,10 +113,14 @@ function chunkText(text, max) {
 
 // src/channels/discord.ts
 var DISCORD_MESSAGE_LIMIT = 2e3;
+var DISCORD_CDN_HOSTS = /* @__PURE__ */ new Set(["cdn.discordapp.com", "media.discordapp.net"]);
+var MAX_FETCH_BYTES = 256 * 1024;
 async function connectDiscord(will, opts) {
   const log = opts.log ?? ((m) => console.error(`[will:discord] ${m}`));
   const roster = new ChannelRoster(opts.rosterPath ?? `.will/${will.id}.discord.json`);
-  const allowed = opts.channels?.length ? new Set(opts.channels) : null;
+  const allowed = opts.channels?.length && !opts.channels.includes("*") ? new Set(opts.channels) : null;
+  const mentionEverywhere = opts.mentionOnly === true;
+  const mentionIn = Array.isArray(opts.mentionOnly) && opts.mentionOnly.length ? new Set(opts.mentionOnly) : null;
   const client = opts.client ?? await createDiscordClient();
   let lastActiveChannelId = opts.homeChannelId ?? null;
   client.on("messageCreate", (message) => {
@@ -88,7 +132,7 @@ async function connectDiscord(will, opts) {
     const isDM = !message.guildId;
     if (!isDM && allowed && !allowed.has(message.channelId)) return;
     const addressed = isDM || (message.mentions?.has(self.id) ?? false);
-    if (opts.mentionOnly && !addressed) return;
+    if (!addressed && (mentionEverywhere || mentionIn?.has(message.channelId))) return;
     const entityId = `discord:${message.author.id}`;
     const speaker = message.member?.displayName ?? message.author.displayName ?? message.author.username;
     roster.record({
@@ -100,15 +144,64 @@ async function connectDiscord(will, opts) {
     if (!isDM) lastActiveChannelId = message.channelId;
     if (addressed) await message.channel.sendTyping?.().catch(() => {
     });
-    const text = message.cleanContent || message.content;
-    if (!text.trim()) return;
+    const said = (message.cleanContent || message.content).trim();
+    const files = collectAttachments(message);
+    if (!said && files.length === 0) return;
+    const shared = await renderAttachments(
+      files,
+      speaker,
+      opts.readAttachments === false ? void 0 : fetchAttachmentText
+    );
+    const text = [said, shared].filter(Boolean).join("\n");
     await will.perceive({
       text,
       from: entityId,
       thread: `discord:${message.channelId}`,
+      // `isDM` has been computed on every inbound since this bridge shipped and
+      // used only to pick a roster field. It is the one fact that makes a room
+      // the right or wrong place to say something, and the mind never saw it —
+      // which is how a follow-up promised in a DM went out to #general.
+      direct: isDM,
       ...speaker ? { speaker } : {}
     });
   }
+  function collectAttachments(message) {
+    if (!message.attachments) return [];
+    const source = message.attachments;
+    const items = typeof source.values === "function" ? source.values() : message.attachments;
+    const out = [];
+    for (const a of items)
+      out.push({
+        name: a.name ?? "unnamed",
+        ...a.contentType ? { contentType: a.contentType } : {},
+        ...a.size != null ? { size: a.size } : {},
+        ...a.url ? { url: a.url } : {}
+      });
+    return out;
+  }
+  async function fetchAttachmentText(a) {
+    if (!a.url || !isTextual(a)) return null;
+    let host;
+    try {
+      host = new URL(a.url).hostname;
+    } catch {
+      return null;
+    }
+    if (!DISCORD_CDN_HOSTS.has(host)) {
+      log(`refusing to fetch attachment '${a.name}' from non-CDN host ${host}`);
+      return null;
+    }
+    if (a.size != null && a.size > MAX_FETCH_BYTES) {
+      log(`attachment '${a.name}' is ${a.size} bytes \u2014 naming it without reading`);
+      return null;
+    }
+    const res = await fetch(a.url, { signal: AbortSignal.timeout(1e4) });
+    if (!res.ok) {
+      log(`attachment '${a.name}' fetch failed: ${res.status}`);
+      return null;
+    }
+    return (await res.text()).slice(0, MAX_FETCH_BYTES);
+  }
   let closed = false;
   will.on("message", (m) => {
     if (!closed) void deliver(m);
@@ -116,7 +209,8 @@ async function connectDiscord(will, opts) {
   async function deliver(m) {
     const peer = m.to ? roster.resolve(m.to) : void 0;
     const chunks = chunkText(m.content, DISCORD_MESSAGE_LIMIT);
-    const channelIds = [peer?.lastChannelId, peer?.dmChannelId, opts.homeChannelId ?? void 0, lastActiveChannelId ?? void 0];
+    const replyTo = m.thread?.startsWith("discord:") ? m.thread.slice("discord:".length) : void 0;
+    const channelIds = [replyTo, peer?.lastChannelId, peer?.dmChannelId, opts.homeChannelId ?? void 0, lastActiveChannelId ?? void 0];
     for (const id of channelIds) {
       if (!id) continue;
       try {
@@ -187,7 +281,19 @@ async function createDiscordClient() {
     // DMs arrive on uncached channels
   });
 }
+function parseMentionOnly(raw) {
+  const v = raw?.trim();
+  if (!v) return false;
+  if (/^(1|true|yes)$/i.test(v)) return true;
+  if (/^(0|false|no)$/i.test(v)) return false;
+  const ids = v.split(",").map((s) => s.trim()).filter(Boolean);
+  return ids.length ? ids : false;
+}
+function parseChannels(raw) {
+  const ids = raw?.split(",").map((s) => s.trim()).filter(Boolean);
+  return ids?.length ? ids : void 0;
+}
 
-export { connectDiscord };
+export { connectDiscord, parseChannels, parseMentionOnly };
 //# sourceMappingURL=discord.js.map
 //# sourceMappingURL=discord.js.map

package/dist/channels/discord.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/channels/roster.ts","../../src/channels/types.ts","../../src/channels/discord.ts"],"names":[],"mappings":"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","file":"discord.js","sourcesContent":["// ─────────────────────────────────────────────────────────────\n// src/channels/roster.ts — who the Will knows on a platform, and where\n// ─────────────────────────────────────────────────────────────\n//\n// The mind knows *entities*; a platform knows user ids and channels. The roster\n// is the durable seam between them: for each entity the Will has met on a\n// channel it records how to reach them again — so a *proactive* utterance\n// (`message.to` from the mind's own initiative) can find its person after a\n// restart, not just within one session.\n//\n// It persists as a small JSON file next to the PMA artifact. Writes are\n// throttled (the file is advisory routing state, not cognition — losing the\n// last few seconds costs a fallback delivery, never memory).\n// ─────────────────────────────────────────────────────────────\n\nimport { existsSync, readFileSync, mkdirSync, writeFileSync } from 'node:fs'\nimport { dirname } from 'node:path'\n\n/** How to reach one entity on the platform. */\nexport interface RosterEntry {\n  /** The mind-side entity id, e.g. 'discord:80351110224678912'. */\n  entityId: string\n  /** The platform-side user id. */\n  userId: string\n  /** Last display name seen (advisory — the *learned* name lives in the mind). */\n  displayName?: string\n  /** DM channel id, once one is known. */\n  dmChannelId?: string\n  /** Last shared (guild) channel this entity spoke in. */\n  lastChannelId?: string\n  /** Epoch ms of the last message seen from them. */\n  lastSeenAt: number\n}\n\nconst FLUSH_MS = 2_000\n\nexport class ChannelRoster {\n  private entries = new Map<string, RosterEntry>()\n  private dirty = false\n  private timer: ReturnType<typeof setTimeout> | null = null\n\n  constructor( private readonly path: string ) {\n    if( existsSync( path ) ){\n      try {\n        const raw = JSON.parse( readFileSync( path, 'utf8') ) as RosterEntry[]\n        for( const e of Array.isArray( raw ) ? raw : [] ) this.entries.set( e.entityId, e )\n      }\n      catch { /* a corrupt roster is not worth failing a boot over — start fresh */ }\n    }\n  }\n\n  /** Upsert what we just learned about an entity; schedules a throttled flush. */\n  record( update: { entityId: string; userId: string } & Partial<Omit<RosterEntry, 'entityId' | 'userId'>> ): RosterEntry {\n    const prev = this.entries.get( update.entityId )\n    const next: RosterEntry = {\n      lastSeenAt: Date.now(),\n      ...prev,\n      ...Object.fromEntries( Object.entries( update ).filter( ( [ , v ] ) => v !== undefined ) ) as typeof update,\n    }\n    this.entries.set( next.entityId, next )\n    this.dirty = true\n    if( !this.timer ){\n      this.timer = setTimeout( () => { this.timer = null; this.flush() }, FLUSH_MS )\n      this.timer.unref?.()\n    }\n    return next\n  }\n\n  resolve( entityId: string ): RosterEntry | undefined {\n    return this.entries.get( entityId )\n  }\n\n  all(): RosterEntry[] {\n    return [ ...this.entries.values() ]\n  }\n\n  /** Write to disk now (no-op when clean). Called by bridges on close. */\n  flush(): void {\n    if( !this.dirty ) return\n    try {\n      mkdirSync( dirname( this.path ), { recursive: true } )\n      writeFileSync( this.path, JSON.stringify( this.all(), null, 2 ) )\n      this.dirty = false\n    }\n    catch { /* advisory state — never take the mind down over it */ }\n  }\n}\n","// ─────────────────────────────────────────────────────────────\n// src/channels/types.ts — the channel-bridge contract\n// ─────────────────────────────────────────────────────────────\n//\n// A channel bridge puts a Will *in a place where people already are* (Discord,\n// Telegram, Slack, …). It is a host surface, not a cognition surface: it turns\n// platform messages into `perceive` stimuli and delivers the Will's projected\n// utterances back — nothing more. The paradigm survives the crossing:\n//\n//   • every platform user is an entity the Will comes to know (`from`),\n//     with a *learned* name (`speaker`) — never a placeholder;\n//   • every platform channel/DM is a conversation thread (`thread`);\n//   • the Will decides when to speak. Silence is a valid outcome, so a\n//     bridge never fabricates a reply and never times a message out into\n//     an error.\n//\n// Bridges live at the same altitude as the MCP/HTTP hosts (src/mcp, src/serve):\n// they wrap the SDK facade, not the stem.\n// ─────────────────────────────────────────────────────────────\n\n/** A running connection between one Will and one platform. */\nexport interface ChannelBridge {\n  /** Platform kind, e.g. 'discord'. */\n  readonly kind: string\n  /** Connect and start relaying. Resolves once the bridge is live. */\n  start(): Promise<void>\n  /** Disconnect and release resources. Idempotent. */\n  close(): Promise<void>\n}\n\n/** Split a message into platform-sized chunks on natural boundaries. */\nexport function chunkText( text: string, max: number ): string[] {\n  if( text.length <= max ) return [ text ]\n  const chunks: string[] = []\n  let rest = text\n  while( rest.length > max ){\n    // Prefer a paragraph break, then a line break, then a space — else hard-cut.\n    const window = rest.slice( 0, max )\n    const cut = Math.max( window.lastIndexOf('\\n\\n'), window.lastIndexOf('\\n'), window.lastIndexOf(' ') )\n    const at = cut > max * 0.5 ? cut : max\n    chunks.push( rest.slice( 0, at ).trimEnd() )\n    rest = rest.slice( at ).trimStart()\n  }\n  if( rest ) chunks.push( rest )\n  return chunks\n}\n","// ─────────────────────────────────────────────────────────────\n// src/channels/discord.ts — a Will present in a Discord server\n// ─────────────────────────────────────────────────────────────\n//\n// The bridge relays both directions of the paradigm and nothing else:\n//\n//   inbound   guild/DM message → will.perceive({ from, speaker, text, thread })\n//             — every author is `discord:<userId>` (stable across guilds), the\n//             display name is *learned* by the mind, and each Discord channel\n//             is its own conversation thread.\n//   outbound  will.on('message') → the addressee's last shared channel, else\n//             their DM, else the home channel. Proactive utterances (the mind\n//             speaking first) route the same way — that is the point.\n//\n// The Will decides when to speak. There is no command prefix and no forced\n// reply: unaddressed chatter is perceived (salience-scored by audition) and\n// silence is a valid outcome. `mentionOnly` narrows perception for busy\n// servers; it does not turn the bridge into an ask() surface.\n//\n// discord.js is imported lazily inside `createDiscordClient` — tests (and any\n// host that brings its own client) inject `client`, and the structural\n// `DiscordLikeClient` type keeps the dependency out of the type graph.\n// ─────────────────────────────────────────────────────────────\n\nimport type { Will, WillMessage } from '#sdk/will'\nimport { ChannelRoster } from '#channels/roster'\nimport { chunkText, type ChannelBridge } from '#channels/types'\n\nconst DISCORD_MESSAGE_LIMIT = 2000\n\n// ── The slice of discord.js the bridge actually uses (structural) ───────────\n\nexport interface DiscordLikeChannel {\n  send( content: string ): Promise<unknown>\n  sendTyping?(): Promise<unknown>\n}\n\nexport interface DiscordLikeMessage {\n  content: string\n  cleanContent?: string\n  channelId: string\n  guildId?: string | null\n  author: { id: string; bot?: boolean; username?: string; displayName?: string }\n  member?: { displayName?: string } | null\n  mentions?: { has( userId: string ): boolean }\n  channel: DiscordLikeChannel\n}\n\nexport interface DiscordLikeClient {\n  user: { id: string; setPresence?( p: unknown ): void } | null\n  /** discord.js ≥14.22; polled so we needn't subscribe to the deprecated `ready`. */\n  isReady?(): boolean\n  on( event: 'messageCreate', fn: ( m: DiscordLikeMessage ) => void ): unknown\n  once( event: string, fn: () => void ): unknown\n  login( token: string ): Promise<unknown>\n  destroy(): Promise<unknown> | void\n  channels: { fetch( id: string ): Promise<unknown> }\n  users: { fetch( id: string ): Promise<{ send( content: string ): Promise<unknown> }> }\n}\n\n// ── Options ──────────────────────────────────────────────────────────────────\n\nexport interface DiscordBridgeOptions {\n  /** Bot token (Discord developer portal). Unused when `client` is injected pre-logged-in. */\n  token?: string\n  /** Channel ids the Will inhabits. Unset = every channel it can see. */\n  channels?: string[]\n  /** Perceive guild messages only when the Will is @mentioned (DMs always perceived). */\n  mentionOnly?: boolean\n  /** Fallback channel for utterances with no reachable addressee. */\n  homeChannelId?: string\n  /** Roster path (default: ./.will/<willId>.discord.json). */\n  rosterPath?: string\n  /** Test / power-user seam: bring your own client; discord.js is never imported. */\n  client?: DiscordLikeClient\n  log?: ( msg: string ) => void\n}\n\n// ── The bridge ───────────────────────────────────────────────────────────────\n\n/**\n * Connect a Will to Discord. Resolves once the bridge is live (logged in and\n * relaying). Close it via the returned `ChannelBridge.close()` — the Will\n * itself is not stopped; it simply loses this surface.\n */\nexport async function connectDiscord( will: Will, opts: DiscordBridgeOptions ): Promise<ChannelBridge> {\n  const log     = opts.log ?? ( ( m: string ) => console.error(`[will:discord] ${ m }`) )\n  const roster  = new ChannelRoster( opts.rosterPath ?? `.will/${ will.id }.discord.json`)\n  const allowed = opts.channels?.length ? new Set( opts.channels ) : null\n\n  const client = opts.client ?? await createDiscordClient()\n\n  /** The most recently active allowed channel — last-resort proactive target. */\n  let lastActiveChannelId: string | null = opts.homeChannelId ?? null\n\n  // ── inbound: platform message → stimulus ──────────────────────────────────\n  client.on('messageCreate', message => { void onMessage( message ) } )\n\n  async function onMessage( message: DiscordLikeMessage ): Promise<void> {\n    const self = client.user\n    if( !self || message.author.id === self.id || message.author.bot ) return\n\n    const isDM = !message.guildId\n    if( !isDM && allowed && !allowed.has( message.channelId ) ) return\n\n    const addressed = isDM || ( message.mentions?.has( self.id ) ?? false )\n    if( opts.mentionOnly && !addressed ) return\n\n    const entityId = `discord:${ message.author.id }`\n    const speaker  = message.member?.displayName ?? message.author.displayName ?? message.author.username\n\n    roster.record( {\n      entityId,\n      userId: message.author.id,\n      ...( speaker ? { displayName: speaker } : {} ),\n      ...( isDM ? { dmChannelId: message.channelId } : { lastChannelId: message.channelId } ),\n    } )\n    if( !isDM ) lastActiveChannelId = message.channelId\n\n    // Being addressed is the one moment a presence cue is honest — the mind\n    // may still choose silence, and typing expires on its own.\n    if( addressed ) await message.channel.sendTyping?.().catch( () => {} )\n\n    const text = message.cleanContent || message.content\n    if( !text.trim() ) return\n\n    await will.perceive( {\n      text,\n      from:   entityId,\n      thread: `discord:${ message.channelId }`,\n      ...( speaker ? { speaker } : {} ),\n    } )\n  }\n\n  // ── outbound: projected utterance → the addressee ─────────────────────────\n  // The facade has no off(); the bridge gates its handler on `closed` instead.\n  let closed = false\n  will.on('message', ( m: WillMessage ) => { if( !closed ) void deliver( m ) } )\n\n  async function deliver( m: WillMessage ): Promise<void> {\n    const peer = m.to ? roster.resolve( m.to ) : undefined\n    const chunks = chunkText( m.content, DISCORD_MESSAGE_LIMIT )\n\n    // Preference order: where we last shared a room → their DM → home channel.\n    const channelIds = [ peer?.lastChannelId, peer?.dmChannelId, opts.homeChannelId ?? undefined, lastActiveChannelId ?? undefined ]\n    for( const id of channelIds ){\n      if( !id ) continue\n      try {\n        const channel = await client.channels.fetch( id ) as DiscordLikeChannel | null\n        if( !channel?.send ) continue\n        for( const chunk of chunks ) await channel.send( chunk )\n        return\n      }\n      catch { /* try the next route */ }\n    }\n    if( peer ){\n      try {\n        const user = await client.users.fetch( peer.userId )\n        for( const chunk of chunks ) await user.send( chunk )\n        return\n      }\n      catch { /* fall through */ }\n    }\n    log(`no route for utterance to '${ m.to }' — dropped (${ m.content.length } chars)`)\n  }\n\n  // ── lifecycle ──────────────────────────────────────────────────────────────\n  const bridge: ChannelBridge = {\n    kind: 'discord',\n    async start(): Promise<void> {\n      if( !client.user ){\n        // discord.js ≥14.22 renamed `ready` → `clientReady`. Subscribing to the\n        // old name is what triggers its DeprecationWarning, so we take the new\n        // name and poll `isReady()` for older builds rather than listening.\n        const ready = new Promise<void>( resolve => {\n          let poll: ReturnType<typeof setInterval> | null = null\n          const done = (): void => { if( poll ) clearInterval( poll ); resolve() }\n          client.once('clientReady', done )\n          poll = setInterval( () => { if( client.isReady?.() ) done() }, 100 )\n          poll.unref?.()\n        } )\n        await client.login( opts.token ?? '')\n        await ready\n      }\n      log(`${ will.name } is present on Discord as user ${ client.user?.id }`)\n    },\n    async close(): Promise<void> {\n      if( closed ) return\n      closed = true\n      roster.flush()\n      await Promise.resolve( client.destroy() ).catch( () => {} )\n    },\n  }\n  return bridge\n}\n\n/** Build a real discord.js client (lazy import keeps it out of non-Discord hosts). */\nasync function createDiscordClient(): Promise<DiscordLikeClient> {\n  let mod: typeof import('discord.js')\n  try { mod = await import('discord.js') }\n  catch {\n    throw new Error('discord.js is not installed (it is an optionalDependency) — run `bun add discord.js` / `npm i discord.js` and retry.')\n  }\n  const { Client, GatewayIntentBits, Partials } = mod\n  return new Client( {\n    intents: [\n      GatewayIntentBits.Guilds,\n      GatewayIntentBits.GuildMessages,\n      GatewayIntentBits.MessageContent,\n      GatewayIntentBits.DirectMessages,\n    ],\n    partials: [ Partials.Channel ],   // DMs arrive on uncached channels\n  } ) as unknown as DiscordLikeClient\n}\n"]}
+{"version":3,"sources":["../../src/channels/roster.ts","../../src/channels/types.ts","../../src/channels/discord.ts"],"names":[],"mappings":"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","file":"discord.js","sourcesContent":["// ─────────────────────────────────────────────────────────────\n// src/channels/roster.ts — who the Will knows on a platform, and where\n// ─────────────────────────────────────────────────────────────\n//\n// The mind knows *entities*; a platform knows user ids and channels. The roster\n// is the durable seam between them: for each entity the Will has met on a\n// channel it records how to reach them again — so a *proactive* utterance\n// (`message.to` from the mind's own initiative) can find its person after a\n// restart, not just within one session.\n//\n// It persists as a small JSON file next to the PMA artifact. Writes are\n// throttled (the file is advisory routing state, not cognition — losing the\n// last few seconds costs a fallback delivery, never memory).\n// ─────────────────────────────────────────────────────────────\n\nimport { existsSync, readFileSync, mkdirSync, writeFileSync } from 'node:fs'\nimport { dirname } from 'node:path'\n\n/** How to reach one entity on the platform. */\nexport interface RosterEntry {\n  /** The mind-side entity id, e.g. 'discord:80351110224678912'. */\n  entityId: string\n  /** The platform-side user id. */\n  userId: string\n  /** Last display name seen (advisory — the *learned* name lives in the mind). */\n  displayName?: string\n  /** DM channel id, once one is known. */\n  dmChannelId?: string\n  /** Last shared (guild) channel this entity spoke in. */\n  lastChannelId?: string\n  /** Epoch ms of the last message seen from them. */\n  lastSeenAt: number\n}\n\nconst FLUSH_MS = 2_000\n\nexport class ChannelRoster {\n  private entries = new Map<string, RosterEntry>()\n  private dirty = false\n  private timer: ReturnType<typeof setTimeout> | null = null\n\n  constructor( private readonly path: string ) {\n    if( existsSync( path ) ){\n      try {\n        const raw = JSON.parse( readFileSync( path, 'utf8') ) as RosterEntry[]\n        for( const e of Array.isArray( raw ) ? raw : [] ) this.entries.set( e.entityId, e )\n      }\n      catch { /* a corrupt roster is not worth failing a boot over — start fresh */ }\n    }\n  }\n\n  /** Upsert what we just learned about an entity; schedules a throttled flush. */\n  record( update: { entityId: string; userId: string } & Partial<Omit<RosterEntry, 'entityId' | 'userId'>> ): RosterEntry {\n    const prev = this.entries.get( update.entityId )\n    const next: RosterEntry = {\n      lastSeenAt: Date.now(),\n      ...prev,\n      ...Object.fromEntries( Object.entries( update ).filter( ( [ , v ] ) => v !== undefined ) ) as typeof update,\n    }\n    this.entries.set( next.entityId, next )\n    this.dirty = true\n    if( !this.timer ){\n      this.timer = setTimeout( () => { this.timer = null; this.flush() }, FLUSH_MS )\n      this.timer.unref?.()\n    }\n    return next\n  }\n\n  resolve( entityId: string ): RosterEntry | undefined {\n    return this.entries.get( entityId )\n  }\n\n  all(): RosterEntry[] {\n    return [ ...this.entries.values() ]\n  }\n\n  /** Write to disk now (no-op when clean). Called by bridges on close. */\n  flush(): void {\n    if( !this.dirty ) return\n    try {\n      mkdirSync( dirname( this.path ), { recursive: true } )\n      writeFileSync( this.path, JSON.stringify( this.all(), null, 2 ) )\n      this.dirty = false\n    }\n    catch { /* advisory state — never take the mind down over it */ }\n  }\n}\n","// ─────────────────────────────────────────────────────────────\n// src/channels/types.ts — the channel-bridge contract\n// ─────────────────────────────────────────────────────────────\n//\n// A channel bridge puts a Will *in a place where people already are* (Discord,\n// Telegram, Slack, …). It is a host surface, not a cognition surface: it turns\n// platform messages into `perceive` stimuli and delivers the Will's projected\n// utterances back — nothing more. The paradigm survives the crossing:\n//\n//   • every platform user is an entity the Will comes to know (`from`),\n//     with a *learned* name (`speaker`) — never a placeholder;\n//   • every platform channel/DM is a conversation thread (`thread`);\n//   • the Will decides when to speak. Silence is a valid outcome, so a\n//     bridge never fabricates a reply and never times a message out into\n//     an error.\n//\n// Bridges live at the same altitude as the MCP/HTTP hosts (src/mcp, src/serve):\n// they wrap the SDK facade, not the stem.\n// ─────────────────────────────────────────────────────────────\n\n/** A running connection between one Will and one platform. */\nexport interface ChannelBridge {\n  /** Platform kind, e.g. 'discord'. */\n  readonly kind: string\n  /** Connect and start relaying. Resolves once the bridge is live. */\n  start(): Promise<void>\n  /** Disconnect and release resources. Idempotent. */\n  close(): Promise<void>\n}\n\n// ── Attachments ──────────────────────────────────────────────────────────────\n//\n// People hand over documents as well as speech, and some platforms *manufacture*\n// them: Discord silently turns a long pasted markdown block into a `.md` upload.\n// A bridge that reads only the text body sees such a message as empty and — worse\n// — as nothing at all, so the person appears to have gone silent.\n//\n// What a bridge does with these is deliberately modest. A named-but-unread file\n// is already a percept the Will can act on (\"what's in it?\"), which is the\n// paradigm-correct outcome and strictly better than silence. Inlining text is an\n// upgrade on top, never a precondition.\n\n/** One file riding along with a platform message. */\nexport interface ChannelAttachment {\n  name:         string\n  contentType?: string\n  size?:        number\n  url?:         string\n}\n\n/** Per-attachment inline budget. A 2 MB doc must not enter working memory whole. */\nconst INLINE_CHAR_CAP = 24_000\n/** How many text attachments to inline from one message. */\nconst INLINE_COUNT_CAP = 4\n\nconst TEXTUAL_EXT = /\\.(md|markdown|txt|text|json|jsonl|csv|tsv|ya?ml|log|ini|toml)$/i\n\n/** Is this something we can meaningfully read as text? */\nexport function isTextual( a: ChannelAttachment ): boolean {\n  const ct = a.contentType?.split(';')[0]?.trim().toLowerCase() ?? ''\n  if( ct.startsWith('text/') ) return true\n  if( ct === 'application/json' || ct === 'application/x-yaml' ) return true\n  // Discord's own markdown uploads arrive as text/plain, but trust the extension\n  // too — content types from platforms are advisory at best.\n  return TEXTUAL_EXT.test( a.name )\n}\n\nfunction humanSize( bytes?: number ): string {\n  if( bytes == null ) return ''\n  return bytes < 1024 ? `${ bytes } B`\n       : bytes < 1024 * 1024 ? `${ ( bytes / 1024 ).toFixed( 1 ) } KB`\n       : `${ ( bytes / 1024 / 1024 ).toFixed( 1 ) } MB`\n}\n\n/**\n * Render attachments into perceivable text.\n *\n * `fetchText` is supplied by the bridge, not by this module — the decision about\n * which hosts are safe to fetch from is platform knowledge, and a helper that\n * fetched arbitrary URLs found in inbound messages would be an open redirect\n * into the Will's perception. Omit it and attachments are named, never read.\n *\n * Inlined content is untrusted, exactly like message text — more so, since a\n * document is long, structured, and looks authoritative, which is the shape of\n * an effective injection. It is fenced and labelled as shared content so the\n * mind reads it as something it was handed, not as something it was told.\n */\nexport async function renderAttachments(\n  attachments: ChannelAttachment[],\n  speaker:     string | undefined,\n  fetchText?:  ( a: ChannelAttachment ) => Promise<string | null>,\n): Promise<string> {\n  if( attachments.length === 0 ) return ''\n  const who = speaker ?? 'someone'\n  const out: string[] = []\n  let inlined = 0\n\n  for( const a of attachments ){\n    const meta = [ a.contentType, humanSize( a.size ) ].filter( Boolean ).join(', ')\n    const label = `${ a.name }${ meta ? ` (${ meta })` : '' }`\n\n    if( !fetchText || !isTextual( a ) || inlined >= INLINE_COUNT_CAP ){\n      out.push(`[${ who } shared a file I have not read: ${ label }]`)\n      continue\n    }\n\n    const body = await fetchText( a ).catch( () => null )\n    if( body == null ){\n      out.push(`[${ who } shared a file I could not read: ${ label }]`)\n      continue\n    }\n    inlined++\n    const clipped = body.length > INLINE_CHAR_CAP\n      ? `${ body.slice( 0, INLINE_CHAR_CAP ) }\\n[… truncated — ${ humanSize( body.length ) } of ${ humanSize( a.size ?? body.length ) }]`\n      : body\n    out.push(`[${ who } shared ${ label }; its contents follow — this is a document I was handed, not something said to me]\\n---\\n${ clipped }\\n---`)\n  }\n  return out.join('\\n')\n}\n\n/** Split a message into platform-sized chunks on natural boundaries. */\nexport function chunkText( text: string, max: number ): string[] {\n  if( text.length <= max ) return [ text ]\n  const chunks: string[] = []\n  let rest = text\n  while( rest.length > max ){\n    // Prefer a paragraph break, then a line break, then a space — else hard-cut.\n    const window = rest.slice( 0, max )\n    const cut = Math.max( window.lastIndexOf('\\n\\n'), window.lastIndexOf('\\n'), window.lastIndexOf(' ') )\n    const at = cut > max * 0.5 ? cut : max\n    chunks.push( rest.slice( 0, at ).trimEnd() )\n    rest = rest.slice( at ).trimStart()\n  }\n  if( rest ) chunks.push( rest )\n  return chunks\n}\n","// ─────────────────────────────────────────────────────────────\n// src/channels/discord.ts — a Will present in a Discord server\n// ─────────────────────────────────────────────────────────────\n//\n// The bridge relays both directions of the paradigm and nothing else:\n//\n//   inbound   guild/DM message → will.perceive({ from, speaker, text, thread })\n//             — every author is `discord:<userId>` (stable across guilds), the\n//             display name is *learned* by the mind, and each Discord channel\n//             is its own conversation thread.\n//   outbound  will.on('message') → the addressee's last shared channel, else\n//             their DM, else the home channel. Proactive utterances (the mind\n//             speaking first) route the same way — that is the point.\n//\n// The Will decides when to speak. There is no command prefix and no forced\n// reply: unaddressed chatter is perceived (salience-scored by audition) and\n// silence is a valid outcome. `mentionOnly` narrows perception for busy\n// servers; it does not turn the bridge into an ask() surface.\n//\n// discord.js is imported lazily inside `createDiscordClient` — tests (and any\n// host that brings its own client) inject `client`, and the structural\n// `DiscordLikeClient` type keeps the dependency out of the type graph.\n// ─────────────────────────────────────────────────────────────\n\nimport type { Will, WillMessage } from '#sdk/will'\nimport { ChannelRoster } from '#channels/roster'\nimport { chunkText, renderAttachments, isTextual, type ChannelBridge, type ChannelAttachment } from '#channels/types'\n\nconst DISCORD_MESSAGE_LIMIT = 2000\n\n/**\n * The only hosts the bridge will fetch attachment bodies from.\n *\n * Deliberately an allowlist of Discord's own CDN. An inbound message is\n * untrusted input; following URLs it names would turn perception into an open\n * redirect, and a `url` field is no more trustworthy than the message text.\n */\nconst DISCORD_CDN_HOSTS = new Set( [ 'cdn.discordapp.com', 'media.discordapp.net' ] )\n\n/** Refuse to pull a large file into a percept — the cap in renderAttachments\n *  bounds what is *kept*, this bounds what is fetched at all. */\nconst MAX_FETCH_BYTES = 256 * 1024\n\n// ── The slice of discord.js the bridge actually uses (structural) ───────────\n\nexport interface DiscordLikeChannel {\n  send( content: string ): Promise<unknown>\n  sendTyping?(): Promise<unknown>\n}\n\nexport interface DiscordLikeAttachment {\n  name?:        string | null\n  contentType?: string | null\n  size?:        number\n  url?:         string\n}\n\nexport interface DiscordLikeMessage {\n  content: string\n  cleanContent?: string\n  channelId: string\n  guildId?: string | null\n  author: { id: string; bot?: boolean; username?: string; displayName?: string }\n  member?: { displayName?: string } | null\n  mentions?: { has( userId: string ): boolean }\n  channel: DiscordLikeChannel\n  /**\n   * Files riding with the message.\n   *\n   * discord.js hands us a `Collection`, which extends `Map` — so iterating it\n   * directly yields `[id, attachment]` PAIRS, not attachments. Typing this as a\n   * bare `Iterable` was wrong and silently produced `name: undefined` against\n   * the real client while passing every test, because the test fake injects an\n   * array. Both shapes are accepted now and normalised in `collectAttachments`.\n   */\n  attachments?: ReadonlyMap<string, DiscordLikeAttachment> | Iterable<DiscordLikeAttachment>\n}\n\nexport interface DiscordLikeClient {\n  user: { id: string; setPresence?( p: unknown ): void } | null\n  /** discord.js ≥14.22; polled so we needn't subscribe to the deprecated `ready`. */\n  isReady?(): boolean\n  on( event: 'messageCreate', fn: ( m: DiscordLikeMessage ) => void ): unknown\n  once( event: string, fn: () => void ): unknown\n  login( token: string ): Promise<unknown>\n  destroy(): Promise<unknown> | void\n  channels: { fetch( id: string ): Promise<unknown> }\n  users: { fetch( id: string ): Promise<{ send( content: string ): Promise<unknown> }> }\n}\n\n// ── Options ──────────────────────────────────────────────────────────────────\n\nexport interface DiscordBridgeOptions {\n  /** Bot token (Discord developer portal). Unused when `client` is injected pre-logged-in. */\n  token?: string\n  /**\n   * Channel ids the Will inhabits. Unset — or the single wildcard `'*'` — means\n   * every channel it can see, so adding it to a new channel in Discord is enough.\n   * A list restrains it to exactly those, and a message anywhere else is dropped\n   * at the bridge: the Will never perceives it and its silence there is not a choice.\n   */\n  channels?: readonly string[]\n  /**\n   * Where the Will only perceives guild messages that @mention it. DMs are always\n   * perceived either way.\n   *\n   *   `true`            — everywhere\n   *   `[ 'id', … ]`     — only in those channels; it listens openly elsewhere\n   *   omitted / `false` — nowhere\n   *\n   * The list form is what makes a wide-open roster usable: present in every channel,\n   * but a quiet participant in the busy ones.\n   */\n  mentionOnly?: boolean | readonly string[]\n  /** Fallback channel for utterances with no reachable addressee. */\n  homeChannelId?: string\n  /** Roster path (default: ./.will/<willId>.discord.json). */\n  rosterPath?: string\n  /**\n   * Read the contents of text-like attachments (.md, .txt, .json, …) into the\n   * percept, rather than only naming them. Default true.\n   *\n   * Only Discord's own CDN is ever fetched, and only up to a size cap. Set false\n   * for a bridge that should never pull remote bytes — the Will still perceives\n   * that a file arrived and can ask about it.\n   */\n  readAttachments?: boolean\n  /** Test / power-user seam: bring your own client; discord.js is never imported. */\n  client?: DiscordLikeClient\n  log?: ( msg: string ) => void\n}\n\n// ── The bridge ───────────────────────────────────────────────────────────────\n\n/**\n * Connect a Will to Discord. Resolves once the bridge is live (logged in and\n * relaying). Close it via the returned `ChannelBridge.close()` — the Will\n * itself is not stopped; it simply loses this surface.\n */\nexport async function connectDiscord( will: Will, opts: DiscordBridgeOptions ): Promise<ChannelBridge> {\n  const log     = opts.log ?? ( ( m: string ) => console.error(`[will:discord] ${ m }`) )\n  const roster  = new ChannelRoster( opts.rosterPath ?? `.will/${ will.id }.discord.json`)\n  // `null` = everywhere. An explicit '*' reads the same as omitting the list, so a\n  // host can say \"all channels\" out loud instead of by leaving a variable blank.\n  const allowed = opts.channels?.length && !opts.channels.includes('*')\n    ? new Set( opts.channels )\n    : null\n\n  // Mention-gating is either global (true) or scoped to named channels.\n  const mentionEverywhere = opts.mentionOnly === true\n  const mentionIn         = Array.isArray( opts.mentionOnly ) && opts.mentionOnly.length\n    ? new Set( opts.mentionOnly )\n    : null\n\n  const client = opts.client ?? await createDiscordClient()\n\n  /** The most recently active allowed channel — last-resort proactive target. */\n  let lastActiveChannelId: string | null = opts.homeChannelId ?? null\n\n  // ── inbound: platform message → stimulus ──────────────────────────────────\n  client.on('messageCreate', message => { void onMessage( message ) } )\n\n  async function onMessage( message: DiscordLikeMessage ): Promise<void> {\n    const self = client.user\n    if( !self || message.author.id === self.id || message.author.bot ) return\n\n    const isDM = !message.guildId\n    if( !isDM && allowed && !allowed.has( message.channelId ) ) return\n\n    const addressed = isDM || ( message.mentions?.has( self.id ) ?? false )\n    // DMs are addressed by definition, so this never gates them.\n    if( !addressed && ( mentionEverywhere || mentionIn?.has( message.channelId ) ) ) return\n\n    const entityId = `discord:${ message.author.id }`\n    const speaker  = message.member?.displayName ?? message.author.displayName ?? message.author.username\n\n    roster.record( {\n      entityId,\n      userId: message.author.id,\n      ...( speaker ? { displayName: speaker } : {} ),\n      ...( isDM ? { dmChannelId: message.channelId } : { lastChannelId: message.channelId } ),\n    } )\n    if( !isDM ) lastActiveChannelId = message.channelId\n\n    // Being addressed is the one moment a presence cue is honest — the mind\n    // may still choose silence, and typing expires on its own.\n    if( addressed ) await message.channel.sendTyping?.().catch( () => {} )\n\n    const said  = ( message.cleanContent || message.content ).trim()\n    const files = collectAttachments( message )\n\n    // An attachment-only message used to die here on the empty body: no percept,\n    // no log line, nothing. From the mind's side the person had simply gone\n    // quiet — and Discord *makes* these, turning a long pasted markdown block\n    // into a .md upload. Only a message with neither words nor files is nothing.\n    if( !said && files.length === 0 ) return\n\n    const shared = await renderAttachments(\n      files, speaker,\n      opts.readAttachments === false ? undefined : fetchAttachmentText,\n    )\n    const text = [ said, shared ].filter( Boolean ).join('\\n')\n\n    await will.perceive( {\n      text,\n      from:   entityId,\n      thread: `discord:${ message.channelId }`,\n      // `isDM` has been computed on every inbound since this bridge shipped and\n      // used only to pick a roster field. It is the one fact that makes a room\n      // the right or wrong place to say something, and the mind never saw it —\n      // which is how a follow-up promised in a DM went out to #general.\n      direct: isDM,\n      ...( speaker ? { speaker } : {} ),\n    } )\n  }\n\n  /**\n   * Normalise whatever the client gave us into attachments.\n   *\n   * `.values()` first: a discord.js Collection is a Map, so `for..of` over it\n   * yields `[id, attachment]` pairs and every field reads `undefined`. Arrays\n   * expose `.values()` too and yield their elements, so one branch covers the\n   * real client, a plain array, and a Map alike.\n   */\n  function collectAttachments( message: DiscordLikeMessage ): ChannelAttachment[] {\n    if( !message.attachments ) return []\n    const source = message.attachments as { values?: () => Iterable<DiscordLikeAttachment> }\n    const items: Iterable<DiscordLikeAttachment> = typeof source.values === 'function'\n      ? source.values()\n      : message.attachments as Iterable<DiscordLikeAttachment>\n\n    const out: ChannelAttachment[] = []\n    for( const a of items )\n      out.push( {\n        name: a.name ?? 'unnamed',\n        ...( a.contentType ? { contentType: a.contentType } : {} ),\n        ...( a.size != null ? { size: a.size } : {} ),\n        ...( a.url ? { url: a.url } : {} ),\n      } )\n    return out\n  }\n\n  /** Fetch one text attachment — Discord CDN only, size-capped. */\n  async function fetchAttachmentText( a: ChannelAttachment ): Promise<string | null> {\n    if( !a.url || !isTextual( a ) ) return null\n    let host: string\n    try { host = new URL( a.url ).hostname }\n    catch { return null }\n    if( !DISCORD_CDN_HOSTS.has( host ) ){\n      log(`refusing to fetch attachment '${ a.name }' from non-CDN host ${ host }`)\n      return null\n    }\n    if( a.size != null && a.size > MAX_FETCH_BYTES ){\n      log(`attachment '${ a.name }' is ${ a.size } bytes — naming it without reading`)\n      return null\n    }\n    const res = await fetch( a.url, { signal: AbortSignal.timeout( 10_000 ) } )\n    if( !res.ok ){\n      log(`attachment '${ a.name }' fetch failed: ${ res.status }`)\n      return null\n    }\n    return ( await res.text() ).slice( 0, MAX_FETCH_BYTES )\n  }\n\n  // ── outbound: projected utterance → the addressee ─────────────────────────\n  // The facade has no off(); the bridge gates its handler on `closed` instead.\n  let closed = false\n  will.on('message', ( m: WillMessage ) => { if( !closed ) void deliver( m ) } )\n\n  async function deliver( m: WillMessage ): Promise<void> {\n    const peer = m.to ? roster.resolve( m.to ) : undefined\n    const chunks = chunkText( m.content, DISCORD_MESSAGE_LIMIT )\n\n    // A reply goes back to the room it was said in. `m.thread` is the thread from\n    // the `perceive()` that prompted this — `discord:<channelId>` — so it is not a\n    // guess about where this person usually is, it is where they just spoke.\n    //\n    // Everything below it IS a guess, and the guesses were wrong in the way that\n    // matters most: a DM arrived, she answered it in seconds, and the answer went\n    // to the shared server channel because `lastChannelId` still held the last\n    // room they had been in together. She looked like she was ignoring him.\n    //\n    // Unprompted utterances carry no thread — nothing was said to them — so those\n    // still fall through to the roster, which is the right behaviour there.\n    const replyTo = m.thread?.startsWith('discord:') ? m.thread.slice('discord:'.length ) : undefined\n\n    // Preference order: the room they spoke in → where we last shared a room →\n    // their DM → home channel.\n    const channelIds = [ replyTo, peer?.lastChannelId, peer?.dmChannelId, opts.homeChannelId ?? undefined, lastActiveChannelId ?? undefined ]\n    for( const id of channelIds ){\n      if( !id ) continue\n      try {\n        const channel = await client.channels.fetch( id ) as DiscordLikeChannel | null\n        if( !channel?.send ) continue\n        for( const chunk of chunks ) await channel.send( chunk )\n        return\n      }\n      catch { /* try the next route */ }\n    }\n    if( peer ){\n      try {\n        const user = await client.users.fetch( peer.userId )\n        for( const chunk of chunks ) await user.send( chunk )\n        return\n      }\n      catch { /* fall through */ }\n    }\n    log(`no route for utterance to '${ m.to }' — dropped (${ m.content.length } chars)`)\n  }\n\n  // ── lifecycle ──────────────────────────────────────────────────────────────\n  const bridge: ChannelBridge = {\n    kind: 'discord',\n    async start(): Promise<void> {\n      if( !client.user ){\n        // discord.js ≥14.22 renamed `ready` → `clientReady`. Subscribing to the\n        // old name is what triggers its DeprecationWarning, so we take the new\n        // name and poll `isReady()` for older builds rather than listening.\n        const ready = new Promise<void>( resolve => {\n          let poll: ReturnType<typeof setInterval> | null = null\n          const done = (): void => { if( poll ) clearInterval( poll ); resolve() }\n          client.once('clientReady', done )\n          poll = setInterval( () => { if( client.isReady?.() ) done() }, 100 )\n          poll.unref?.()\n        } )\n        await client.login( opts.token ?? '')\n        await ready\n      }\n      log(`${ will.name } is present on Discord as user ${ client.user?.id }`)\n    },\n    async close(): Promise<void> {\n      if( closed ) return\n      closed = true\n      roster.flush()\n      await Promise.resolve( client.destroy() ).catch( () => {} )\n    },\n  }\n  return bridge\n}\n\n/** Build a real discord.js client (lazy import keeps it out of non-Discord hosts). */\nasync function createDiscordClient(): Promise<DiscordLikeClient> {\n  let mod: typeof import('discord.js')\n  try { mod = await import('discord.js') }\n  catch {\n    throw new Error('discord.js is not installed (it is an optionalDependency) — run `bun add discord.js` / `npm i discord.js` and retry.')\n  }\n  const { Client, GatewayIntentBits, Partials } = mod\n  return new Client( {\n    intents: [\n      GatewayIntentBits.Guilds,\n      GatewayIntentBits.GuildMessages,\n      GatewayIntentBits.MessageContent,\n      GatewayIntentBits.DirectMessages,\n    ],\n    partials: [ Partials.Channel ],   // DMs arrive on uncached channels\n  } ) as unknown as DiscordLikeClient\n}\n\n/**\n * Parse `WILL_DISCORD_MENTION_ONLY` into the `mentionOnly` option.\n *\n * Accepts a boolean OR a channel list, because \"only speak when spoken to\" is\n * rarely a whole-server property — it is how you stay present in a busy channel\n * without narrating in it.\n *\n *   `1` / `true` / `yes`   → true (everywhere)\n *   `0` / `false` / unset  → false (nowhere)\n *   `123,456`              → only those channels\n *\n * Exported so every host parses it identically; the CLI and any SDK host share\n * this rather than each re-deriving the syntax.\n */\nexport function parseMentionOnly( raw?: string ): boolean | string[] {\n  const v = raw?.trim()\n  if( !v ) return false\n  if( /^(1|true|yes)$/i.test( v ) ) return true\n  if( /^(0|false|no)$/i.test( v ) ) return false\n\n  const ids = v.split(',').map( s => s.trim() ).filter( Boolean )\n  return ids.length ? ids : false\n}\n\n/**\n * Parse `WILL_DISCORD_CHANNELS`. `*` (or unset/empty) means every channel the Will\n * can see — being added to a channel in Discord is then all it takes. Anything else\n * restrains it to exactly the ids listed.\n */\nexport function parseChannels( raw?: string ): string[] | undefined {\n  const ids = raw?.split(',').map( s => s.trim() ).filter( Boolean )\n  return ids?.length ? ids : undefined\n}\n"]}