@mindot/will 0.5.0 → 0.7.0

package/dist/channels/discord.d.ts

@@ -1,4 +1,4 @@
-import { W as Will } from '../will-BDq-TMQr.js';
+import { W as Will } from '../will-DAW0l-lY.js';
 import { C as ChannelBridge } from '../types-E9-HV-SW.js';
 
 interface DiscordLikeChannel {

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/** 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"]}

package/dist/channels/whatsapp.d.ts

@@ -1,4 +1,4 @@
-import { W as Will } from '../will-BDq-TMQr.js';
+import { W as Will } from '../will-DAW0l-lY.js';
 import { C as ChannelBridge } from '../types-E9-HV-SW.js';
 
 interface WaLikeMessage {

package/dist/channels/whatsapp.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/channels/roster.ts","../../src/channels/types.ts","../../src/channels/whatsapp.ts"],"names":["state"],"mappings":"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","file":"whatsapp.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/whatsapp.ts — a Will present on WhatsApp\n// ─────────────────────────────────────────────────────────────\n//\n// Same paradigm as the Discord bridge, different room:\n//\n//   inbound   DM / group message → will.perceive({ from, speaker, text, thread })\n//             — every author is `whatsapp:<number>` (stable across chats), the\n//             push name is *learned* by the mind, and each chat (DM or group)\n//             is its own conversation thread.\n//   outbound  will.on('message') → the addressee's last shared group, else\n//             their DM (a WhatsApp DM jid is derivable from the number — no\n//             roster miss is fatal), else the home chat.\n//\n// TRANSPORT — read before deploying. This bridge speaks the *linked-device*\n// protocol via Baileys: the Will pairs to a WhatsApp account by QR scan, like\n// WhatsApp Web. That is not a sanctioned bot API — WhatsApp's terms don't\n// allow automation on personal accounts, and accounts doing it can be banned.\n// Meta's sanctioned path (the Business Cloud API) needs a business account,\n// webhook hosting, and app review — no 2-minute pairing. Operator's choice;\n// docs/channels/whatsapp.md is explicit about the trade. Use a spare number.\n//\n// Baileys is imported lazily inside `createWhatsAppSocket` — tests (and hosts\n// that bring their own transport) inject `socket`, and the structural\n// `WaLikeSocket` 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\n/** WhatsApp's hard per-message cap. */\nconst WHATSAPP_MESSAGE_LIMIT = 65_536\n\n// ── The slice of a Baileys socket the bridge actually uses (structural) ──────\n\nexport interface WaLikeMessage {\n  key: {\n    remoteJid?: string | null\n    fromMe?: boolean | null\n    /** Sender jid inside a group (absent in DMs). */\n    participant?: string | null\n  }\n  /** Sender's display (\"push\") name. */\n  pushName?: string | null\n  messageStubType?: number | null\n  message?: {\n    conversation?: string | null\n    extendedTextMessage?: { text?: string | null; contextInfo?: { mentionedJid?: string[] | null } | null } | null\n    imageMessage?: { caption?: string | null } | null\n    videoMessage?: { caption?: string | null } | null\n  } | null\n}\n\nexport interface WaLikeSocket {\n  /** The paired account, once connected. id like '4915…:12@s.whatsapp.net'. */\n  user?: { id: string; name?: string } | null\n  ev: { on( event: 'messages.upsert', fn: ( u: { messages: WaLikeMessage[]; type?: string } ) => void ): unknown }\n  sendMessage( jid: string, content: { text: string } ): Promise<unknown>\n  sendPresenceUpdate?( state: 'composing' | 'paused', jid?: string ): Promise<unknown>\n  /** Tear the connection down (does not unlink the device). */\n  end?( err?: Error ): void\n}\n\n// ── Options ──────────────────────────────────────────────────────────────────\n\nexport interface WhatsAppBridgeOptions {\n  /** Chat jids the Will inhabits (groups `…@g.us`, DMs `…@s.whatsapp.net`). Unset = every chat. */\n  chats?: string[]\n  /** Perceive group messages only when the Will is @mentioned (DMs always perceived). */\n  mentionOnly?: boolean\n  /** Fallback chat jid for utterances with no reachable addressee. */\n  homeChatId?: string\n  /** Linked-device credentials dir (default: ./.will/<willId>.wa-auth). QR pairs on first run. */\n  authPath?: string\n  /** Roster path (default: ./.will/<willId>.whatsapp.json). */\n  rosterPath?: string\n  /** Test / power-user seam: bring your own socket; Baileys is never imported. */\n  socket?: WaLikeSocket\n  log?: ( msg: string ) => void\n}\n\n// ── Helpers ──────────────────────────────────────────────────────────────────\n\nconst isGroupJid = ( jid: string ): boolean => jid.endsWith( '@g.us' )\n\n/** '4915123:7@s.whatsapp.net' → '4915123' (device + server stripped). */\nconst bareId = ( jid: string ): string => jid.split( '@' )[0]!.split( ':' )[0]!\n\n/** A DM jid is derivable from the bare number — WhatsApp's gift to proactivity. */\nconst dmJidFor = ( userId: string ): string => `${ userId }@s.whatsapp.net`\n\nfunction textOf( m: WaLikeMessage ): string {\n  const msg = m.message\n  return msg?.conversation\n      ?? msg?.extendedTextMessage?.text\n      ?? msg?.imageMessage?.caption\n      ?? msg?.videoMessage?.caption\n      ?? ''\n}\n\n// ── The bridge ───────────────────────────────────────────────────────────────\n\n/**\n * Connect a Will to WhatsApp over the linked-device protocol. First run prints\n * a QR to pair (Settings → Linked devices → Link a device); credentials persist\n * in `authPath` so later runs reconnect silently. Close via the returned\n * `ChannelBridge.close()` — the Will keeps ticking; it only loses this surface.\n */\nexport async function connectWhatsApp( will: Will, opts: WhatsAppBridgeOptions = {} ): Promise<ChannelBridge> {\n  const log     = opts.log ?? ( ( m: string ) => console.error( `[will:whatsapp] ${ m }` ) )\n  const roster  = new ChannelRoster( opts.rosterPath ?? `.will/${ will.id }.whatsapp.json` )\n  const allowed = opts.chats?.length ? new Set( opts.chats ) : null\n\n  let closed = false\n  const socket = opts.socket ?? await createWhatsAppSocket( {\n    authPath: opts.authPath ?? `.will/${ will.id }.wa-auth`,\n    log,\n    stillOpen: () => !closed,\n  } )\n\n  /** The most recently active allowed chat — last-resort proactive target. */\n  let lastActiveChatId: string | null = opts.homeChatId ?? null\n\n  // ── inbound: platform message → stimulus ──────────────────────────────────\n  socket.ev.on( 'messages.upsert', ( { messages, type } ) => {\n    if( type && type !== 'notify' ) return   // history sync/corrections are not new percepts\n    for( const m of messages ) void onMessage( m )\n  } )\n\n  async function onMessage( m: WaLikeMessage ): Promise<void> {\n    const jid = m.key.remoteJid\n    if( !jid || m.key.fromMe || !m.message || m.messageStubType ) return\n    if( jid.endsWith( '@broadcast' ) || jid.endsWith( '@newsletter' ) ) return   // stories/broadcasts aren't a room the Will is in\n    if( allowed && !allowed.has( jid ) ) return\n\n    const isGroup   = isGroupJid( jid )\n    const senderJid = isGroup ? m.key.participant : jid\n    if( !senderJid ) return\n\n    const selfId    = socket.user ? bareId( socket.user.id ) : null\n    const mentioned = m.message.extendedTextMessage?.contextInfo?.mentionedJid ?? []\n    const addressed = !isGroup || ( selfId != null && mentioned.some( j => bareId( j ) === selfId ) )\n    if( opts.mentionOnly && !addressed ) return\n\n    const userId   = bareId( senderJid )\n    const entityId = `whatsapp:${ userId }`\n    const speaker  = m.pushName ?? undefined\n\n    roster.record( {\n      entityId,\n      userId,\n      ...( speaker ? { displayName: speaker } : {} ),\n      ...( isGroup ? { lastChannelId: jid } : { dmChannelId: jid } ),\n    } )\n    if( isGroup ) lastActiveChatId = jid\n\n    // Same rule as Discord: a presence cue only when addressed — the mind may\n    // still choose silence, and 'composing' expires on its own.\n    if( addressed ) await socket.sendPresenceUpdate?.( 'composing', jid ).catch( () => {} )\n\n    const text = textOf( m )\n    if( !text.trim() ) return\n\n    await will.perceive( {\n      text,\n      from:   entityId,\n      thread: `whatsapp:${ jid }`,\n      ...( speaker ? { speaker } : {} ),\n    } )\n  }\n\n  // ── outbound: projected utterance → the addressee ─────────────────────────\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, WHATSAPP_MESSAGE_LIMIT )\n\n    // Last shared group → known DM → DM derived from the entity id itself →\n    // home chat → last active chat. Unlike Discord, an unmet-but-addressed\n    // entity is still reachable: `whatsapp:<number>` implies its DM jid.\n    const derivedDm = m.to?.startsWith( 'whatsapp:' ) ? dmJidFor( m.to.slice( 'whatsapp:'.length ) ) : undefined\n    const targets = [ peer?.lastChannelId, peer?.dmChannelId, derivedDm, opts.homeChatId ?? undefined, lastActiveChatId ?? undefined ]\n    for( const jid of targets ){\n      if( !jid ) continue\n      try {\n        for( const chunk of chunks ) await socket.sendMessage( jid, { text: chunk } )\n        return\n      }\n      catch { /* try the next route */ }\n    }\n    log( `no route for utterance to '${ m.to }' — dropped (${ m.content.length } chars)` )\n  }\n\n  // ── lifecycle ──────────────────────────────────────────────────────────────\n  return {\n    kind: 'whatsapp',\n    async start(): Promise<void> {\n      // createWhatsAppSocket resolves already-open; an injected socket is the\n      // caller's to have readied.\n      log( `${ will.name } is present on WhatsApp${ socket.user ? ` as ${ bareId( socket.user.id ) }` : '' }` )\n    },\n    async close(): Promise<void> {\n      if( closed ) return\n      closed = true\n      roster.flush()\n      try { socket.end?.() } catch { /* already down */ }\n    },\n  }\n}\n\n// ── The real transport (Baileys, lazily imported) ────────────────────────────\n\ninterface SocketFactoryOpts {\n  authPath:  string\n  log:       ( msg: string ) => void\n  /** Reconnect only while the bridge is open. */\n  stillOpen: () => boolean\n}\n\n/**\n * A reconnect-stable facade over Baileys. Baileys' own pattern replaces the\n * socket object on every reconnect; the facade keeps one stable identity the\n * bridge can hold, re-attaching its subscribers to each inner incarnation.\n * Resolves once the first connection is open (after QR pairing on first run).\n */\nasync function createWhatsAppSocket( o: SocketFactoryOpts ): Promise<WaLikeSocket> {\n  let baileys: typeof import( 'baileys' )\n  try { baileys = await import( 'baileys' ) }\n  catch {\n    throw new Error( 'baileys is not installed (it is an optionalDependency) — run `bun add baileys` / `npm i baileys` and retry.' )\n  }\n  const { default: makeWASocket, useMultiFileAuthState, DisconnectReason } = baileys\n\n  // Baileys logs through pino at info by default — JSON noise all over the\n  // host's stderr. A minimal pino-shaped silent logger (child() returns\n  // itself, every level a no-op) is what it actually needs; hand-rolling it\n  // beats importing a transitive dep that may not resolve from dist/.\n  const noop = (): void => {}\n  const logger = {\n    level: 'silent',\n    child(){ return logger },\n    trace: noop, debug: noop, info: noop, warn: noop, error: noop, fatal: noop,\n  }\n\n  type Handler = ( u: { messages: WaLikeMessage[]; type?: string } ) => void\n  const subscribers: Handler[] = []\n  let inner: ReturnType<typeof makeWASocket> | null = null\n\n  const facade: WaLikeSocket = {\n    get user(){ return inner?.user ? { id: inner.user.id, name: inner.user.name ?? undefined } : null },\n    ev: { on: ( _e, fn ) => { subscribers.push( fn ) } },\n    sendMessage: ( jid, content ) => {\n      if( !inner ) return Promise.reject( new Error( 'whatsapp socket not connected' ) )\n      return inner.sendMessage( jid, content )\n    },\n    sendPresenceUpdate: ( state, jid ) => inner?.sendPresenceUpdate( state, jid ) ?? Promise.resolve(),\n    end: () => inner?.end( undefined ),\n  }\n\n  const { state, saveCreds } = await useMultiFileAuthState( o.authPath )\n\n  await new Promise<void>( ( resolveOpen, rejectOpen ) => {\n    let opened = false\n\n    function connect(): void {\n      const sock = makeWASocket( { auth: state, logger: logger as never } )\n      inner = sock\n\n      sock.ev.on( 'creds.update', saveCreds )\n      sock.ev.on( 'messages.upsert', u => { for( const fn of subscribers ) fn( u as never ) } )\n\n      sock.ev.on( 'connection.update', update => {\n        const { connection, lastDisconnect, qr } = update as {\n          connection?: string; lastDisconnect?: { error?: unknown }; qr?: string\n        }\n\n        if( qr ) void printQr( qr, o.log )\n\n        if( connection === 'open' && !opened ){\n          opened = true\n          resolveOpen()\n        }\n        if( connection === 'close' ){\n          const code = ( lastDisconnect?.error as { output?: { statusCode?: number } } | undefined )?.output?.statusCode\n          if( code === DisconnectReason.loggedOut ){\n            const err = new Error( 'WhatsApp unlinked this device (logged out) — delete the auth dir and pair again.' )\n            o.log( err.message )\n            if( !opened ) rejectOpen( err )\n            return\n          }\n          if( o.stillOpen() ){\n            o.log( `connection closed (status ${ code ?? '?' }) — reconnecting…` )\n            setTimeout( connect, 3_000 )\n          }\n        }\n      } )\n    }\n\n    connect()\n  } )\n\n  return facade\n}\n\n/** QR to the terminal; falls back to the raw pairing string if the tiny renderer is absent. */\nasync function printQr( qr: string, log: ( m: string ) => void ): Promise<void> {\n  log( 'pair this device: WhatsApp → Settings → Linked devices → Link a device' )\n  try {\n    type QrModule = { generate( s: string, o: { small: boolean } ): void }\n    const qrt = ( await import( 'qrcode-terminal' as string ) ) as QrModule & { default?: QrModule }\n    ;( qrt.default ?? qrt ).generate( qr, { small: true } )\n  }\n  catch {\n    log( `qrcode-terminal not installed — raw pairing code:\\n${ qr }` )\n  }\n}\n"]}
+{"version":3,"sources":["../../src/channels/roster.ts","../../src/channels/types.ts","../../src/channels/whatsapp.ts"],"names":["state"],"mappings":";;;;AAkCA,IAAM,QAAA,GAAW,GAAA;AAEV,IAAM,gBAAN,MAAoB;AAAA,EAKzB,YAA8B,IAAA,EAAe;AAAf,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAC5B,IAAA,IAAI,UAAA,CAAY,IAAK,CAAA,EAAG;AACtB,MAAA,IAAI;AACF,QAAA,MAAM,MAAM,IAAA,CAAK,KAAA,CAAO,YAAA,CAAc,IAAA,EAAM,MAAM,CAAE,CAAA;AACpD,QAAA,KAAA,MAAW,CAAA,IAAK,KAAA,CAAM,OAAA,CAAS,GAAI,CAAA,GAAI,GAAA,GAAM,EAAC,EAAI,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAK,CAAA,CAAE,UAAU,CAAE,CAAA;AAAA,MACpF,CAAA,CAAA,MACM;AAAA,MAAwE;AAAA,IAChF;AAAA,EACF;AAAA,EAR8B,IAAA;AAAA,EAJtB,OAAA,uBAAc,GAAA,EAAyB;AAAA,EACvC,KAAA,GAAQ,KAAA;AAAA,EACR,KAAA,GAA8C,IAAA;AAAA;AAAA,EAatD,OAAQ,MAAA,EAAgH;AACtH,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAK,OAAO,QAAS,CAAA;AAC/C,IAAA,MAAM,IAAA,GAAoB;AAAA,MACxB,UAAA,EAAY,KAAK,GAAA,EAAI;AAAA,MACrB,GAAG,IAAA;AAAA,MACH,GAAG,MAAA,CAAO,WAAA,CAAa,MAAA,CAAO,QAAS,MAAO,CAAA,CAAE,MAAA,CAAQ,CAAE,GAAI,CAAE,CAAA,KAAO,CAAA,KAAM,MAAU,CAAE;AAAA,KAC3F;AACA,IAAA,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAK,IAAA,CAAK,QAAA,EAAU,IAAK,CAAA;AACtC,IAAA,IAAA,CAAK,KAAA,GAAQ,IAAA;AACb,IAAA,IAAI,CAAC,KAAK,KAAA,EAAO;AACf,MAAA,IAAA,CAAK,KAAA,GAAQ,WAAY,MAAM;AAAE,QAAA,IAAA,CAAK,KAAA,GAAQ,IAAA;AAAM,QAAA,IAAA,CAAK,KAAA,EAAM;AAAA,MAAE,GAAG,QAAS,CAAA;AAC7E,MAAA,IAAA,CAAK,MAAM,KAAA,IAAQ;AAAA,IACrB;AACA,IAAA,OAAO,IAAA;AAAA,EACT;AAAA,EAEA,QAAS,QAAA,EAA4C;AACnD,IAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAK,QAAS,CAAA;AAAA,EACpC;AAAA,EAEA,GAAA,GAAqB;AACnB,IAAA,OAAO,CAAE,GAAG,IAAA,CAAK,OAAA,CAAQ,QAAS,CAAA;AAAA,EACpC;AAAA;AAAA,EAGA,KAAA,GAAc;AACZ,IAAA,IAAI,CAAC,KAAK,KAAA,EAAQ;AAClB,IAAA,IAAI;AACF,MAAA,SAAA,CAAW,QAAS,IAAA,CAAK,IAAK,GAAG,EAAE,SAAA,EAAW,MAAO,CAAA;AACrD,MAAA,aAAA,CAAe,IAAA,CAAK,MAAM,IAAA,CAAK,SAAA,CAAW,KAAK,GAAA,EAAI,EAAG,IAAA,EAAM,CAAE,CAAE,CAAA;AAChE,MAAA,IAAA,CAAK,KAAA,GAAQ,KAAA;AAAA,IACf,CAAA,CAAA,MACM;AAAA,IAA0D;AAAA,EAClE;AACF,CAAA;;;ACvDO,SAAS,SAAA,CAAW,MAAc,GAAA,EAAwB;AAC/D,EAAA,IAAI,IAAA,CAAK,MAAA,IAAU,GAAA,EAAM,OAAO,CAAE,IAAK,CAAA;AACvC,EAAA,MAAM,SAAmB,EAAC;AAC1B,EAAA,IAAI,IAAA,GAAO,IAAA;AACX,EAAA,OAAO,IAAA,CAAK,SAAS,GAAA,EAAK;AAExB,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,KAAA,CAAO,CAAA,EAAG,GAAI,CAAA;AAClC,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,GAAA,CAAK,MAAA,CAAO,YAAY,MAAM,CAAA,EAAG,MAAA,CAAO,WAAA,CAAY,IAAI,CAAA,EAAG,MAAA,CAAO,WAAA,CAAY,GAAG,CAAE,CAAA;AACpG,IAAA,MAAM,EAAA,GAAK,GAAA,GAAM,GAAA,GAAM,GAAA,GAAM,GAAA,GAAM,GAAA;AACnC,IAAA,MAAA,CAAO,KAAM,IAAA,CAAK,KAAA,CAAO,GAAG,EAAG,CAAA,CAAE,SAAU,CAAA;AAC3C,IAAA,IAAA,GAAO,IAAA,CAAK,KAAA,CAAO,EAAG,CAAA,CAAE,SAAA,EAAU;AAAA,EACpC;AACA,EAAA,IAAI,IAAA,EAAO,MAAA,CAAO,IAAA,CAAM,IAAK,CAAA;AAC7B,EAAA,OAAO,MAAA;AACT;;;ACbA,IAAM,sBAAA,GAAyB,KAAA;AAoD/B,IAAM,UAAA,GAAa,CAAE,GAAA,KAA0B,GAAA,CAAI,SAAS,OAAO,CAAA;AAGnE,IAAM,MAAA,GAAS,CAAE,GAAA,KAAyB,GAAA,CAAI,KAAA,CAAM,GAAG,CAAA,CAAE,CAAC,CAAA,CAAG,KAAA,CAAM,GAAG,CAAA,CAAE,CAAC,CAAA;AAGzE,IAAM,QAAA,GAAW,CAAE,MAAA,KAA4B,CAAA,EAAI,MAAO,CAAA,eAAA,CAAA;AAE1D,SAAS,OAAQ,CAAA,EAA2B;AAC1C,EAAA,MAAM,MAAM,CAAA,CAAE,OAAA;AACd,EAAA,OAAO,GAAA,EAAK,YAAA,IACL,GAAA,EAAK,mBAAA,EAAqB,IAAA,IAC1B,KAAK,YAAA,EAAc,OAAA,IACnB,GAAA,EAAK,YAAA,EAAc,OAAA,IACnB,EAAA;AACT;AAUA,eAAsB,eAAA,CAAiB,IAAA,EAAY,IAAA,GAA8B,EAAC,EAA4B;AAC5G,EAAA,MAAM,GAAA,GAAU,KAAK,GAAA,KAAS,CAAE,MAAe,OAAA,CAAQ,KAAA,CAAM,CAAA,gBAAA,EAAoB,CAAE,CAAA,CAAE,CAAA,CAAA;AACrF,EAAA,MAAM,MAAA,GAAU,IAAI,aAAA,CAAe,IAAA,CAAK,cAAc,CAAA,MAAA,EAAU,IAAA,CAAK,EAAG,CAAA,cAAA,CAAgB,CAAA;AACxF,EAAA,MAAM,OAAA,GAAU,KAAK,KAAA,EAAO,MAAA,GAAS,IAAI,GAAA,CAAK,IAAA,CAAK,KAAM,CAAA,GAAI,IAAA;AAE7D,EAAA,IAAI,MAAA,GAAS,KAAA;AACb,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,MAAA,IAAU,MAAM,oBAAA,CAAsB;AAAA,IACxD,QAAA,EAAU,IAAA,CAAK,QAAA,IAAY,CAAA,MAAA,EAAU,KAAK,EAAG,CAAA,QAAA,CAAA;AAAA,IAC7C,GAAA;AAAA,IACA,SAAA,EAAW,MAAM,CAAC;AAAA,GAClB,CAAA;AAGF,EAAA,IAAI,gBAAA,GAAkC,KAAK,UAAA,IAAc,IAAA;AAGzD,EAAA,MAAA,CAAO,GAAG,EAAA,CAAG,iBAAA,EAAmB,CAAE,EAAE,QAAA,EAAU,MAAK,KAAO;AACxD,IAAA,IAAI,IAAA,IAAQ,SAAS,QAAA,EAAU;AAC/B,IAAA,KAAA,MAAW,CAAA,IAAK,QAAA,EAAW,KAAK,SAAA,CAAW,CAAE,CAAA;AAAA,EAC/C,CAAE,CAAA;AAEF,EAAA,eAAe,UAAW,CAAA,EAAkC;AAC1D,IAAA,MAAM,GAAA,GAAM,EAAE,GAAA,CAAI,SAAA;AAClB,IAAA,IAAI,CAAC,OAAO,CAAA,CAAE,GAAA,CAAI,UAAU,CAAC,CAAA,CAAE,OAAA,IAAW,CAAA,CAAE,eAAA,EAAkB;AAC9D,IAAA,IAAI,IAAI,QAAA,CAAS,YAAY,KAAK,GAAA,CAAI,QAAA,CAAS,aAAa,CAAA,EAAI;AAChE,IAAA,IAAI,OAAA,IAAW,CAAC,OAAA,CAAQ,GAAA,CAAK,GAAI,CAAA,EAAI;AAErC,IAAA,MAAM,OAAA,GAAY,WAAY,GAAI,CAAA;AAClC,IAAA,MAAM,SAAA,GAAY,OAAA,GAAU,CAAA,CAAE,GAAA,CAAI,WAAA,GAAc,GAAA;AAChD,IAAA,IAAI,CAAC,SAAA,EAAY;AAEjB,IAAA,MAAM,SAAY,MAAA,CAAO,IAAA,GAAO,OAAQ,MAAA,CAAO,IAAA,CAAK,EAAG,CAAA,GAAI,IAAA;AAC3D,IAAA,MAAM,YAAY,CAAA,CAAE,OAAA,CAAQ,mBAAA,EAAqB,WAAA,EAAa,gBAAgB,EAAC;AAC/E,IAAA,MAAM,SAAA,GAAY,CAAC,OAAA,IAAa,MAAA,IAAU,IAAA,IAAQ,SAAA,CAAU,IAAA,CAAM,CAAA,CAAA,KAAK,MAAA,CAAQ,CAAE,CAAA,KAAM,MAAO,CAAA;AAC9F,IAAA,IAAI,IAAA,CAAK,WAAA,IAAe,CAAC,SAAA,EAAY;AAErC,IAAA,MAAM,MAAA,GAAW,OAAQ,SAAU,CAAA;AACnC,IAAA,MAAM,QAAA,GAAW,YAAa,MAAO,CAAA,CAAA;AACrC,IAAA,MAAM,OAAA,GAAW,EAAE,QAAA,IAAY,MAAA;AAE/B,IAAA,MAAA,CAAO,MAAA,CAAQ;AAAA,MACb,QAAA;AAAA,MACA,MAAA;AAAA,MACA,GAAK,OAAA,GAAU,EAAE,WAAA,EAAa,OAAA,KAAY,EAAC;AAAA,MAC3C,GAAK,UAAU,EAAE,aAAA,EAAe,KAAI,GAAI,EAAE,aAAa,GAAA;AAAI,KAC3D,CAAA;AACF,IAAA,IAAI,SAAU,gBAAA,GAAmB,GAAA;AAIjC,IAAA,IAAI,SAAA,QAAkB,MAAA,CAAO,kBAAA,GAAqB,aAAa,GAAI,CAAA,CAAE,MAAO,MAAM;AAAA,IAAC,CAAE,CAAA;AAErF,IAAA,MAAM,IAAA,GAAO,OAAQ,CAAE,CAAA;AACvB,IAAA,IAAI,CAAC,IAAA,CAAK,IAAA,EAAK,EAAI;AAEnB,IAAA,MAAM,KAAK,QAAA,CAAU;AAAA,MACnB,IAAA;AAAA,MACA,IAAA,EAAQ,QAAA;AAAA,MACR,MAAA,EAAQ,YAAa,GAAI,CAAA,CAAA;AAAA,MACzB,GAAK,OAAA,GAAU,EAAE,OAAA,KAAY;AAAC,KAC9B,CAAA;AAAA,EACJ;AAGA,EAAA,IAAA,CAAK,EAAA,CAAG,SAAA,EAAW,CAAE,CAAA,KAAoB;AAAE,IAAA,IAAI,CAAC,MAAA,EAAS,KAAK,OAAA,CAAS,CAAE,CAAA;AAAA,EAAE,CAAE,CAAA;AAE7E,EAAA,eAAe,QAAS,CAAA,EAAgC;AACtD,IAAA,MAAM,OAAS,CAAA,CAAE,EAAA,GAAK,OAAO,OAAA,CAAS,CAAA,CAAE,EAAG,CAAA,GAAI,MAAA;AAC/C,IAAA,MAAM,MAAA,GAAS,SAAA,CAAW,CAAA,CAAE,OAAA,EAAS,sBAAuB,CAAA;AAK5D,IAAA,MAAM,SAAA,GAAY,CAAA,CAAE,EAAA,EAAI,UAAA,CAAW,WAAW,CAAA,GAAI,QAAA,CAAU,CAAA,CAAE,EAAA,CAAG,KAAA,CAAM,WAAA,CAAY,MAAO,CAAE,CAAA,GAAI,MAAA;AAChG,IAAA,MAAM,OAAA,GAAU,CAAE,IAAA,EAAM,aAAA,EAAe,IAAA,EAAM,WAAA,EAAa,SAAA,EAAW,IAAA,CAAK,UAAA,IAAc,MAAA,EAAW,gBAAA,IAAoB,MAAU,CAAA;AACjI,IAAA,KAAA,MAAW,OAAO,OAAA,EAAS;AACzB,MAAA,IAAI,CAAC,GAAA,EAAM;AACX,MAAA,IAAI;AACF,QAAA,KAAA,MAAW,KAAA,IAAS,QAAS,MAAM,MAAA,CAAO,YAAa,GAAA,EAAK,EAAE,IAAA,EAAM,KAAA,EAAQ,CAAA;AAC5E,QAAA;AAAA,MACF,CAAA,CAAA,MACM;AAAA,MAA2B;AAAA,IACnC;AACA,IAAA,GAAA,CAAI,8BAA+B,CAAA,CAAE,EAAG,qBAAiB,CAAA,CAAE,OAAA,CAAQ,MAAO,CAAA,OAAA,CAAS,CAAA;AAAA,EACrF;AAGA,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,UAAA;AAAA,IACN,MAAM,KAAA,GAAuB;AAG3B,MAAA,GAAA,CAAI,CAAA,EAAI,IAAA,CAAK,IAAK,CAAA,uBAAA,EAA2B,OAAO,IAAA,GAAO,CAAA,IAAA,EAAQ,MAAA,CAAQ,MAAA,CAAO,IAAA,CAAK,EAAG,CAAE,CAAA,CAAA,GAAK,EAAG,CAAA,CAAE,CAAA;AAAA,IACxG,CAAA;AAAA,IACA,MAAM,KAAA,GAAuB;AAC3B,MAAA,IAAI,MAAA,EAAS;AACb,MAAA,MAAA,GAAS,IAAA;AACT,MAAA,MAAA,CAAO,KAAA,EAAM;AACb,MAAA,IAAI;AAAE,QAAA,MAAA,CAAO,GAAA,IAAM;AAAA,MAAE,CAAA,CAAA,MAAQ;AAAA,MAAqB;AAAA,IACpD;AAAA,GACF;AACF;AAiBA,eAAe,qBAAsB,CAAA,EAA8C;AACjF,EAAA,IAAI,OAAA;AACJ,EAAA,IAAI;AAAE,IAAA,OAAA,GAAU,MAAM,OAAO,SAAS,CAAA;AAAA,EAAE,CAAA,CAAA,MAClC;AACJ,IAAA,MAAM,IAAI,MAAM,kHAA6G,CAAA;AAAA,EAC/H;AACA,EAAA,MAAM,EAAE,OAAA,EAAS,YAAA,EAAc,qBAAA,EAAuB,kBAAiB,GAAI,OAAA;AAM3E,EAAA,MAAM,OAAO,MAAY;AAAA,EAAC,CAAA;AAC1B,EAAA,MAAM,MAAA,GAAS;AAAA,IACb,KAAA,EAAO,QAAA;AAAA,IACP,KAAA,GAAO;AAAE,MAAA,OAAO,MAAA;AAAA,IAAO,CAAA;AAAA,IACvB,KAAA,EAAO,IAAA;AAAA,IAAM,KAAA,EAAO,IAAA;AAAA,IAAM,IAAA,EAAM,IAAA;AAAA,IAAM,IAAA,EAAM,IAAA;AAAA,IAAM,KAAA,EAAO,IAAA;AAAA,IAAM,KAAA,EAAO;AAAA,GACxE;AAGA,EAAA,MAAM,cAAyB,EAAC;AAChC,EAAA,IAAI,KAAA,GAAgD,IAAA;AAEpD,EAAA,MAAM,MAAA,GAAuB;AAAA,IAC3B,IAAI,IAAA,GAAM;AAAE,MAAA,OAAO,KAAA,EAAO,IAAA,GAAO,EAAE,EAAA,EAAI,KAAA,CAAM,IAAA,CAAK,EAAA,EAAI,IAAA,EAAM,KAAA,CAAM,IAAA,CAAK,IAAA,IAAQ,MAAA,EAAU,GAAI,IAAA;AAAA,IAAK,CAAA;AAAA,IAClG,EAAA,EAAI,EAAE,EAAA,EAAI,CAAE,IAAI,EAAA,KAAQ;AAAE,MAAA,WAAA,CAAY,KAAM,EAAG,CAAA;AAAA,IAAE,CAAA,EAAE;AAAA,IACnD,WAAA,EAAa,CAAE,GAAA,EAAK,OAAA,KAAa;AAC/B,MAAA,IAAI,CAAC,OAAQ,OAAO,OAAA,CAAQ,OAAQ,IAAI,KAAA,CAAM,+BAA+B,CAAE,CAAA;AAC/E,MAAA,OAAO,KAAA,CAAM,WAAA,CAAa,GAAA,EAAK,OAAQ,CAAA;AAAA,IACzC,CAAA;AAAA,IACA,kBAAA,EAAoB,CAAEA,MAAAA,EAAO,GAAA,KAAS,KAAA,EAAO,mBAAoBA,MAAAA,EAAO,GAAI,CAAA,IAAK,OAAA,CAAQ,OAAA,EAAQ;AAAA,IACjG,GAAA,EAAK,MAAM,KAAA,EAAO,GAAA,CAAK,MAAU;AAAA,GACnC;AAEA,EAAA,MAAM,EAAE,KAAA,EAAO,SAAA,KAAc,MAAM,qBAAA,CAAuB,EAAE,QAAS,CAAA;AAErE,EAAA,MAAM,IAAI,OAAA,CAAe,CAAE,WAAA,EAAa,UAAA,KAAgB;AACtD,IAAA,IAAI,MAAA,GAAS,KAAA;AAEb,IAAA,SAAS,OAAA,GAAgB;AACvB,MAAA,MAAM,OAAO,YAAA,CAAc,EAAE,IAAA,EAAM,KAAA,EAAO,QAA0B,CAAA;AACpE,MAAA,KAAA,GAAQ,IAAA;AAER,MAAA,IAAA,CAAK,EAAA,CAAG,EAAA,CAAG,cAAA,EAAgB,SAAU,CAAA;AACrC,MAAA,IAAA,CAAK,EAAA,CAAG,EAAA,CAAG,iBAAA,EAAmB,CAAA,CAAA,KAAK;AAAE,QAAA,KAAA,MAAW,EAAA,IAAM,WAAA,EAAc,EAAA,CAAI,CAAW,CAAA;AAAA,MAAE,CAAE,CAAA;AAEvF,MAAA,IAAA,CAAK,EAAA,CAAG,EAAA,CAAG,mBAAA,EAAqB,CAAA,MAAA,KAAU;AACxC,QAAA,MAAM,EAAE,UAAA,EAAY,cAAA,EAAgB,EAAA,EAAG,GAAI,MAAA;AAI3C,QAAA,IAAI,EAAA,EAAK,KAAK,OAAA,CAAS,EAAA,EAAI,EAAE,GAAI,CAAA;AAEjC,QAAA,IAAI,UAAA,KAAe,MAAA,IAAU,CAAC,MAAA,EAAQ;AACpC,UAAA,MAAA,GAAS,IAAA;AACT,UAAA,WAAA,EAAY;AAAA,QACd;AACA,QAAA,IAAI,eAAe,OAAA,EAAQ;AACzB,UAAA,MAAM,IAAA,GAAS,cAAA,EAAgB,KAAA,EAA6D,MAAA,EAAQ,UAAA;AACpG,UAAA,IAAI,IAAA,KAAS,iBAAiB,SAAA,EAAW;AACvC,YAAA,MAAM,GAAA,GAAM,IAAI,KAAA,CAAM,uFAAkF,CAAA;AACxG,YAAA,CAAA,CAAE,GAAA,CAAK,IAAI,OAAQ,CAAA;AACnB,YAAA,IAAI,CAAC,MAAA,EAAS,UAAA,CAAY,GAAI,CAAA;AAC9B,YAAA;AAAA,UACF;AACA,UAAA,IAAI,CAAA,CAAE,WAAU,EAAG;AACjB,YAAA,CAAA,CAAE,GAAA,CAAI,CAAA,0BAAA,EAA8B,IAAA,IAAQ,GAAI,CAAA,2BAAA,CAAmB,CAAA;AACnE,YAAA,UAAA,CAAY,SAAS,GAAM,CAAA;AAAA,UAC7B;AAAA,QACF;AAAA,MACF,CAAE,CAAA;AAAA,IACJ;AAEA,IAAA,OAAA,EAAQ;AAAA,EACV,CAAE,CAAA;AAEF,EAAA,OAAO,MAAA;AACT;AAGA,eAAe,OAAA,CAAS,IAAY,GAAA,EAA4C;AAC9E,EAAA,GAAA,CAAI,uFAAwE,CAAA;AAC5E,EAAA,IAAI;AAEF,IAAA,MAAM,GAAA,GAAQ,MAAM,OAAO,iBAA4B,CAAA;AACtD,IAAA,CAAE,GAAA,CAAI,WAAW,GAAA,EAAM,QAAA,CAAU,IAAI,EAAE,KAAA,EAAO,MAAO,CAAA;AAAA,EACxD,CAAA,CAAA,MACM;AACJ,IAAA,GAAA,CAAI,CAAA;AAAA,EAAuD,EAAG,CAAA,CAAE,CAAA;AAAA,EAClE;AACF","file":"whatsapp.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/whatsapp.ts — a Will present on WhatsApp\n// ─────────────────────────────────────────────────────────────\n//\n// Same paradigm as the Discord bridge, different room:\n//\n//   inbound   DM / group message → will.perceive({ from, speaker, text, thread })\n//             — every author is `whatsapp:<number>` (stable across chats), the\n//             push name is *learned* by the mind, and each chat (DM or group)\n//             is its own conversation thread.\n//   outbound  will.on('message') → the addressee's last shared group, else\n//             their DM (a WhatsApp DM jid is derivable from the number — no\n//             roster miss is fatal), else the home chat.\n//\n// TRANSPORT — read before deploying. This bridge speaks the *linked-device*\n// protocol via Baileys: the Will pairs to a WhatsApp account by QR scan, like\n// WhatsApp Web. That is not a sanctioned bot API — WhatsApp's terms don't\n// allow automation on personal accounts, and accounts doing it can be banned.\n// Meta's sanctioned path (the Business Cloud API) needs a business account,\n// webhook hosting, and app review — no 2-minute pairing. Operator's choice;\n// docs/channels/whatsapp.md is explicit about the trade. Use a spare number.\n//\n// Baileys is imported lazily inside `createWhatsAppSocket` — tests (and hosts\n// that bring their own transport) inject `socket`, and the structural\n// `WaLikeSocket` 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\n/** WhatsApp's hard per-message cap. */\nconst WHATSAPP_MESSAGE_LIMIT = 65_536\n\n// ── The slice of a Baileys socket the bridge actually uses (structural) ──────\n\nexport interface WaLikeMessage {\n  key: {\n    remoteJid?: string | null\n    fromMe?: boolean | null\n    /** Sender jid inside a group (absent in DMs). */\n    participant?: string | null\n  }\n  /** Sender's display (\"push\") name. */\n  pushName?: string | null\n  messageStubType?: number | null\n  message?: {\n    conversation?: string | null\n    extendedTextMessage?: { text?: string | null; contextInfo?: { mentionedJid?: string[] | null } | null } | null\n    imageMessage?: { caption?: string | null } | null\n    videoMessage?: { caption?: string | null } | null\n  } | null\n}\n\nexport interface WaLikeSocket {\n  /** The paired account, once connected. id like '4915…:12@s.whatsapp.net'. */\n  user?: { id: string; name?: string } | null\n  ev: { on( event: 'messages.upsert', fn: ( u: { messages: WaLikeMessage[]; type?: string } ) => void ): unknown }\n  sendMessage( jid: string, content: { text: string } ): Promise<unknown>\n  sendPresenceUpdate?( state: 'composing' | 'paused', jid?: string ): Promise<unknown>\n  /** Tear the connection down (does not unlink the device). */\n  end?( err?: Error ): void\n}\n\n// ── Options ──────────────────────────────────────────────────────────────────\n\nexport interface WhatsAppBridgeOptions {\n  /** Chat jids the Will inhabits (groups `…@g.us`, DMs `…@s.whatsapp.net`). Unset = every chat. */\n  chats?: string[]\n  /** Perceive group messages only when the Will is @mentioned (DMs always perceived). */\n  mentionOnly?: boolean\n  /** Fallback chat jid for utterances with no reachable addressee. */\n  homeChatId?: string\n  /** Linked-device credentials dir (default: ./.will/<willId>.wa-auth). QR pairs on first run. */\n  authPath?: string\n  /** Roster path (default: ./.will/<willId>.whatsapp.json). */\n  rosterPath?: string\n  /** Test / power-user seam: bring your own socket; Baileys is never imported. */\n  socket?: WaLikeSocket\n  log?: ( msg: string ) => void\n}\n\n// ── Helpers ──────────────────────────────────────────────────────────────────\n\nconst isGroupJid = ( jid: string ): boolean => jid.endsWith('@g.us')\n\n/** '4915123:7@s.whatsapp.net' → '4915123' (device + server stripped). */\nconst bareId = ( jid: string ): string => jid.split('@')[0]!.split(':')[0]!\n\n/** A DM jid is derivable from the bare number — WhatsApp's gift to proactivity. */\nconst dmJidFor = ( userId: string ): string => `${ userId }@s.whatsapp.net`\n\nfunction textOf( m: WaLikeMessage ): string {\n  const msg = m.message\n  return msg?.conversation\n      ?? msg?.extendedTextMessage?.text\n      ?? msg?.imageMessage?.caption\n      ?? msg?.videoMessage?.caption\n      ?? ''\n}\n\n// ── The bridge ───────────────────────────────────────────────────────────────\n\n/**\n * Connect a Will to WhatsApp over the linked-device protocol. First run prints\n * a QR to pair (Settings → Linked devices → Link a device); credentials persist\n * in `authPath` so later runs reconnect silently. Close via the returned\n * `ChannelBridge.close()` — the Will keeps ticking; it only loses this surface.\n */\nexport async function connectWhatsApp( will: Will, opts: WhatsAppBridgeOptions = {} ): Promise<ChannelBridge> {\n  const log     = opts.log ?? ( ( m: string ) => console.error(`[will:whatsapp] ${ m }`) )\n  const roster  = new ChannelRoster( opts.rosterPath ?? `.will/${ will.id }.whatsapp.json`)\n  const allowed = opts.chats?.length ? new Set( opts.chats ) : null\n\n  let closed = false\n  const socket = opts.socket ?? await createWhatsAppSocket( {\n    authPath: opts.authPath ?? `.will/${ will.id }.wa-auth`,\n    log,\n    stillOpen: () => !closed,\n  } )\n\n  /** The most recently active allowed chat — last-resort proactive target. */\n  let lastActiveChatId: string | null = opts.homeChatId ?? null\n\n  // ── inbound: platform message → stimulus ──────────────────────────────────\n  socket.ev.on('messages.upsert', ( { messages, type } ) => {\n    if( type && type !== 'notify') return   // history sync/corrections are not new percepts\n    for( const m of messages ) void onMessage( m )\n  } )\n\n  async function onMessage( m: WaLikeMessage ): Promise<void> {\n    const jid = m.key.remoteJid\n    if( !jid || m.key.fromMe || !m.message || m.messageStubType ) return\n    if( jid.endsWith('@broadcast') || jid.endsWith('@newsletter') ) return   // stories/broadcasts aren't a room the Will is in\n    if( allowed && !allowed.has( jid ) ) return\n\n    const isGroup   = isGroupJid( jid )\n    const senderJid = isGroup ? m.key.participant : jid\n    if( !senderJid ) return\n\n    const selfId    = socket.user ? bareId( socket.user.id ) : null\n    const mentioned = m.message.extendedTextMessage?.contextInfo?.mentionedJid ?? []\n    const addressed = !isGroup || ( selfId != null && mentioned.some( j => bareId( j ) === selfId ) )\n    if( opts.mentionOnly && !addressed ) return\n\n    const userId   = bareId( senderJid )\n    const entityId = `whatsapp:${ userId }`\n    const speaker  = m.pushName ?? undefined\n\n    roster.record( {\n      entityId,\n      userId,\n      ...( speaker ? { displayName: speaker } : {} ),\n      ...( isGroup ? { lastChannelId: jid } : { dmChannelId: jid } ),\n    } )\n    if( isGroup ) lastActiveChatId = jid\n\n    // Same rule as Discord: a presence cue only when addressed — the mind may\n    // still choose silence, and 'composing' expires on its own.\n    if( addressed ) await socket.sendPresenceUpdate?.('composing', jid ).catch( () => {} )\n\n    const text = textOf( m )\n    if( !text.trim() ) return\n\n    await will.perceive( {\n      text,\n      from:   entityId,\n      thread: `whatsapp:${ jid }`,\n      ...( speaker ? { speaker } : {} ),\n    } )\n  }\n\n  // ── outbound: projected utterance → the addressee ─────────────────────────\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, WHATSAPP_MESSAGE_LIMIT )\n\n    // Last shared group → known DM → DM derived from the entity id itself →\n    // home chat → last active chat. Unlike Discord, an unmet-but-addressed\n    // entity is still reachable: `whatsapp:<number>` implies its DM jid.\n    const derivedDm = m.to?.startsWith('whatsapp:') ? dmJidFor( m.to.slice('whatsapp:'.length ) ) : undefined\n    const targets = [ peer?.lastChannelId, peer?.dmChannelId, derivedDm, opts.homeChatId ?? undefined, lastActiveChatId ?? undefined ]\n    for( const jid of targets ){\n      if( !jid ) continue\n      try {\n        for( const chunk of chunks ) await socket.sendMessage( jid, { text: chunk } )\n        return\n      }\n      catch { /* try the next route */ }\n    }\n    log(`no route for utterance to '${ m.to }' — dropped (${ m.content.length } chars)`)\n  }\n\n  // ── lifecycle ──────────────────────────────────────────────────────────────\n  return {\n    kind: 'whatsapp',\n    async start(): Promise<void> {\n      // createWhatsAppSocket resolves already-open; an injected socket is the\n      // caller's to have readied.\n      log(`${ will.name } is present on WhatsApp${ socket.user ? ` as ${ bareId( socket.user.id ) }` : '' }`)\n    },\n    async close(): Promise<void> {\n      if( closed ) return\n      closed = true\n      roster.flush()\n      try { socket.end?.() } catch { /* already down */ }\n    },\n  }\n}\n\n// ── The real transport (Baileys, lazily imported) ────────────────────────────\n\ninterface SocketFactoryOpts {\n  authPath:  string\n  log:       ( msg: string ) => void\n  /** Reconnect only while the bridge is open. */\n  stillOpen: () => boolean\n}\n\n/**\n * A reconnect-stable facade over Baileys. Baileys' own pattern replaces the\n * socket object on every reconnect; the facade keeps one stable identity the\n * bridge can hold, re-attaching its subscribers to each inner incarnation.\n * Resolves once the first connection is open (after QR pairing on first run).\n */\nasync function createWhatsAppSocket( o: SocketFactoryOpts ): Promise<WaLikeSocket> {\n  let baileys: typeof import('baileys')\n  try { baileys = await import('baileys') }\n  catch {\n    throw new Error('baileys is not installed (it is an optionalDependency) — run `bun add baileys` / `npm i baileys` and retry.')\n  }\n  const { default: makeWASocket, useMultiFileAuthState, DisconnectReason } = baileys\n\n  // Baileys logs through pino at info by default — JSON noise all over the\n  // host's stderr. A minimal pino-shaped silent logger (child() returns\n  // itself, every level a no-op) is what it actually needs; hand-rolling it\n  // beats importing a transitive dep that may not resolve from dist/.\n  const noop = (): void => {}\n  const logger = {\n    level: 'silent',\n    child(){ return logger },\n    trace: noop, debug: noop, info: noop, warn: noop, error: noop, fatal: noop,\n  }\n\n  type Handler = ( u: { messages: WaLikeMessage[]; type?: string } ) => void\n  const subscribers: Handler[] = []\n  let inner: ReturnType<typeof makeWASocket> | null = null\n\n  const facade: WaLikeSocket = {\n    get user(){ return inner?.user ? { id: inner.user.id, name: inner.user.name ?? undefined } : null },\n    ev: { on: ( _e, fn ) => { subscribers.push( fn ) } },\n    sendMessage: ( jid, content ) => {\n      if( !inner ) return Promise.reject( new Error('whatsapp socket not connected') )\n      return inner.sendMessage( jid, content )\n    },\n    sendPresenceUpdate: ( state, jid ) => inner?.sendPresenceUpdate( state, jid ) ?? Promise.resolve(),\n    end: () => inner?.end( undefined ),\n  }\n\n  const { state, saveCreds } = await useMultiFileAuthState( o.authPath )\n\n  await new Promise<void>( ( resolveOpen, rejectOpen ) => {\n    let opened = false\n\n    function connect(): void {\n      const sock = makeWASocket( { auth: state, logger: logger as never } )\n      inner = sock\n\n      sock.ev.on('creds.update', saveCreds )\n      sock.ev.on('messages.upsert', u => { for( const fn of subscribers ) fn( u as never ) } )\n\n      sock.ev.on('connection.update', update => {\n        const { connection, lastDisconnect, qr } = update as {\n          connection?: string; lastDisconnect?: { error?: unknown }; qr?: string\n        }\n\n        if( qr ) void printQr( qr, o.log )\n\n        if( connection === 'open' && !opened ){\n          opened = true\n          resolveOpen()\n        }\n        if( connection === 'close'){\n          const code = ( lastDisconnect?.error as { output?: { statusCode?: number } } | undefined )?.output?.statusCode\n          if( code === DisconnectReason.loggedOut ){\n            const err = new Error('WhatsApp unlinked this device (logged out) — delete the auth dir and pair again.')\n            o.log( err.message )\n            if( !opened ) rejectOpen( err )\n            return\n          }\n          if( o.stillOpen() ){\n            o.log(`connection closed (status ${ code ?? '?' }) — reconnecting…`)\n            setTimeout( connect, 3_000 )\n          }\n        }\n      } )\n    }\n\n    connect()\n  } )\n\n  return facade\n}\n\n/** QR to the terminal; falls back to the raw pairing string if the tiny renderer is absent. */\nasync function printQr( qr: string, log: ( m: string ) => void ): Promise<void> {\n  log('pair this device: WhatsApp → Settings → Linked devices → Link a device')\n  try {\n    type QrModule = { generate( s: string, o: { small: boolean } ): void }\n    const qrt = ( await import('qrcode-terminal' as string ) ) as QrModule & { default?: QrModule }\n    ;( qrt.default ?? qrt ).generate( qr, { small: true } )\n  }\n  catch {\n    log(`qrcode-terminal not installed — raw pairing code:\\n${ qr }`)\n  }\n}\n"]}