IRCv3 features

• BATCH — start/end line builders, reftag generator, batch-tag tracking
• CHATHISTORY — query parsing (BEFORE/AFTER/LATEST/AROUND/BETWEEN/TARGETS) + serialization
• MARKREAD (draft/read-marker) — query/set parsing + line builders
• MONITOR — subcommand parsing + numeric reply builders (730–734)
• Server-time, msgid, account, batch, label, +draft/reply, +typing — typed tag accessors

Convenience client (legacy)

The (sigil irc connection) module retains a high-level client convenience API with TLS, SASL, channel tracking, NickServ identify, and an event loop — backwards compatible with prior sigil-irc releases.

IRC over WebSocket

The sibling sigil-irc-websocket package provides (sigil irc websocket), composing the public sigil-websocket client API with the IRC message parser for browser/WASM use. It avoids adding a WebSocket dependency to the core sigil-irc package used by native/desktop IRC clients.

Usage

Client (high-level convenience)

(import (sigil irc)
        (sigil irc websocket))

(define conn (make-irc-connection
               server: "irc.libera.chat"
               port: 6697
               nick: "mybot"
               tls: #t))

(irc-on conn 'PRIVMSG
  (lambda (msg)
    (irc-privmsg conn (irc-message-target msg) "Hello!")))

(irc-connect conn)
(irc-join conn "#mychannel")
(irc-run conn)

Browser/WASM IRC over WebSocket

(import (sigil irc))

(define session
  (irc-ws-connect
    url: "wss://enclave.example/irc"
    nick: "web-client"))

(irc-ws-register session)
(irc-ws-privmsg session "#sigil" "hello")

(let ((msg (irc-ws-receive session)))
  (when (irc-message? msg)
    (display (irc-message-command msg))
    (newline)))

Server (consumer drives I/O)

(import (sigil irc message)
        (sigil irc cap-negotiation)
        (sigil irc capability)
        (sigil irc sasl)
        (sigil irc numerics))

;; Build per-connection state
(define cap (make-cap-server-state
              server-name: "enclave.example"
              supported: (list (make-cap CAP-SASL value: "PLAIN,EXTERNAL")
                               (make-cap CAP-MESSAGE-TAGS)
                               (make-cap CAP-SERVER-TIME)
                               (make-cap CAP-BATCH)
                               (make-cap CAP-LABELED-RESPONSE))))

(define sasl-state
  (make-sasl-server-state
    supported-mechanisms: (list SASL-PLAIN SASL-EXTERNAL)
    server-name: "enclave.example"
    verify: my-password-checker))

;; Inside your accept fiber, on each line:
(let* ((msg (parse-irc-message line))
       (cap-out (cap-server-advance cap msg client-nick: nick))
       (sasl-out (sasl-server-advance sasl-state msg client-prefix: nick)))
  (for-each write-line cap-out)
  (for-each write-line sasl-out))

Identity is per-server from day one

(import (sigil irc identity))

(define alice (make-irc-identity "alice" "enclave.example"))
(irc-identity->canonical alice)             ; => "[email protected]"
(irc-identity->display alice)               ; => "alice"  (default: nick only)
(irc-identity->display alice show-server?: #t)
                                             ; => "[email protected]"

This is a federation-readiness constraint: future CrafterNet sovereign-per-server federation hinges on identities being qualified from day one. Local-display helpers strip the suffix for UX; storage and protocol always use the canonical form.

Modules

Dependencies

• sigil-socket (TCP)
• sigil-tls (TLS for the convenience client)
• sigil-crypto v0.15.0+ (base64, HMAC, PBKDF2 — SCRAM needs the v0.15 SHA-256 byte primitives) The optional sigil-irc-websocket package also depends on:
• sigil-irc
• sigil-websocket

Building / testing

sigil deps install
sigil test

For development against unreleased sibling packages, use a dev-redirects.sgl and run sigil test --redirects ./dev-redirects.sgl.

License

BSD-3-Clause