From 4946a8b449a963cbe04c1719f88f07d95f692f29 Mon Sep 17 00:00:00 2001
From: qs3c <2749950753@qq.com>
Date: Wed, 4 Mar 2026 17:50:46 +0800
Subject: [PATCH 01/17] fix(openai_compat): clarify HTML response errors
---
pkg/providers/openai_compat/provider.go | 48 +++++++++++++++++++-
pkg/providers/openai_compat/provider_test.go | 21 +++++++++
2 files changed, 68 insertions(+), 1 deletion(-)
diff --git a/pkg/providers/openai_compat/provider.go b/pkg/providers/openai_compat/provider.go
index ff9109e96..621e34a89 100644
--- a/pkg/providers/openai_compat/provider.go
+++ b/pkg/providers/openai_compat/provider.go
@@ -192,7 +192,53 @@ func (p *Provider) Chat(
return nil, fmt.Errorf("API request failed:\n Status: %d\n Body: %s", resp.StatusCode, string(body))
}
- return parseResponse(body)
+ out, err := parseResponse(body)
+ if err != nil {
+ return nil, wrapResponseParseError(err, body, resp.Header.Get("Content-Type"), p.apiBase)
+ }
+
+ return out, nil
+}
+
+func wrapResponseParseError(err error, body []byte, contentType, apiBase string) error {
+ trimmedContentType := strings.TrimSpace(contentType)
+ if looksLikeHTML(body, trimmedContentType) {
+ contentTypeHint := ""
+ if trimmedContentType != "" {
+ contentTypeHint = fmt.Sprintf(" (content-type: %s)", trimmedContentType)
+ }
+ return fmt.Errorf(
+ "expected JSON response from %s/chat/completions, but received HTML%s; check api_base or proxy configuration. Response preview: %s",
+ apiBase,
+ contentTypeHint,
+ responsePreview(body, 160),
+ )
+ }
+ return err
+}
+
+func looksLikeHTML(body []byte, contentType string) bool {
+ contentType = strings.ToLower(strings.TrimSpace(contentType))
+ if strings.Contains(contentType, "text/html") || strings.Contains(contentType, "application/xhtml+xml") {
+ return true
+ }
+
+ trimmed := strings.ToLower(strings.TrimSpace(string(body)))
+ return strings.HasPrefix(trimmed, ""
+ }
+ if len(preview) <= max {
+ return preview
+ }
+ return preview[:max] + "..."
}
func parseResponse(body []byte) (*LLMResponse, error) {
diff --git a/pkg/providers/openai_compat/provider_test.go b/pkg/providers/openai_compat/provider_test.go
index 174bcf00d..244a20672 100644
--- a/pkg/providers/openai_compat/provider_test.go
+++ b/pkg/providers/openai_compat/provider_test.go
@@ -212,6 +212,27 @@ func TestProviderChat_HTTPError(t *testing.T) {
}
}
+func TestProviderChat_HTMLSuccessResponseReturnsHelpfulError(t *testing.T) {
+ server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+ w.Header().Set("Content-Type", "text/html; charset=utf-8")
+ w.WriteHeader(http.StatusOK)
+ _, _ = w.Write([]byte("
gateway login"))
+ }))
+ defer server.Close()
+
+ p := NewProvider("key", server.URL, "")
+ _, err := p.Chat(t.Context(), []Message{{Role: "user", Content: "hi"}}, nil, "gpt-4o", nil)
+ if err == nil {
+ t.Fatal("expected error, got nil")
+ }
+ if !strings.Contains(err.Error(), "received HTML") {
+ t.Fatalf("expected helpful HTML error, got %v", err)
+ }
+ if !strings.Contains(err.Error(), "check api_base or proxy configuration") {
+ t.Fatalf("expected configuration hint, got %v", err)
+ }
+}
+
func TestProviderChat_StripsMoonshotPrefixAndNormalizesKimiTemperature(t *testing.T) {
var requestBody map[string]any
From a305c0a4790d39590592f529a883386b9db83316 Mon Sep 17 00:00:00 2001
From: amagi <2749950753@qq.com>
Date: Wed, 4 Mar 2026 23:57:26 +0800
Subject: [PATCH 02/17] fix(openai_compat): avoid predeclared identifier in
preview
---
pkg/providers/openai_compat/provider.go | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/pkg/providers/openai_compat/provider.go b/pkg/providers/openai_compat/provider.go
index 621e34a89..e6ccbdefc 100644
--- a/pkg/providers/openai_compat/provider.go
+++ b/pkg/providers/openai_compat/provider.go
@@ -230,15 +230,15 @@ func looksLikeHTML(body []byte, contentType string) bool {
strings.HasPrefix(trimmed, ""
}
- if len(preview) <= max {
+ if len(preview) <= maxLen {
return preview
}
- return preview[:max] + "..."
+ return preview[:maxLen] + "..."
}
func parseResponse(body []byte) (*LLMResponse, error) {
From 40b7b6ee4b7643c060c8a3dd71fc474d0027658c Mon Sep 17 00:00:00 2001
From: Amir Mamaghani
Date: Thu, 5 Mar 2026 11:46:01 +0100
Subject: [PATCH 03/17] feat(channels): add IRC channel integration
Add IRC as a new channel for picoclaw, supporting server connections,
channel joins, DMs, mention-based group triggers, and IRCv3 typing
indicators. Uses ergochat/irc-go for connection management with SASL,
NickServ, and automatic reconnection support.
Closes #1137
---
cmd/picoclaw/internal/gateway/helpers.go | 1 +
config/config.example.json | 19 +++
go.mod | 1 +
go.sum | 2 +
pkg/channels/irc/handler.go | 140 ++++++++++++++++++
pkg/channels/irc/init.go | 16 ++
pkg/channels/irc/irc.go | 181 +++++++++++++++++++++++
pkg/channels/manager.go | 5 +
pkg/config/config.go | 17 +++
scripts/test-irc.sh | 56 +++++++
10 files changed, 438 insertions(+)
create mode 100644 pkg/channels/irc/handler.go
create mode 100644 pkg/channels/irc/init.go
create mode 100644 pkg/channels/irc/irc.go
create mode 100755 scripts/test-irc.sh
diff --git a/cmd/picoclaw/internal/gateway/helpers.go b/cmd/picoclaw/internal/gateway/helpers.go
index 174f5db62..86110653d 100644
--- a/cmd/picoclaw/internal/gateway/helpers.go
+++ b/cmd/picoclaw/internal/gateway/helpers.go
@@ -14,6 +14,7 @@ import (
"github.com/sipeed/picoclaw/pkg/bus"
"github.com/sipeed/picoclaw/pkg/channels"
_ "github.com/sipeed/picoclaw/pkg/channels/dingtalk"
+ _ "github.com/sipeed/picoclaw/pkg/channels/irc"
_ "github.com/sipeed/picoclaw/pkg/channels/discord"
_ "github.com/sipeed/picoclaw/pkg/channels/feishu"
_ "github.com/sipeed/picoclaw/pkg/channels/line"
diff --git a/config/config.example.json b/config/config.example.json
index ef1bf3eda..bd20ac535 100644
--- a/config/config.example.json
+++ b/config/config.example.json
@@ -164,6 +164,25 @@
"max_steps": 10,
"welcome_message": "Hello! I'm your AI assistant. How can I help you today?",
"reasoning_channel_id": ""
+ },
+ "irc": {
+ "enabled": false,
+ "server": "irc.libera.chat:6697",
+ "tls": true,
+ "nick": "mybot",
+ "password": "",
+ "nickserv_password": "",
+ "sasl_user": "",
+ "sasl_password": "",
+ "channels": ["#mychannel"],
+ "allow_from": [],
+ "group_trigger": {
+ "mention_only": true
+ },
+ "typing": {
+ "enabled": false
+ },
+ "reasoning_channel_id": ""
}
},
"providers": {
diff --git a/go.mod b/go.mod
index 238bd405c..0e8987bd7 100644
--- a/go.mod
+++ b/go.mod
@@ -36,6 +36,7 @@ require (
github.com/davecgh/go-spew v1.1.1 // indirect
github.com/dustin/go-humanize v1.0.1 // indirect
github.com/elliotchance/orderedmap/v3 v3.1.0 // indirect
+ github.com/ergochat/irc-go v0.5.0 // indirect
github.com/gdamore/encoding v1.0.1 // indirect
github.com/h2non/filetype v1.1.3 // indirect
github.com/inconshreveable/mousetrap v1.1.0 // indirect
diff --git a/go.sum b/go.sum
index 060594d06..be5d036a1 100644
--- a/go.sum
+++ b/go.sum
@@ -48,6 +48,8 @@ github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkp
github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto=
github.com/elliotchance/orderedmap/v3 v3.1.0 h1:j4DJ5ObEmMBt/lcwIecKcoRxIQUEnw0L804lXYDt/pg=
github.com/elliotchance/orderedmap/v3 v3.1.0/go.mod h1:G+Hc2RwaZvJMcS4JpGCOyViCnGeKf0bTYCGTO4uhjSo=
+github.com/ergochat/irc-go v0.5.0 h1:woQ1RS9YbfgqPgSpPBBQeczXGIGzR0aC7dEgk469fTw=
+github.com/ergochat/irc-go v0.5.0/go.mod h1:2vi7KNpIPWnReB5hmLpl92eMywQvuIeIIGdt/FQCph0=
github.com/fsnotify/fsnotify v1.4.7/go.mod h1:jwhsz4b93w/PPRr/qN1Yymfu8t87LnFCMoQvtojpjFo=
github.com/fsnotify/fsnotify v1.4.9/go.mod h1:znqG4EE+3YCdAaPaxE2ZRY/06pZUdp0tY4IgpuI1SZQ=
github.com/gdamore/encoding v1.0.1 h1:YzKZckdBL6jVt2Gc+5p82qhrGiqMdG/eNs6Wy0u3Uhw=
diff --git a/pkg/channels/irc/handler.go b/pkg/channels/irc/handler.go
new file mode 100644
index 000000000..ea9fbc85f
--- /dev/null
+++ b/pkg/channels/irc/handler.go
@@ -0,0 +1,140 @@
+package irc
+
+import (
+ "fmt"
+ "strings"
+ "time"
+
+ "github.com/ergochat/irc-go/ircevent"
+ "github.com/ergochat/irc-go/ircmsg"
+
+ "github.com/sipeed/picoclaw/pkg/bus"
+ "github.com/sipeed/picoclaw/pkg/identity"
+ "github.com/sipeed/picoclaw/pkg/logger"
+)
+
+// onConnect is called after a successful connection (and on reconnect).
+func (c *IRCChannel) onConnect(conn *ircevent.Connection) {
+ // NickServ auth (only if SASL is not configured)
+ if c.config.NickServPassword != "" && c.config.SASLUser == "" {
+ conn.Privmsg("NickServ", "IDENTIFY "+c.config.NickServPassword)
+ }
+
+ // Join configured channels
+ for _, ch := range c.config.Channels {
+ conn.Join(ch)
+ logger.InfoCF("irc", "Joined IRC channel", map[string]any{
+ "channel": ch,
+ })
+ }
+}
+
+// onPrivmsg handles incoming PRIVMSG events.
+func (c *IRCChannel) onPrivmsg(conn *ircevent.Connection, e ircmsg.Message) {
+ if len(e.Params) < 2 {
+ return
+ }
+
+ nick := e.Nick()
+ currentNick := conn.CurrentNick()
+
+ // Ignore own messages
+ if strings.EqualFold(nick, currentNick) {
+ return
+ }
+
+ target := e.Params[0] // channel name or bot's nick
+ content := e.Params[1] // message text
+
+ // Determine if this is a DM or channel message
+ isDM := !strings.HasPrefix(target, "#") && !strings.HasPrefix(target, "&")
+
+ var chatID string
+ var peer bus.Peer
+
+ if isDM {
+ chatID = nick
+ peer = bus.Peer{Kind: "direct", ID: nick}
+ } else {
+ chatID = target
+ peer = bus.Peer{Kind: "group", ID: target}
+ }
+
+ sender := bus.SenderInfo{
+ Platform: "irc",
+ PlatformID: nick,
+ CanonicalID: identity.BuildCanonicalID("irc", nick),
+ Username: nick,
+ DisplayName: nick,
+ }
+
+ if !c.IsAllowedSender(sender) {
+ return
+ }
+
+ // For channel messages, check group trigger (mention detection)
+ if !isDM {
+ isMentioned := isBotMentioned(content, currentNick)
+ if isMentioned {
+ content = stripBotMention(content, currentNick)
+ }
+ respond, cleaned := c.ShouldRespondInGroup(isMentioned, content)
+ if !respond {
+ return
+ }
+ content = cleaned
+ }
+
+ if strings.TrimSpace(content) == "" {
+ return
+ }
+
+ messageID := fmt.Sprintf("%s-%d", nick, time.Now().UnixNano())
+
+ metadata := map[string]string{
+ "platform": "irc",
+ "server": c.config.Server,
+ }
+ if !isDM {
+ metadata["channel"] = target
+ }
+
+ c.HandleMessage(c.ctx, peer, messageID, nick, chatID, content, nil, metadata, sender)
+}
+
+// isBotMentioned checks if the bot's nick appears in the message.
+func isBotMentioned(content, botNick string) bool {
+ lower := strings.ToLower(content)
+ lowerNick := strings.ToLower(botNick)
+
+ // "nick: " or "nick, " at start (most common IRC convention)
+ if strings.HasPrefix(lower, lowerNick+":") || strings.HasPrefix(lower, lowerNick+",") {
+ return true
+ }
+
+ // Word-boundary match anywhere in the message
+ idx := strings.Index(lower, lowerNick)
+ if idx < 0 {
+ return false
+ }
+ before := idx == 0 || !isAlphanumeric(lower[idx-1])
+ after := idx+len(lowerNick) >= len(lower) || !isAlphanumeric(lower[idx+len(lowerNick)])
+ return before && after
+}
+
+// stripBotMention removes "nick: " or "nick, " prefix from content.
+func stripBotMention(content, botNick string) string {
+ lower := strings.ToLower(content)
+ lowerNick := strings.ToLower(botNick)
+ for _, sep := range []string{":", ","} {
+ prefix := lowerNick + sep
+ if strings.HasPrefix(lower, prefix) {
+ return strings.TrimSpace(content[len(prefix):])
+ }
+ }
+ return content
+}
+
+func isAlphanumeric(b byte) bool {
+ return (b >= 'a' && b <= 'z') || (b >= 'A' && b <= 'Z') || (b >= '0' && b <= '9') || b == '_'
+}
diff --git a/pkg/channels/irc/init.go b/pkg/channels/irc/init.go
new file mode 100644
index 000000000..221d41b62
--- /dev/null
+++ b/pkg/channels/irc/init.go
@@ -0,0 +1,16 @@
+package irc
+
+import (
+ "github.com/sipeed/picoclaw/pkg/bus"
+ "github.com/sipeed/picoclaw/pkg/channels"
+ "github.com/sipeed/picoclaw/pkg/config"
+)
+
+func init() {
+ channels.RegisterFactory("irc", func(cfg *config.Config, b *bus.MessageBus) (channels.Channel, error) {
+ if !cfg.Channels.IRC.Enabled {
+ return nil, nil
+ }
+ return NewIRCChannel(cfg.Channels.IRC, b)
+ })
+}
diff --git a/pkg/channels/irc/irc.go b/pkg/channels/irc/irc.go
new file mode 100644
index 000000000..2d75f6aae
--- /dev/null
+++ b/pkg/channels/irc/irc.go
@@ -0,0 +1,181 @@
+package irc
+
+import (
+ "context"
+ "crypto/tls"
+ "fmt"
+ "strings"
+
+ "github.com/ergochat/irc-go/ircevent"
+ "github.com/ergochat/irc-go/ircmsg"
+
+ "github.com/sipeed/picoclaw/pkg/bus"
+ "github.com/sipeed/picoclaw/pkg/channels"
+ "github.com/sipeed/picoclaw/pkg/config"
+ "github.com/sipeed/picoclaw/pkg/logger"
+)
+
+// IRCChannel implements the Channel interface for IRC servers.
+type IRCChannel struct {
+ *channels.BaseChannel
+ config config.IRCConfig
+ conn *ircevent.Connection
+ ctx context.Context
+ cancel context.CancelFunc
+}
+
+// NewIRCChannel creates a new IRC channel.
+func NewIRCChannel(cfg config.IRCConfig, messageBus *bus.MessageBus) (*IRCChannel, error) {
+ if cfg.Server == "" {
+ return nil, fmt.Errorf("irc server is required")
+ }
+ if cfg.Nick == "" {
+ return nil, fmt.Errorf("irc nick is required")
+ }
+
+ base := channels.NewBaseChannel("irc", cfg, messageBus, cfg.AllowFrom,
+ channels.WithMaxMessageLength(400),
+ channels.WithGroupTrigger(cfg.GroupTrigger),
+ channels.WithReasoningChannelID(cfg.ReasoningChannelID),
+ )
+
+ return &IRCChannel{
+ BaseChannel: base,
+ config: cfg,
+ }, nil
+}
+
+// Start connects to the IRC server and begins listening.
+func (c *IRCChannel) Start(ctx context.Context) error {
+ logger.InfoC("irc", "Starting IRC channel")
+ c.ctx, c.cancel = context.WithCancel(ctx)
+
+ conn := &ircevent.Connection{
+ Server: c.config.Server,
+ Nick: c.config.Nick,
+ User: c.config.Nick,
+ RealName: c.config.Nick,
+ Password: c.config.Password,
+ UseTLS: c.config.TLS,
+ RequestCaps: []string{"server-time", "message-tags"},
+ QuitMessage: "Goodbye",
+ Debug: false,
+ Log: nil,
+ }
+
+ if c.config.TLS {
+ conn.TLSConfig = &tls.Config{
+ ServerName: extractHost(c.config.Server),
+ }
+ }
+
+ // SASL auth (takes priority over NickServ)
+ if c.config.SASLUser != "" && c.config.SASLPassword != "" {
+ conn.SASLLogin = c.config.SASLUser
+ conn.SASLPassword = c.config.SASLPassword
+ }
+
+ // Register event handlers
+ conn.AddConnectCallback(func(e ircmsg.Message) {
+ c.onConnect(conn)
+ })
+ conn.AddCallback("PRIVMSG", func(e ircmsg.Message) {
+ c.onPrivmsg(conn, e)
+ })
+
+ if err := conn.Connect(); err != nil {
+ return fmt.Errorf("irc connect failed: %w", err)
+ }
+
+ c.conn = conn
+
+ // ircevent.Connection.Loop() handles reconnection internally.
+ go conn.Loop()
+
+ c.SetRunning(true)
+ logger.InfoCF("irc", "IRC channel started", map[string]any{
+ "server": c.config.Server,
+ "nick": c.config.Nick,
+ })
+ return nil
+}
+
+// Stop disconnects from the IRC server.
+func (c *IRCChannel) Stop(ctx context.Context) error {
+ logger.InfoC("irc", "Stopping IRC channel")
+ c.SetRunning(false)
+
+ if c.conn != nil {
+ c.conn.Quit()
+ }
+ if c.cancel != nil {
+ c.cancel()
+ }
+
+ logger.InfoC("irc", "IRC channel stopped")
+ return nil
+}
+
+// Send sends a message to an IRC channel or user.
+func (c *IRCChannel) Send(ctx context.Context, msg bus.OutboundMessage) error {
+ if !c.IsRunning() {
+ return channels.ErrNotRunning
+ }
+
+ target := msg.ChatID
+ if target == "" {
+ return fmt.Errorf("chat ID is empty: %w", channels.ErrSendFailed)
+ }
+
+ if strings.TrimSpace(msg.Content) == "" {
+ return nil
+ }
+
+ // Send each line separately (IRC is line-oriented)
+ lines := strings.Split(msg.Content, "\n")
+ for _, line := range lines {
+ line = strings.TrimRight(line, "\r")
+ if line == "" {
+ continue
+ }
+ c.conn.Privmsg(target, line)
+ }
+
+ logger.DebugCF("irc", "Message sent", map[string]any{
+ "target": target,
+ "lines": len(lines),
+ })
+ return nil
+}
+
+// StartTyping implements channels.TypingCapable using IRCv3 +typing client tag.
+// Requires typing.enabled in config and server support for message-tags capability.
+func (c *IRCChannel) StartTyping(ctx context.Context, chatID string) (func(), error) {
+ noop := func() {}
+
+ if !c.config.Typing.Enabled || !c.IsRunning() || c.conn == nil {
+ return noop, nil
+ }
+
+ // Check if server supports message-tags (required for TAGMSG)
+ if _, ok := c.conn.AcknowledgedCaps()["message-tags"]; !ok {
+ return noop, nil
+ }
+
+ c.conn.SendWithTags(map[string]string{"+typing": "active"}, "TAGMSG", chatID)
+
+ return func() {
+ if c.IsRunning() && c.conn != nil {
+ c.conn.SendWithTags(map[string]string{"+typing": "done"}, "TAGMSG", chatID)
+ }
+ }, nil
+}
+
+// extractHost returns the hostname portion of a host:port string.
+func extractHost(server string) string {
+ host, _, found := strings.Cut(server, ":")
+ if found {
+ return host
+ }
+ return server
+}
diff --git a/pkg/channels/manager.go b/pkg/channels/manager.go
index fdd6d0c1f..2b1cf8e84 100644
--- a/pkg/channels/manager.go
+++ b/pkg/channels/manager.go
@@ -62,6 +62,7 @@ var channelRateConfig = map[string]float64{
"discord": 1,
"slack": 1,
"line": 10,
+ "irc": 2,
}
type channelWorker struct {
@@ -267,6 +268,10 @@ func (m *Manager) initChannels() error {
m.initChannel("pico", "Pico")
}
+ if m.config.Channels.IRC.Enabled && m.config.Channels.IRC.Server != "" {
+ m.initChannel("irc", "IRC")
+ }
+
logger.InfoCF("channels", "Channel initialization completed", map[string]any{
"enabled_channels": len(m.channels),
})
diff --git a/pkg/config/config.go b/pkg/config/config.go
index 0ee3acfe0..00a69c28a 100644
--- a/pkg/config/config.go
+++ b/pkg/config/config.go
@@ -218,6 +218,7 @@ type ChannelsConfig struct {
WeComApp WeComAppConfig `json:"wecom_app"`
WeComAIBot WeComAIBotConfig `json:"wecom_aibot"`
Pico PicoConfig `json:"pico"`
+ IRC IRCConfig `json:"irc"`
}
// GroupTriggerConfig controls when the bot responds in group chats.
@@ -401,6 +402,22 @@ type PicoConfig struct {
Placeholder PlaceholderConfig `json:"placeholder,omitempty"`
}
+type IRCConfig struct {
+ Enabled bool `json:"enabled" env:"PICOCLAW_CHANNELS_IRC_ENABLED"`
+ Server string `json:"server" env:"PICOCLAW_CHANNELS_IRC_SERVER"`
+ TLS bool `json:"tls" env:"PICOCLAW_CHANNELS_IRC_TLS"`
+ Nick string `json:"nick" env:"PICOCLAW_CHANNELS_IRC_NICK"`
+ Password string `json:"password" env:"PICOCLAW_CHANNELS_IRC_PASSWORD"`
+ NickServPassword string `json:"nickserv_password" env:"PICOCLAW_CHANNELS_IRC_NICKSERV_PASSWORD"`
+ SASLUser string `json:"sasl_user" env:"PICOCLAW_CHANNELS_IRC_SASL_USER"`
+ SASLPassword string `json:"sasl_password" env:"PICOCLAW_CHANNELS_IRC_SASL_PASSWORD"`
+ Channels FlexibleStringSlice `json:"channels" env:"PICOCLAW_CHANNELS_IRC_CHANNELS"`
+ AllowFrom FlexibleStringSlice `json:"allow_from" env:"PICOCLAW_CHANNELS_IRC_ALLOW_FROM"`
+ GroupTrigger GroupTriggerConfig `json:"group_trigger,omitempty"`
+ Typing TypingConfig `json:"typing,omitempty"`
+ ReasoningChannelID string `json:"reasoning_channel_id" env:"PICOCLAW_CHANNELS_IRC_REASONING_CHANNEL_ID"`
+}
+
type HeartbeatConfig struct {
Enabled bool `json:"enabled" env:"PICOCLAW_HEARTBEAT_ENABLED"`
Interval int `json:"interval" env:"PICOCLAW_HEARTBEAT_INTERVAL"` // minutes, min 5
diff --git a/scripts/test-irc.sh b/scripts/test-irc.sh
new file mode 100755
index 000000000..40db01756
--- /dev/null
+++ b/scripts/test-irc.sh
@@ -0,0 +1,56 @@
+#!/bin/sh
+# Starts a local Ergo IRC server for testing the IRC channel.
+#
+# Requirements: docker
+# Usage: ./scripts/test-irc.sh
+
+set -e
+
+CONTAINER_NAME="picoclaw-test-ergo"
+IRC_PORT=6667
+
+# Clean up any previous instance
+docker rm -f "$CONTAINER_NAME" >/dev/null 2>&1 || true
+
+echo "Starting Ergo IRC server on port $IRC_PORT..."
+docker run -d \
+ --name "$CONTAINER_NAME" \
+ -p "$IRC_PORT:6667" \
+ ghcr.io/ergochat/ergo:stable
+
+for i in $(seq 1 10); do
+ if nc -z localhost "$IRC_PORT" 2>/dev/null; then
+ break
+ fi
+ if [ "$i" -eq 10 ]; then
+ echo "ERROR: Server did not start within 10s"
+ exit 1
+ fi
+ sleep 1
+done
+
+echo ""
+echo "IRC server ready on localhost:$IRC_PORT"
+echo ""
+echo "Add this to your ~/.picoclaw/config.json under \"channels\":"
+echo ""
+echo ' "irc": {'
+echo ' "enabled": true,'
+echo ' "server": "localhost:6667",'
+echo ' "tls": false,'
+echo ' "nick": "picobot",'
+echo ' "channels": ["#test"],'
+echo ' "allow_from": [],'
+echo ' "group_trigger": { "mention_only": true }'
+echo ' }'
+echo ""
+echo "Then run picoclaw:"
+echo " cd packages/picoclaw && go run ./cmd/picoclaw gateway"
+echo ""
+echo "Connect with an IRC client:"
+echo " irssi: /connect localhost $IRC_PORT"
+echo " weechat: /server add test localhost/$IRC_PORT && /connect test"
+echo " Join #test, then: picobot: hello"
+echo ""
+echo "To stop the IRC server:"
+echo " docker rm -f $CONTAINER_NAME"
From 9216cd14b5a7bc39b92eb94011cddb4386834f83 Mon Sep 17 00:00:00 2001
From: qs3c <2749950753@qq.com>
Date: Thu, 5 Mar 2026 19:42:58 +0800
Subject: [PATCH 04/17] fix(openai_compat): handle html error bodies and reduce
allocations
---
pkg/providers/openai_compat/provider.go | 72 ++++++++++++++------
pkg/providers/openai_compat/provider_test.go | 32 +++++++++
2 files changed, 85 insertions(+), 19 deletions(-)
diff --git a/pkg/providers/openai_compat/provider.go b/pkg/providers/openai_compat/provider.go
index e6ccbdefc..0422f0eb4 100644
--- a/pkg/providers/openai_compat/provider.go
+++ b/pkg/providers/openai_compat/provider.go
@@ -4,6 +4,7 @@ import (
"bytes"
"context"
"encoding/json"
+ "errors"
"fmt"
"io"
"log"
@@ -189,7 +190,7 @@ func (p *Provider) Chat(
}
if resp.StatusCode != http.StatusOK {
- return nil, fmt.Errorf("API request failed:\n Status: %d\n Body: %s", resp.StatusCode, string(body))
+ return nil, wrapHTTPResponseError(resp.StatusCode, body, resp.Header.Get("Content-Type"), p.apiBase)
}
out, err := parseResponse(body)
@@ -201,44 +202,77 @@ func (p *Provider) Chat(
}
func wrapResponseParseError(err error, body []byte, contentType, apiBase string) error {
- trimmedContentType := strings.TrimSpace(contentType)
- if looksLikeHTML(body, trimmedContentType) {
- contentTypeHint := ""
- if trimmedContentType != "" {
- contentTypeHint = fmt.Sprintf(" (content-type: %s)", trimmedContentType)
- }
- return fmt.Errorf(
- "expected JSON response from %s/chat/completions, but received HTML%s; check api_base or proxy configuration. Response preview: %s",
- apiBase,
- contentTypeHint,
- responsePreview(body, 160),
- )
+ if message, ok := htmlResponseMessage(body, contentType, apiBase); ok {
+ return errors.New(message)
}
return err
}
+func wrapHTTPResponseError(statusCode int, body []byte, contentType, apiBase string) error {
+ if message, ok := htmlResponseMessage(body, contentType, apiBase); ok {
+ return fmt.Errorf("API request failed:\n Status: %d\n Detail: %s", statusCode, message)
+ }
+ return fmt.Errorf("API request failed:\n Status: %d\n Body: %s", statusCode, string(body))
+}
+
+func htmlResponseMessage(body []byte, contentType, apiBase string) (string, bool) {
+ trimmedContentType := strings.TrimSpace(contentType)
+ if !looksLikeHTML(body, trimmedContentType) {
+ return "", false
+ }
+
+ contentTypeHint := ""
+ if trimmedContentType != "" {
+ contentTypeHint = fmt.Sprintf(" (content-type: %s)", trimmedContentType)
+ }
+
+ return fmt.Sprintf(
+ "expected JSON response from %s/chat/completions, but received HTML%s; check api_base or proxy configuration. Response preview: %s",
+ apiBase,
+ contentTypeHint,
+ responsePreview(body, 160),
+ ), true
+}
+
func looksLikeHTML(body []byte, contentType string) bool {
contentType = strings.ToLower(strings.TrimSpace(contentType))
if strings.Contains(contentType, "text/html") || strings.Contains(contentType, "application/xhtml+xml") {
return true
}
- trimmed := strings.ToLower(strings.TrimSpace(string(body)))
+ trimmed := strings.ToLower(string(leadingTrimmedPrefix(body, 128)))
return strings.HasPrefix(trimmed, " len(body) {
+ end = len(body)
+ }
+ return body[i:end]
+ }
+ }
+ return nil
+}
+
func responsePreview(body []byte, maxLen int) string {
- preview := strings.TrimSpace(string(body))
- if preview == "" {
+ trimmed := bytes.TrimSpace(body)
+ if len(trimmed) == 0 {
return ""
}
- if len(preview) <= maxLen {
- return preview
+ if len(trimmed) <= maxLen {
+ return string(trimmed)
}
- return preview[:maxLen] + "..."
+ return string(trimmed[:maxLen]) + "..."
}
func parseResponse(body []byte) (*LLMResponse, error) {
diff --git a/pkg/providers/openai_compat/provider_test.go b/pkg/providers/openai_compat/provider_test.go
index 244a20672..899d10c8d 100644
--- a/pkg/providers/openai_compat/provider_test.go
+++ b/pkg/providers/openai_compat/provider_test.go
@@ -1,6 +1,7 @@
package openai_compat
import (
+ "bytes"
"encoding/json"
"net/http"
"net/http/httptest"
@@ -233,6 +234,37 @@ func TestProviderChat_HTMLSuccessResponseReturnsHelpfulError(t *testing.T) {
}
}
+func TestProviderChat_HTMLErrorResponseReturnsHelpfulError(t *testing.T) {
+ server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+ w.Header().Set("Content-Type", "text/html; charset=utf-8")
+ w.WriteHeader(http.StatusBadGateway)
+ _, _ = w.Write([]byte("bad gateway"))
+ }))
+ defer server.Close()
+
+ p := NewProvider("key", server.URL, "")
+ _, err := p.Chat(t.Context(), []Message{{Role: "user", Content: "hi"}}, nil, "gpt-4o", nil)
+ if err == nil {
+ t.Fatal("expected error, got nil")
+ }
+ if !strings.Contains(err.Error(), "Status: 502") {
+ t.Fatalf("expected status code in error, got %v", err)
+ }
+ if !strings.Contains(err.Error(), "received HTML") {
+ t.Fatalf("expected helpful HTML error, got %v", err)
+ }
+ if !strings.Contains(err.Error(), "check api_base or proxy configuration") {
+ t.Fatalf("expected configuration hint, got %v", err)
+ }
+}
+
+func TestLooksLikeHTML_SniffsPrefixWithLargeBody(t *testing.T) {
+ body := append([]byte(" \r\n\tx"), bytes.Repeat([]byte("A"), 1024*1024)...)
+ if !looksLikeHTML(body, "") {
+ t.Fatal("expected looksLikeHTML to detect html prefix")
+ }
+}
+
func TestProviderChat_StripsMoonshotPrefixAndNormalizesKimiTemperature(t *testing.T) {
var requestBody map[string]any
From 968fff07b9254e3f8b402a92cdeb8f23b65f2786 Mon Sep 17 00:00:00 2001
From: Boris Bliznioukov
Date: Thu, 5 Mar 2026 13:07:17 +0100
Subject: [PATCH 05/17] fix: background task results silently dropped
Signed-off-by: Boris Bliznioukov
---
pkg/agent/loop.go | 53 ++++++++++++++++++++++++++-------
pkg/tools/spawn_test.go | 4 +--
pkg/tools/subagent.go | 18 -----------
pkg/tools/subagent_tool_test.go | 23 ++++++--------
4 files changed, 53 insertions(+), 45 deletions(-)
diff --git a/pkg/agent/loop.go b/pkg/agent/loop.go
index 1ab79f3ca..82dca9d30 100644
--- a/pkg/agent/loop.go
+++ b/pkg/agent/loop.go
@@ -192,7 +192,7 @@ func registerSharedTools(
// Spawn tool with allowlist checker
if cfg.Tools.IsToolEnabled("spawn") {
if cfg.Tools.IsToolEnabled("subagent") {
- subagentManager := tools.NewSubagentManager(provider, agent.Model, agent.Workspace, msgBus)
+ subagentManager := tools.NewSubagentManager(provider, agent.Model, agent.Workspace)
subagentManager.SetLLMOptions(agent.MaxTokens, agent.Temperature)
spawnTool := tools.NewSpawnTool(subagentManager)
currentAgentID := agentID
@@ -671,10 +671,9 @@ func (al *AgentLoop) runAgentLoop(
agent *AgentInstance,
opts processOptions,
) (string, error) {
- // 0. Record last channel for heartbeat notifications (skip internal channels)
+ // 0. Record last channel for heartbeat notifications (skip internal channels and cli)
if opts.Channel != "" && opts.ChatID != "" {
- // Don't record internal channels (cli, system, subagent)
- if !constants.IsInternalChannel(opts.Channel) {
+ if !constants.IsInternalChannel(opts.Channel) && opts.Channel != "cli" {
channelKey := fmt.Sprintf("%s:%s", opts.Channel, opts.ChatID)
if err := al.RecordLastChannel(channelKey); err != nil {
logger.WarnCF(
@@ -1083,15 +1082,47 @@ func (al *AgentLoop) runLLMIteration(
"iteration": iteration,
})
- // Create async callback for tools that implement AsyncExecutor
- asyncCallback := func(callbackCtx context.Context, result *tools.ToolResult) {
+ // Create async callback for tools that implement AsyncExecutor.
+ // When the background work completes, this publishes the result
+ // as an inbound system message so processSystemMessage routes it
+ // back to the user via the normal agent loop.
+ asyncCallback := func(_ context.Context, result *tools.ToolResult) {
+ // Send ForUser content directly to the user (immediate feedback),
+ // mirroring the synchronous tool execution path.
if !result.Silent && result.ForUser != "" {
- logger.InfoCF("agent", "Async tool completed, agent will handle notification",
- map[string]any{
- "tool": tc.Name,
- "content_len": len(result.ForUser),
- })
+ outCtx, outCancel := context.WithTimeout(context.Background(), 5*time.Second)
+ defer outCancel()
+ _ = al.bus.PublishOutbound(outCtx, bus.OutboundMessage{
+ Channel: opts.Channel,
+ ChatID: opts.ChatID,
+ Content: result.ForUser,
+ })
}
+
+ // Determine content for the agent loop (ForLLM or error).
+ content := result.ForLLM
+ if content == "" && result.Err != nil {
+ content = result.Err.Error()
+ }
+ if content == "" {
+ return
+ }
+
+ logger.InfoCF("agent", "Async tool completed, publishing result",
+ map[string]any{
+ "tool": tc.Name,
+ "content_len": len(content),
+ "channel": opts.Channel,
+ })
+
+ pubCtx, pubCancel := context.WithTimeout(context.Background(), 5*time.Second)
+ defer pubCancel()
+ _ = al.bus.PublishInbound(pubCtx, bus.InboundMessage{
+ Channel: "system",
+ SenderID: fmt.Sprintf("async:%s", tc.Name),
+ ChatID: fmt.Sprintf("%s:%s", opts.Channel, opts.ChatID),
+ Content: content,
+ })
}
toolResult := agent.Tools.ExecuteWithContext(
diff --git a/pkg/tools/spawn_test.go b/pkg/tools/spawn_test.go
index 0646c82a9..43223b8db 100644
--- a/pkg/tools/spawn_test.go
+++ b/pkg/tools/spawn_test.go
@@ -8,7 +8,7 @@ import (
func TestSpawnTool_Execute_EmptyTask(t *testing.T) {
provider := &MockLLMProvider{}
- manager := NewSubagentManager(provider, "test-model", "/tmp/test", nil)
+ manager := NewSubagentManager(provider, "test-model", "/tmp/test")
tool := NewSpawnTool(manager)
ctx := context.Background()
@@ -42,7 +42,7 @@ func TestSpawnTool_Execute_EmptyTask(t *testing.T) {
func TestSpawnTool_Execute_ValidTask(t *testing.T) {
provider := &MockLLMProvider{}
- manager := NewSubagentManager(provider, "test-model", "/tmp/test", nil)
+ manager := NewSubagentManager(provider, "test-model", "/tmp/test")
tool := NewSpawnTool(manager)
ctx := context.Background()
diff --git a/pkg/tools/subagent.go b/pkg/tools/subagent.go
index 429340047..e51cbaafa 100644
--- a/pkg/tools/subagent.go
+++ b/pkg/tools/subagent.go
@@ -6,7 +6,6 @@ import (
"sync"
"time"
- "github.com/sipeed/picoclaw/pkg/bus"
"github.com/sipeed/picoclaw/pkg/providers"
)
@@ -27,7 +26,6 @@ type SubagentManager struct {
mu sync.RWMutex
provider providers.LLMProvider
defaultModel string
- bus *bus.MessageBus
workspace string
tools *ToolRegistry
maxIterations int
@@ -41,13 +39,11 @@ type SubagentManager struct {
func NewSubagentManager(
provider providers.LLMProvider,
defaultModel, workspace string,
- bus *bus.MessageBus,
) *SubagentManager {
return &SubagentManager{
tasks: make(map[string]*SubagentTask),
provider: provider,
defaultModel: defaultModel,
- bus: bus,
workspace: workspace,
tools: NewToolRegistry(),
maxIterations: 10,
@@ -214,20 +210,6 @@ After completing the task, provide a clear summary of what was done.`
Async: false,
}
}
-
- // Send announce message back to main agent
- if sm.bus != nil {
- announceContent := fmt.Sprintf("Task '%s' completed.\n\nResult:\n%s", task.Label, task.Result)
- pubCtx, pubCancel := context.WithTimeout(context.Background(), 5*time.Second)
- defer pubCancel()
- sm.bus.PublishInbound(pubCtx, bus.InboundMessage{
- Channel: "system",
- SenderID: fmt.Sprintf("subagent:%s", task.ID),
- // Format: "original_channel:original_chat_id" for routing back
- ChatID: fmt.Sprintf("%s:%s", task.OriginChannel, task.OriginChatID),
- Content: announceContent,
- })
- }
}
func (sm *SubagentManager) GetTask(taskID string) (*SubagentTask, bool) {
diff --git a/pkg/tools/subagent_tool_test.go b/pkg/tools/subagent_tool_test.go
index a1450410a..4b6f130a5 100644
--- a/pkg/tools/subagent_tool_test.go
+++ b/pkg/tools/subagent_tool_test.go
@@ -5,7 +5,6 @@ import (
"strings"
"testing"
- "github.com/sipeed/picoclaw/pkg/bus"
"github.com/sipeed/picoclaw/pkg/providers"
)
@@ -47,7 +46,7 @@ func (m *MockLLMProvider) GetContextWindow() int {
func TestSubagentManager_SetLLMOptions_AppliesToRunToolLoop(t *testing.T) {
provider := &MockLLMProvider{}
- manager := NewSubagentManager(provider, "test-model", "/tmp/test", nil)
+ manager := NewSubagentManager(provider, "test-model", "/tmp/test")
manager.SetLLMOptions(2048, 0.6)
tool := NewSubagentTool(manager)
@@ -73,7 +72,7 @@ func TestSubagentManager_SetLLMOptions_AppliesToRunToolLoop(t *testing.T) {
// TestSubagentTool_Name verifies tool name
func TestSubagentTool_Name(t *testing.T) {
provider := &MockLLMProvider{}
- manager := NewSubagentManager(provider, "test-model", "/tmp/test", nil)
+ manager := NewSubagentManager(provider, "test-model", "/tmp/test")
tool := NewSubagentTool(manager)
if tool.Name() != "subagent" {
@@ -84,7 +83,7 @@ func TestSubagentTool_Name(t *testing.T) {
// TestSubagentTool_Description verifies tool description
func TestSubagentTool_Description(t *testing.T) {
provider := &MockLLMProvider{}
- manager := NewSubagentManager(provider, "test-model", "/tmp/test", nil)
+ manager := NewSubagentManager(provider, "test-model", "/tmp/test")
tool := NewSubagentTool(manager)
desc := tool.Description()
@@ -99,7 +98,7 @@ func TestSubagentTool_Description(t *testing.T) {
// TestSubagentTool_Parameters verifies tool parameters schema
func TestSubagentTool_Parameters(t *testing.T) {
provider := &MockLLMProvider{}
- manager := NewSubagentManager(provider, "test-model", "/tmp/test", nil)
+ manager := NewSubagentManager(provider, "test-model", "/tmp/test")
tool := NewSubagentTool(manager)
params := tool.Parameters()
@@ -149,8 +148,7 @@ func TestSubagentTool_Parameters(t *testing.T) {
// TestSubagentTool_Execute_Success tests successful execution
func TestSubagentTool_Execute_Success(t *testing.T) {
provider := &MockLLMProvider{}
- msgBus := bus.NewMessageBus()
- manager := NewSubagentManager(provider, "test-model", "/tmp/test", msgBus)
+ manager := NewSubagentManager(provider, "test-model", "/tmp/test")
tool := NewSubagentTool(manager)
ctx := WithToolContext(context.Background(), "telegram", "chat-123")
@@ -204,8 +202,7 @@ func TestSubagentTool_Execute_Success(t *testing.T) {
// TestSubagentTool_Execute_NoLabel tests execution without label
func TestSubagentTool_Execute_NoLabel(t *testing.T) {
provider := &MockLLMProvider{}
- msgBus := bus.NewMessageBus()
- manager := NewSubagentManager(provider, "test-model", "/tmp/test", msgBus)
+ manager := NewSubagentManager(provider, "test-model", "/tmp/test")
tool := NewSubagentTool(manager)
ctx := context.Background()
@@ -228,7 +225,7 @@ func TestSubagentTool_Execute_NoLabel(t *testing.T) {
// TestSubagentTool_Execute_MissingTask tests error handling for missing task
func TestSubagentTool_Execute_MissingTask(t *testing.T) {
provider := &MockLLMProvider{}
- manager := NewSubagentManager(provider, "test-model", "/tmp/test", nil)
+ manager := NewSubagentManager(provider, "test-model", "/tmp/test")
tool := NewSubagentTool(manager)
ctx := context.Background()
@@ -278,8 +275,7 @@ func TestSubagentTool_Execute_NilManager(t *testing.T) {
// TestSubagentTool_Execute_ContextPassing verifies context is properly used
func TestSubagentTool_Execute_ContextPassing(t *testing.T) {
provider := &MockLLMProvider{}
- msgBus := bus.NewMessageBus()
- manager := NewSubagentManager(provider, "test-model", "/tmp/test", msgBus)
+ manager := NewSubagentManager(provider, "test-model", "/tmp/test")
tool := NewSubagentTool(manager)
channel := "test-channel"
@@ -304,8 +300,7 @@ func TestSubagentTool_Execute_ContextPassing(t *testing.T) {
func TestSubagentTool_ForUserTruncation(t *testing.T) {
// Create a mock provider that returns very long content
provider := &MockLLMProvider{}
- msgBus := bus.NewMessageBus()
- manager := NewSubagentManager(provider, "test-model", "/tmp/test", msgBus)
+ manager := NewSubagentManager(provider, "test-model", "/tmp/test")
tool := NewSubagentTool(manager)
ctx := context.Background()
From 00ad6be7ea993fd7d45c4f9de7d89da72d095a59 Mon Sep 17 00:00:00 2001
From: Boris Bliznioukov
Date: Thu, 5 Mar 2026 13:30:24 +0100
Subject: [PATCH 06/17] Update pkg/agent/loop.go
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
pkg/agent/loop.go | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/pkg/agent/loop.go b/pkg/agent/loop.go
index 82dca9d30..c8936fe2b 100644
--- a/pkg/agent/loop.go
+++ b/pkg/agent/loop.go
@@ -673,7 +673,7 @@ func (al *AgentLoop) runAgentLoop(
) (string, error) {
// 0. Record last channel for heartbeat notifications (skip internal channels and cli)
if opts.Channel != "" && opts.ChatID != "" {
- if !constants.IsInternalChannel(opts.Channel) && opts.Channel != "cli" {
+ if !constants.IsInternalChannel(opts.Channel) {
channelKey := fmt.Sprintf("%s:%s", opts.Channel, opts.ChatID)
if err := al.RecordLastChannel(channelKey); err != nil {
logger.WarnCF(
From 1604582a411419812c1c9552081b588318443ff2 Mon Sep 17 00:00:00 2001
From: Amir Mamaghani
Date: Thu, 5 Mar 2026 16:03:10 +0100
Subject: [PATCH 07/17] fix: resolve gci lint errors in IRC channel files
Sort irc import alphabetically in helpers.go and fix struct field
alignment in irc.go to satisfy golangci-lint gci formatter.
Co-Authored-By: Claude Opus 4.6
---
cmd/picoclaw/internal/gateway/helpers.go | 2 +-
pkg/channels/irc/irc.go | 20 ++++++++++----------
2 files changed, 11 insertions(+), 11 deletions(-)
diff --git a/cmd/picoclaw/internal/gateway/helpers.go b/cmd/picoclaw/internal/gateway/helpers.go
index 86110653d..00b53e62c 100644
--- a/cmd/picoclaw/internal/gateway/helpers.go
+++ b/cmd/picoclaw/internal/gateway/helpers.go
@@ -14,9 +14,9 @@ import (
"github.com/sipeed/picoclaw/pkg/bus"
"github.com/sipeed/picoclaw/pkg/channels"
_ "github.com/sipeed/picoclaw/pkg/channels/dingtalk"
- _ "github.com/sipeed/picoclaw/pkg/channels/irc"
_ "github.com/sipeed/picoclaw/pkg/channels/discord"
_ "github.com/sipeed/picoclaw/pkg/channels/feishu"
+ _ "github.com/sipeed/picoclaw/pkg/channels/irc"
_ "github.com/sipeed/picoclaw/pkg/channels/line"
_ "github.com/sipeed/picoclaw/pkg/channels/maixcam"
_ "github.com/sipeed/picoclaw/pkg/channels/onebot"
diff --git a/pkg/channels/irc/irc.go b/pkg/channels/irc/irc.go
index 2d75f6aae..b0c4874e1 100644
--- a/pkg/channels/irc/irc.go
+++ b/pkg/channels/irc/irc.go
@@ -51,16 +51,16 @@ func (c *IRCChannel) Start(ctx context.Context) error {
c.ctx, c.cancel = context.WithCancel(ctx)
conn := &ircevent.Connection{
- Server: c.config.Server,
- Nick: c.config.Nick,
- User: c.config.Nick,
- RealName: c.config.Nick,
- Password: c.config.Password,
- UseTLS: c.config.TLS,
- RequestCaps: []string{"server-time", "message-tags"},
- QuitMessage: "Goodbye",
- Debug: false,
- Log: nil,
+ Server: c.config.Server,
+ Nick: c.config.Nick,
+ User: c.config.Nick,
+ RealName: c.config.Nick,
+ Password: c.config.Password,
+ UseTLS: c.config.TLS,
+ RequestCaps: []string{"server-time", "message-tags"},
+ QuitMessage: "Goodbye",
+ Debug: false,
+ Log: nil,
}
if c.config.TLS {
From c1a3876f7de9251412ddc71a42530482d80334b1 Mon Sep 17 00:00:00 2001
From: amagi <2749950753@qq.com>
Date: Fri, 6 Mar 2026 01:51:24 +0800
Subject: [PATCH 08/17] fix: improve error handling for non-JSON responses by
checking content type and using a streaming JSON parser.
---
pkg/providers/openai_compat/provider.go | 89 ++++----------------
pkg/providers/openai_compat/provider_test.go | 46 +++++++++-
2 files changed, 58 insertions(+), 77 deletions(-)
diff --git a/pkg/providers/openai_compat/provider.go b/pkg/providers/openai_compat/provider.go
index 0422f0eb4..22d4da56c 100644
--- a/pkg/providers/openai_compat/provider.go
+++ b/pkg/providers/openai_compat/provider.go
@@ -4,7 +4,6 @@ import (
"bytes"
"context"
"encoding/json"
- "errors"
"fmt"
"io"
"log"
@@ -184,84 +183,28 @@ func (p *Provider) Chat(
}
defer resp.Body.Close()
- body, err := io.ReadAll(resp.Body)
- if err != nil {
- return nil, fmt.Errorf("failed to read response: %w", err)
+ contentType := resp.Header.Get("Content-Type")
+
+ // check if there is an HTTP error (caused by proxy or gateway) or if the response is HTML
+ if resp.StatusCode != http.StatusOK || strings.Contains(strings.ToLower(contentType), "text/html") {
+ body, _ := io.ReadAll(io.LimitReader(resp.Body, 256))
+ return nil, wrapHTTPResponseError(resp.StatusCode, body, contentType, p.apiBase)
}
- if resp.StatusCode != http.StatusOK {
- return nil, wrapHTTPResponseError(resp.StatusCode, body, resp.Header.Get("Content-Type"), p.apiBase)
- }
-
- out, err := parseResponse(body)
+ // directly pass the stream (resp.Body) to the JSON parser without loading everything into memory
+ out, err := parseResponse(resp.Body)
if err != nil {
- return nil, wrapResponseParseError(err, body, resp.Header.Get("Content-Type"), p.apiBase)
+ // Note: if it fails here, we do not have the full body in memory for HTML inspection,
+ // but having already checked the Content-Type above, the error is genuinely related to JSON parsing.
+ return nil, fmt.Errorf("failed to parse JSON response: %w", err)
}
return out, nil
}
-func wrapResponseParseError(err error, body []byte, contentType, apiBase string) error {
- if message, ok := htmlResponseMessage(body, contentType, apiBase); ok {
- return errors.New(message)
- }
- return err
-}
-
func wrapHTTPResponseError(statusCode int, body []byte, contentType, apiBase string) error {
- if message, ok := htmlResponseMessage(body, contentType, apiBase); ok {
- return fmt.Errorf("API request failed:\n Status: %d\n Detail: %s", statusCode, message)
- }
- return fmt.Errorf("API request failed:\n Status: %d\n Body: %s", statusCode, string(body))
-}
-
-func htmlResponseMessage(body []byte, contentType, apiBase string) (string, bool) {
- trimmedContentType := strings.TrimSpace(contentType)
- if !looksLikeHTML(body, trimmedContentType) {
- return "", false
- }
-
- contentTypeHint := ""
- if trimmedContentType != "" {
- contentTypeHint = fmt.Sprintf(" (content-type: %s)", trimmedContentType)
- }
-
- return fmt.Sprintf(
- "expected JSON response from %s/chat/completions, but received HTML%s; check api_base or proxy configuration. Response preview: %s",
- apiBase,
- contentTypeHint,
- responsePreview(body, 160),
- ), true
-}
-
-func looksLikeHTML(body []byte, contentType string) bool {
- contentType = strings.ToLower(strings.TrimSpace(contentType))
- if strings.Contains(contentType, "text/html") || strings.Contains(contentType, "application/xhtml+xml") {
- return true
- }
-
- trimmed := strings.ToLower(string(leadingTrimmedPrefix(body, 128)))
- return strings.HasPrefix(trimmed, " len(body) {
- end = len(body)
- }
- return body[i:end]
- }
- }
- return nil
+ respPreview := responsePreview(body, 128)
+ return fmt.Errorf("API request failed: %s returned HTML instead of JSON (content-type: %s); check api_base or proxy configuration.\n Status: %d\n Body: %s", apiBase, contentType, statusCode, respPreview)
}
func responsePreview(body []byte, maxLen int) string {
@@ -275,7 +218,7 @@ func responsePreview(body []byte, maxLen int) string {
return string(trimmed[:maxLen]) + "..."
}
-func parseResponse(body []byte) (*LLMResponse, error) {
+func parseResponse(body io.Reader) (*LLMResponse, error) {
var apiResponse struct {
Choices []struct {
Message struct {
@@ -302,8 +245,8 @@ func parseResponse(body []byte) (*LLMResponse, error) {
Usage *UsageInfo `json:"usage"`
}
- if err := json.Unmarshal(body, &apiResponse); err != nil {
- return nil, fmt.Errorf("failed to unmarshal response: %w", err)
+ if err := json.NewDecoder(body).Decode(&apiResponse); err != nil {
+ return nil, fmt.Errorf("failed to decode response: %w", err)
}
if len(apiResponse.Choices) == 0 {
diff --git a/pkg/providers/openai_compat/provider_test.go b/pkg/providers/openai_compat/provider_test.go
index 899d10c8d..84e6bbe3e 100644
--- a/pkg/providers/openai_compat/provider_test.go
+++ b/pkg/providers/openai_compat/provider_test.go
@@ -258,10 +258,48 @@ func TestProviderChat_HTMLErrorResponseReturnsHelpfulError(t *testing.T) {
}
}
-func TestLooksLikeHTML_SniffsPrefixWithLargeBody(t *testing.T) {
- body := append([]byte(" \r\n\tx"), bytes.Repeat([]byte("A"), 1024*1024)...)
- if !looksLikeHTML(body, "") {
- t.Fatal("expected looksLikeHTML to detect html prefix")
+func TestProviderChat_MislabeledHTMLSuccessResponseReturnsHelpfulError(t *testing.T) {
+ server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+ w.Header().Set("Content-Type", "application/json")
+ w.WriteHeader(http.StatusOK)
+ _, _ = w.Write([]byte(" \r\n\tgateway login"))
+ }))
+ defer server.Close()
+
+ p := NewProvider("key", server.URL, "")
+ _, err := p.Chat(t.Context(), []Message{{Role: "user", Content: "hi"}}, nil, "gpt-4o", nil)
+ if err == nil {
+ t.Fatal("expected error, got nil")
+ }
+ if !strings.Contains(err.Error(), "received HTML") {
+ t.Fatalf("expected helpful HTML error, got %v", err)
+ }
+ if !strings.Contains(err.Error(), "check api_base or proxy configuration") {
+ t.Fatalf("expected configuration hint, got %v", err)
+ }
+}
+
+func TestProviderChat_LargeHTMLResponsePreviewIsTruncated(t *testing.T) {
+ body := append([]byte(""), bytes.Repeat([]byte("A"), 2048)...)
+ body = append(body, []byte("")...)
+
+ server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+ w.Header().Set("Content-Type", "text/html; charset=utf-8")
+ w.WriteHeader(http.StatusBadGateway)
+ _, _ = w.Write(body)
+ }))
+ defer server.Close()
+
+ p := NewProvider("key", server.URL, "")
+ _, err := p.Chat(t.Context(), []Message{{Role: "user", Content: "hi"}}, nil, "gpt-4o", nil)
+ if err == nil {
+ t.Fatal("expected error, got nil")
+ }
+ if !strings.Contains(err.Error(), "Response preview: ") {
+ t.Fatalf("expected html preview in error, got %v", err)
+ }
+ if !strings.Contains(err.Error(), "...") {
+ t.Fatalf("expected truncated preview, got %v", err)
}
}
From c10959b645dd70930e5791c5f10a8237cf443309 Mon Sep 17 00:00:00 2001
From: Amir Mamaghani
Date: Thu, 5 Mar 2026 19:23:40 +0100
Subject: [PATCH 09/17] test(irc): add unit tests for IRC channel
Test NewIRCChannel validation, extractHost, isBotMentioned,
stripBotMention, and isAlphanumeric helper functions.
---
pkg/channels/irc/irc_test.go | 134 +++++++++++++++++++++++++++++++++++
1 file changed, 134 insertions(+)
create mode 100644 pkg/channels/irc/irc_test.go
diff --git a/pkg/channels/irc/irc_test.go b/pkg/channels/irc/irc_test.go
new file mode 100644
index 000000000..dae3edb04
--- /dev/null
+++ b/pkg/channels/irc/irc_test.go
@@ -0,0 +1,134 @@
+package irc
+
+import (
+ "testing"
+
+ "github.com/sipeed/picoclaw/pkg/bus"
+ "github.com/sipeed/picoclaw/pkg/config"
+)
+
+func TestNewIRCChannel(t *testing.T) {
+ msgBus := bus.NewMessageBus()
+
+ t.Run("missing server", func(t *testing.T) {
+ cfg := config.IRCConfig{Nick: "bot"}
+ _, err := NewIRCChannel(cfg, msgBus)
+ if err == nil {
+ t.Error("expected error for missing server, got nil")
+ }
+ })
+
+ t.Run("missing nick", func(t *testing.T) {
+ cfg := config.IRCConfig{Server: "irc.example.com:6667"}
+ _, err := NewIRCChannel(cfg, msgBus)
+ if err == nil {
+ t.Error("expected error for missing nick, got nil")
+ }
+ })
+
+ t.Run("valid config", func(t *testing.T) {
+ cfg := config.IRCConfig{
+ Server: "irc.example.com:6667",
+ Nick: "testbot",
+ Channels: []string{"#test"},
+ }
+ ch, err := NewIRCChannel(cfg, msgBus)
+ if err != nil {
+ t.Fatalf("unexpected error: %v", err)
+ }
+ if ch.Name() != "irc" {
+ t.Errorf("Name() = %q, want %q", ch.Name(), "irc")
+ }
+ if ch.IsRunning() {
+ t.Error("new channel should not be running")
+ }
+ })
+}
+
+func TestExtractHost(t *testing.T) {
+ tests := []struct {
+ server string
+ want string
+ }{
+ {"irc.libera.chat:6697", "irc.libera.chat"},
+ {"localhost:6667", "localhost"},
+ {"irc.example.com", "irc.example.com"},
+ {"", ""},
+ }
+
+ for _, tt := range tests {
+ t.Run(tt.server, func(t *testing.T) {
+ got := extractHost(tt.server)
+ if got != tt.want {
+ t.Errorf("extractHost(%q) = %q, want %q", tt.server, got, tt.want)
+ }
+ })
+ }
+}
+
+func TestIsBotMentioned(t *testing.T) {
+ tests := []struct {
+ name string
+ content string
+ nick string
+ want bool
+ }{
+ {"colon prefix", "bot: hello", "bot", true},
+ {"comma prefix", "bot, hello", "bot", true},
+ {"case insensitive", "BOT: hello", "bot", true},
+ {"word boundary mid", "hey bot what's up", "bot", true},
+ {"no mention", "hello world", "bot", false},
+ {"substring mismatch", "robotics are cool", "bot", false},
+ {"nick at end", "hello bot", "bot", true},
+ {"empty content", "", "bot", false},
+ }
+
+ for _, tt := range tests {
+ t.Run(tt.name, func(t *testing.T) {
+ got := isBotMentioned(tt.content, tt.nick)
+ if got != tt.want {
+ t.Errorf("isBotMentioned(%q, %q) = %v, want %v", tt.content, tt.nick, got, tt.want)
+ }
+ })
+ }
+}
+
+func TestStripBotMention(t *testing.T) {
+ tests := []struct {
+ name string
+ content string
+ nick string
+ want string
+ }{
+ {"colon prefix", "bot: hello there", "bot", "hello there"},
+ {"comma prefix", "bot, help me", "bot", "help me"},
+ {"case insensitive", "BOT: hello", "bot", "hello"},
+ {"no prefix match", "hello bot", "bot", "hello bot"},
+ {"only prefix", "bot:", "bot", ""},
+ }
+
+ for _, tt := range tests {
+ t.Run(tt.name, func(t *testing.T) {
+ got := stripBotMention(tt.content, tt.nick)
+ if got != tt.want {
+ t.Errorf("stripBotMention(%q, %q) = %q, want %q", tt.content, tt.nick, got, tt.want)
+ }
+ })
+ }
+}
+
+func TestIsAlphanumeric(t *testing.T) {
+ alphanumeric := "azAZ09_"
+ for _, b := range []byte(alphanumeric) {
+ if !isAlphanumeric(b) {
+ t.Errorf("isAlphanumeric(%q) = false, want true", string(b))
+ }
+ }
+
+ nonAlpha := " !@#:,"
+ for _, b := range []byte(nonAlpha) {
+ if isAlphanumeric(b) {
+ t.Errorf("isAlphanumeric(%q) = true, want false", string(b))
+ }
+ }
+}
From 1945436dd44817bb3eca9919e63dc8d7f1325c25 Mon Sep 17 00:00:00 2001
From: fishtrees
Date: Fri, 6 Mar 2026 20:46:52 +0800
Subject: [PATCH 10/17] feat(cron): add execution lifecycle logging (#1185)
- Log job start with name, id, schedule kind, and channel
- Log job completion with duration and next run time
- Log job errors with duration and error message
- Helps diagnose scheduler stalls and connection issues
---
pkg/cron/service.go | 20 ++++++++++++++++++++
1 file changed, 20 insertions(+)
diff --git a/pkg/cron/service.go b/pkg/cron/service.go
index 6962041c1..04775ac42 100644
--- a/pkg/cron/service.go
+++ b/pkg/cron/service.go
@@ -190,14 +190,21 @@ func (cs *CronService) executeJobByID(jobID string) {
cs.mu.RUnlock()
if callbackJob == nil {
+ log.Printf("[cron] job %s not found, skipping", jobID)
return
}
+ // Log job execution start
+ log.Printf("[cron] ▶ executing job '%s' (id: %s, schedule: %s, channel: %s)",
+ callbackJob.Name, jobID, callbackJob.Schedule.Kind, callbackJob.Payload.Channel)
+
var err error
if cs.onJob != nil {
_, err = cs.onJob(callbackJob)
}
+ execDuration := time.Now().UnixMilli() - startTime
+
// Now acquire lock to update state
cs.mu.Lock()
defer cs.mu.Unlock()
@@ -220,22 +227,35 @@ func (cs *CronService) executeJobByID(jobID string) {
if err != nil {
job.State.LastStatus = "error"
job.State.LastError = err.Error()
+ log.Printf("[cron] ✗ job '%s' failed after %dms: %v", job.Name, execDuration, err)
} else {
job.State.LastStatus = "ok"
job.State.LastError = ""
}
// Compute next run time
+ var nextRunStr string
if job.Schedule.Kind == "at" {
if job.DeleteAfterRun {
cs.removeJobUnsafe(job.ID)
+ nextRunStr = "(deleted)"
} else {
job.Enabled = false
job.State.NextRunAtMS = nil
+ nextRunStr = "(disabled)"
}
} else {
nextRun := cs.computeNextRun(&job.Schedule, time.Now().UnixMilli())
job.State.NextRunAtMS = nextRun
+ if nextRun != nil {
+ nextRunStr = time.UnixMilli(*nextRun).Format("2006-01-02 15:04:05")
+ } else {
+ nextRunStr = "(none)"
+ }
+ }
+
+ if err == nil {
+ log.Printf("[cron] ✓ job '%s' completed in %dms, next run: %s", job.Name, execDuration, nextRunStr)
}
if err := cs.saveStoreUnsafe(); err != nil {
From a89ba06cb8453a6d4f0e8f01f40334a725a6bfe2 Mon Sep 17 00:00:00 2001
From: Amir Mamaghani
Date: Fri, 6 Mar 2026 20:09:37 +0100
Subject: [PATCH 11/17] fix: address review feedback from @mengzhuo
- Add separate User and RealName config fields (fall back to Nick)
- Make RequestCaps configurable (defaults to server-time, message-tags)
- Refactor isBotMentioned into nickMentionedAt returning position;
stripBotMention now uses nickMentionedAt internally
- Replace custom isAlphanumeric with unicode.IsLetter/unicode.IsDigit
- Update tests for new nickMentionedAt function
---
pkg/channels/irc/handler.go | 40 ++++++++++++++++++++++-----------
pkg/channels/irc/irc.go | 19 +++++++++++++---
pkg/channels/irc/irc_test.go | 43 ++++++++++++++++++++++--------------
pkg/config/config.go | 3 +++
4 files changed, 73 insertions(+), 32 deletions(-)
diff --git a/pkg/channels/irc/handler.go b/pkg/channels/irc/handler.go
index ea9fbc85f..aca4ddd11 100644
--- a/pkg/channels/irc/handler.go
+++ b/pkg/channels/irc/handler.go
@@ -4,6 +4,7 @@ import (
"fmt"
"strings"
"time"
+ "unicode"
"github.com/ergochat/irc-go/ircevent"
"github.com/ergochat/irc-go/ircmsg"
@@ -102,30 +103,47 @@ func (c *IRCChannel) onPrivmsg(conn *ircevent.Connection, e ircmsg.Message) {
c.HandleMessage(c.ctx, peer, messageID, nick, chatID, content, nil, metadata, sender)
}
-// isBotMentioned checks if the bot's nick appears in the message.
-func isBotMentioned(content, botNick string) bool {
+// nickMentionedAt returns the byte index where botNick is mentioned in content
+// with word-boundary checks, or -1 if not found. Also checks for "nick:" /
+// "nick," prefix convention.
+func nickMentionedAt(content, botNick string) int {
lower := strings.ToLower(content)
lowerNick := strings.ToLower(botNick)
- // "nick: " or "nick, " at start (most common IRC convention)
+ // "nick:" or "nick," at start (most common IRC convention)
if strings.HasPrefix(lower, lowerNick+":") || strings.HasPrefix(lower, lowerNick+",") {
- return true
+ return 0
}
// Word-boundary match anywhere in the message
idx := strings.Index(lower, lowerNick)
if idx < 0 {
- return false
+ return -1
}
- before := idx == 0 || !isAlphanumeric(lower[idx-1])
- after := idx+len(lowerNick) >= len(lower) || !isAlphanumeric(lower[idx+len(lowerNick)])
- return before && after
+ runes := []rune(lower)
+ nickRunes := []rune(lowerNick)
+ endIdx := idx + len(string(nickRunes))
+ before := idx == 0 || !unicode.IsLetter(runes[idx-1]) && !unicode.IsDigit(runes[idx-1])
+ after := endIdx >= len(lower) || !unicode.IsLetter(rune(lower[endIdx])) && !unicode.IsDigit(rune(lower[endIdx]))
+ if before && after {
+ return idx
+ }
+ return -1
+}
+
+// isBotMentioned checks if the bot's nick appears in the message.
+func isBotMentioned(content, botNick string) bool {
+ return nickMentionedAt(content, botNick) >= 0
}
// stripBotMention removes "nick: " or "nick, " prefix from content.
func stripBotMention(content, botNick string) string {
- lower := strings.ToLower(content)
+ idx := nickMentionedAt(content, botNick)
+ if idx != 0 {
+ return content
+ }
lowerNick := strings.ToLower(botNick)
+ lower := strings.ToLower(content)
for _, sep := range []string{":", ","} {
prefix := lowerNick + sep
if strings.HasPrefix(lower, prefix) {
@@ -134,7 +152,3 @@ func stripBotMention(content, botNick string) string {
}
return content
}
-
-func isAlphanumeric(b byte) bool {
- return (b >= 'a' && b <= 'z') || (b >= 'A' && b <= 'Z') || (b >= '0' && b <= '9') || b == '_'
-}
diff --git a/pkg/channels/irc/irc.go b/pkg/channels/irc/irc.go
index b0c4874e1..28c59b540 100644
--- a/pkg/channels/irc/irc.go
+++ b/pkg/channels/irc/irc.go
@@ -50,14 +50,27 @@ func (c *IRCChannel) Start(ctx context.Context) error {
logger.InfoC("irc", "Starting IRC channel")
c.ctx, c.cancel = context.WithCancel(ctx)
+ user := c.config.User
+ if user == "" {
+ user = c.config.Nick
+ }
+ realName := c.config.RealName
+ if realName == "" {
+ realName = c.config.Nick
+ }
+ caps := []string(c.config.RequestCaps)
+ if len(caps) == 0 {
+ caps = []string{"server-time", "message-tags"}
+ }
+
conn := &ircevent.Connection{
Server: c.config.Server,
Nick: c.config.Nick,
- User: c.config.Nick,
- RealName: c.config.Nick,
+ User: user,
+ RealName: realName,
Password: c.config.Password,
UseTLS: c.config.TLS,
- RequestCaps: []string{"server-time", "message-tags"},
+ RequestCaps: caps,
QuitMessage: "Goodbye",
Debug: false,
Log: nil,
diff --git a/pkg/channels/irc/irc_test.go b/pkg/channels/irc/irc_test.go
index dae3edb04..168252a4d 100644
--- a/pkg/channels/irc/irc_test.go
+++ b/pkg/channels/irc/irc_test.go
@@ -66,6 +66,33 @@ func TestExtractHost(t *testing.T) {
}
}
+func TestNickMentionedAt(t *testing.T) {
+ tests := []struct {
+ name string
+ content string
+ nick string
+ want int
+ }{
+ {"colon prefix", "bot: hello", "bot", 0},
+ {"comma prefix", "bot, hello", "bot", 0},
+ {"case insensitive", "BOT: hello", "bot", 0},
+ {"word boundary mid", "hey bot what's up", "bot", 4},
+ {"no mention", "hello world", "bot", -1},
+ {"substring mismatch", "robotics are cool", "bot", -1},
+ {"nick at end", "hello bot", "bot", 6},
+ {"empty content", "", "bot", -1},
+ }
+
+ for _, tt := range tests {
+ t.Run(tt.name, func(t *testing.T) {
+ got := nickMentionedAt(tt.content, tt.nick)
+ if got != tt.want {
+ t.Errorf("nickMentionedAt(%q, %q) = %d, want %d", tt.content, tt.nick, got, tt.want)
+ }
+ })
+ }
+}
+
func TestIsBotMentioned(t *testing.T) {
tests := []struct {
name string
@@ -116,19 +143,3 @@ func TestStripBotMention(t *testing.T) {
})
}
}
-
-func TestIsAlphanumeric(t *testing.T) {
- alphanumeric := "azAZ09_"
- for _, b := range []byte(alphanumeric) {
- if !isAlphanumeric(b) {
- t.Errorf("isAlphanumeric(%q) = false, want true", string(b))
- }
- }
-
- nonAlpha := " !@#:,"
- for _, b := range []byte(nonAlpha) {
- if isAlphanumeric(b) {
- t.Errorf("isAlphanumeric(%q) = true, want false", string(b))
- }
- }
-}
diff --git a/pkg/config/config.go b/pkg/config/config.go
index 00a69c28a..a368e50ba 100644
--- a/pkg/config/config.go
+++ b/pkg/config/config.go
@@ -407,11 +407,14 @@ type IRCConfig struct {
Server string `json:"server" env:"PICOCLAW_CHANNELS_IRC_SERVER"`
TLS bool `json:"tls" env:"PICOCLAW_CHANNELS_IRC_TLS"`
Nick string `json:"nick" env:"PICOCLAW_CHANNELS_IRC_NICK"`
+ User string `json:"user,omitempty" env:"PICOCLAW_CHANNELS_IRC_USER"`
+ RealName string `json:"real_name,omitempty" env:"PICOCLAW_CHANNELS_IRC_REAL_NAME"`
Password string `json:"password" env:"PICOCLAW_CHANNELS_IRC_PASSWORD"`
NickServPassword string `json:"nickserv_password" env:"PICOCLAW_CHANNELS_IRC_NICKSERV_PASSWORD"`
SASLUser string `json:"sasl_user" env:"PICOCLAW_CHANNELS_IRC_SASL_USER"`
SASLPassword string `json:"sasl_password" env:"PICOCLAW_CHANNELS_IRC_SASL_PASSWORD"`
Channels FlexibleStringSlice `json:"channels" env:"PICOCLAW_CHANNELS_IRC_CHANNELS"`
+ RequestCaps FlexibleStringSlice `json:"request_caps,omitempty" env:"PICOCLAW_CHANNELS_IRC_REQUEST_CAPS"`
AllowFrom FlexibleStringSlice `json:"allow_from" env:"PICOCLAW_CHANNELS_IRC_ALLOW_FROM"`
GroupTrigger GroupTriggerConfig `json:"group_trigger,omitempty"`
Typing TypingConfig `json:"typing,omitempty"`
From 94b6b656c24febedb742f6e543f735ccefb2ae6c Mon Sep 17 00:00:00 2001
From: Amir Mamaghani
Date: Fri, 6 Mar 2026 20:21:53 +0100
Subject: [PATCH 12/17] docs: add user, real_name, and request_caps to IRC
example config
---
config/config.example.json | 3 +++
1 file changed, 3 insertions(+)
diff --git a/config/config.example.json b/config/config.example.json
index bd20ac535..9779bb862 100644
--- a/config/config.example.json
+++ b/config/config.example.json
@@ -170,11 +170,14 @@
"server": "irc.libera.chat:6697",
"tls": true,
"nick": "mybot",
+ "user": "",
+ "real_name": "",
"password": "",
"nickserv_password": "",
"sasl_user": "",
"sasl_password": "",
"channels": ["#mychannel"],
+ "request_caps": ["server-time", "message-tags"],
"allow_from": [],
"group_trigger": {
"mention_only": true
From 78aa45f107df063d44533d8aeb5391d573bda6b7 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 7 Mar 2026 09:26:30 +1100
Subject: [PATCH 13/17] chore(deps): bump
github.com/modelcontextprotocol/go-sdk (#1199)
Bumps [github.com/modelcontextprotocol/go-sdk](https://github.com/modelcontextprotocol/go-sdk) from 1.3.0 to 1.3.1.
- [Release notes](https://github.com/modelcontextprotocol/go-sdk/releases)
- [Commits](https://github.com/modelcontextprotocol/go-sdk/compare/v1.3.0...v1.3.1)
---
updated-dependencies:
- dependency-name: github.com/modelcontextprotocol/go-sdk
dependency-version: 1.3.1
dependency-type: direct:production
...
Signed-off-by: dependabot[bot]
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
go.mod | 4 +++-
go.sum | 8 ++++++--
2 files changed, 9 insertions(+), 3 deletions(-)
diff --git a/go.mod b/go.mod
index 6fa3a900c..58c4a7637 100644
--- a/go.mod
+++ b/go.mod
@@ -14,7 +14,7 @@ require (
github.com/h2non/filetype v1.1.3
github.com/larksuite/oapi-sdk-go/v3 v3.5.3
github.com/mdp/qrterminal/v3 v3.2.1
- github.com/modelcontextprotocol/go-sdk v1.3.0
+ github.com/modelcontextprotocol/go-sdk v1.3.1
github.com/mymmrac/telego v1.6.0
github.com/open-dingtalk/dingtalk-stream-sdk-go v0.9.1
github.com/openai/openai-go/v3 v3.22.0
@@ -48,6 +48,8 @@ require (
github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec // indirect
github.com/rivo/uniseg v0.4.7 // indirect
github.com/rs/zerolog v1.34.0 // indirect
+ github.com/segmentio/asm v1.1.3 // indirect
+ github.com/segmentio/encoding v0.5.3 // indirect
github.com/spf13/pflag v1.0.10 // indirect
github.com/vektah/gqlparser/v2 v2.5.27 // indirect
go.mau.fi/libsignal v0.2.1 // indirect
diff --git a/go.sum b/go.sum
index 060594d06..38a573d23 100644
--- a/go.sum
+++ b/go.sum
@@ -134,8 +134,8 @@ github.com/mattn/go-sqlite3 v1.14.34 h1:3NtcvcUnFBPsuRcno8pUtupspG/GM+9nZ88zgJcp
github.com/mattn/go-sqlite3 v1.14.34/go.mod h1:Uh1q+B4BYcTPb+yiD3kU8Ct7aC0hY9fxUwlHK0RXw+Y=
github.com/mdp/qrterminal/v3 v3.2.1 h1:6+yQjiiOsSuXT5n9/m60E54vdgFsw0zhADHhHLrFet4=
github.com/mdp/qrterminal/v3 v3.2.1/go.mod h1:jOTmXvnBsMy5xqLniO0R++Jmjs2sTm9dFSuQ5kpz/SU=
-github.com/modelcontextprotocol/go-sdk v1.3.0 h1:gMfZkv3DzQF5q/DcQePo5rahEY+sguyPfXDfNBcT0Zs=
-github.com/modelcontextprotocol/go-sdk v1.3.0/go.mod h1:AnQ//Qc6+4nIyyrB4cxBU7UW9VibK4iOZBeyP/rF1IE=
+github.com/modelcontextprotocol/go-sdk v1.3.1 h1:TfqtNKOIWN4Z1oqmPAiWDC2Jq7K9OdJaooe0teoXASI=
+github.com/modelcontextprotocol/go-sdk v1.3.1/go.mod h1:DgVX498dMD8UJlseK1S5i1T4tFz2fkBk4xogC3D15nw=
github.com/mymmrac/telego v1.6.0 h1:Zc8rgyHozvd/7ZgyrigyHdAF9koHYMfilYfyB6wlFC0=
github.com/mymmrac/telego v1.6.0/go.mod h1:xt6ZWA8zi8KmuzryE1ImEdl9JSwjHNpM4yhC7D8hU4Y=
github.com/ncruces/go-strftime v1.0.0 h1:HMFp8mLCTPp341M/ZnA4qaf7ZlsbTc+miZjCLOFAw7w=
@@ -171,6 +171,10 @@ github.com/rs/xid v1.6.0/go.mod h1:7XoLgs4eV+QndskICGsho+ADou8ySMSjJKDIan90Nz0=
github.com/rs/zerolog v1.34.0 h1:k43nTLIwcTVQAncfCw4KZ2VY6ukYoZaBPNOE8txlOeY=
github.com/rs/zerolog v1.34.0/go.mod h1:bJsvje4Z08ROH4Nhs5iH600c3IkWhwp44iRc54W6wYQ=
github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
+github.com/segmentio/asm v1.1.3 h1:WM03sfUOENvvKexOLp+pCqgb/WDjsi7EK8gIsICtzhc=
+github.com/segmentio/asm v1.1.3/go.mod h1:Ld3L4ZXGNcSLRg4JBsZ3//1+f/TjYl0Mzen/DQy1EJg=
+github.com/segmentio/encoding v0.5.3 h1:OjMgICtcSFuNvQCdwqMCv9Tg7lEOXGwm1J5RPQccx6w=
+github.com/segmentio/encoding v0.5.3/go.mod h1:HS1ZKa3kSN32ZHVZ7ZLPLXWvOVIiZtyJnO1gPH1sKt0=
github.com/sergi/go-diff v1.3.1 h1:xkr+Oxo4BOQKmkn/B9eMK0g5Kg/983T9DqqPHwYqD+8=
github.com/sergi/go-diff v1.3.1/go.mod h1:aMJSSKb2lpPvRNec0+w3fl7LP9IOFzdc9Pa4NFbPK1I=
github.com/slack-go/slack v0.17.3 h1:zV5qO3Q+WJAQ/XwbGfNFrRMaJ5T/naqaonyPV/1TP4g=
From 91a633c009d2f0baf067e3cfa94140819d6282af Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 7 Mar 2026 09:26:52 +1100
Subject: [PATCH 14/17] chore(deps): bump filippo.io/edwards25519 from 1.1.0 to
1.1.1 (#1200)
Bumps [filippo.io/edwards25519](https://github.com/FiloSottile/edwards25519) from 1.1.0 to 1.1.1.
- [Commits](https://github.com/FiloSottile/edwards25519/compare/v1.1.0...v1.1.1)
---
updated-dependencies:
- dependency-name: filippo.io/edwards25519
dependency-version: 1.1.1
dependency-type: indirect
...
Signed-off-by: dependabot[bot]
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
go.mod | 2 +-
go.sum | 4 ++--
2 files changed, 3 insertions(+), 3 deletions(-)
diff --git a/go.mod b/go.mod
index 58c4a7637..6c54e291a 100644
--- a/go.mod
+++ b/go.mod
@@ -31,7 +31,7 @@ require (
)
require (
- filippo.io/edwards25519 v1.1.0 // indirect
+ filippo.io/edwards25519 v1.1.1 // indirect
github.com/beeper/argo-go v1.1.2 // indirect
github.com/coder/websocket v1.8.14 // indirect
github.com/davecgh/go-spew v1.1.1 // indirect
diff --git a/go.sum b/go.sum
index 38a573d23..e5761ea9d 100644
--- a/go.sum
+++ b/go.sum
@@ -1,6 +1,6 @@
cloud.google.com/go/compute/metadata v0.3.0/go.mod h1:zFmK7XCadkQkj6TtorcaGlCW1hT1fIilQDwofLpJ20k=
-filippo.io/edwards25519 v1.1.0 h1:FNf4tywRC1HmFuKW5xopWpigGjJKiJSV0Cqo0cJWDaA=
-filippo.io/edwards25519 v1.1.0/go.mod h1:BxyFTGdWcka3PhytdK4V28tE5sGfRvvvRV7EaN4VDT4=
+filippo.io/edwards25519 v1.1.1 h1:YpjwWWlNmGIDyXOn8zLzqiD+9TyIlPhGFG96P39uBpw=
+filippo.io/edwards25519 v1.1.1/go.mod h1:BxyFTGdWcka3PhytdK4V28tE5sGfRvvvRV7EaN4VDT4=
github.com/DATA-DOG/go-sqlmock v1.5.2 h1:OcvFkGmslmlZibjAjaHm3L//6LiuBgolP7OputlJIzU=
github.com/DATA-DOG/go-sqlmock v1.5.2/go.mod h1:88MAG/4G7SMwSE3CeA0ZKzrT5CiOU3OJ+JlNzwDqpNU=
github.com/adhocore/gronx v1.19.6 h1:5KNVcoR9ACgL9HhEqCm5QXsab/gI4QDIybTAWcXDKDc=
From b8f8e3f25f34bc7a3a5353f51cfef49974fdb8d5 Mon Sep 17 00:00:00 2001
From: Guoguo <16666742+imguoguo@users.noreply.github.com>
Date: Sat, 7 Mar 2026 07:31:23 +0800
Subject: [PATCH 15/17] docs: update wechat qrcode (#1192)
---
assets/wechat.png | Bin 98050 -> 395669 bytes
1 file changed, 0 insertions(+), 0 deletions(-)
diff --git a/assets/wechat.png b/assets/wechat.png
index 32998c1220f9c1e7228420f2f83ec32f349b5f1d..cc88186a81b3c8024102fa8401cc85397fd575de 100644
GIT binary patch
literal 395669
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