From a01af36af4fb387a8bff6f528f5c5fb9cb89bb83 Mon Sep 17 00:00:00 2001 From: afjcjsbx Date: Thu, 12 Mar 2026 18:58:24 +0100 Subject: [PATCH 01/56] feat(logger): add custom console formatter for JSON and multiline strings --- pkg/logger/logger.go | 65 +++++++++++++++++++++++++++++++++++++++----- 1 file changed, 58 insertions(+), 7 deletions(-) diff --git a/pkg/logger/logger.go b/pkg/logger/logger.go index 80adcf86c..54dc61588 100644 --- a/pkg/logger/logger.go +++ b/pkg/logger/logger.go @@ -5,6 +5,7 @@ import ( "os" "path/filepath" "runtime" + "strconv" "strings" "sync" @@ -45,6 +46,9 @@ func init() { consoleWriter := zerolog.ConsoleWriter{ Out: os.Stdout, TimeFormat: "15:04:05", // TODO: make it configurable??? + + // Custom formatter to handle multiline strings and JSON objects + FormatFieldValue: formatFieldValue, } logger = zerolog.New(consoleWriter).With().Timestamp().Logger() @@ -52,6 +56,37 @@ func init() { }) } +func formatFieldValue(i any) string { + var s string + + switch val := i.(type) { + case string: + s = val + case []byte: + s = string(val) + default: + return fmt.Sprintf("%v", i) + } + + if unquoted, err := strconv.Unquote(s); err == nil { + s = unquoted + } + + if strings.Contains(s, "\n") { + return fmt.Sprintf("\n%s", s) + } + + if strings.Contains(s, " ") { + if (strings.HasPrefix(s, "{") && strings.HasSuffix(s, "}")) || + (strings.HasPrefix(s, "[") && strings.HasSuffix(s, "]")) { + return s + } + return fmt.Sprintf("%q", s) + } + + return s +} + func SetLevel(level LogLevel) { mu.Lock() defer mu.Unlock() @@ -162,10 +197,7 @@ func logMessage(level LogLevel, component string, message string, fields map[str event.Str("caller", fmt.Sprintf(" %s:%d (%s)", callerFile, callerLine, callerFunc)) } - for k, v := range fields { - event.Interface(k, v) - } - + appendFields(event, fields) event.Msg(message) // Also log to file if enabled @@ -175,9 +207,8 @@ func logMessage(level LogLevel, component string, message string, fields map[str if component != "" { fileEvent.Str("component", component) } - for k, v := range fields { - fileEvent.Interface(k, v) - } + + appendFields(event, fields) fileEvent.Msg(message) } @@ -186,6 +217,26 @@ func logMessage(level LogLevel, component string, message string, fields map[str } } +func appendFields(event *zerolog.Event, fields map[string]any) { + for k, v := range fields { + // Type switch to avoid double JSON serialization of strings + switch val := v.(type) { + case string: + event.Str(k, val) + case int: + event.Int(k, val) + case int64: + event.Int64(k, val) + case float64: + event.Float64(k, val) + case bool: + event.Bool(k, val) + default: + event.Interface(k, v) // Fallback for struct, slice and maps + } + } +} + func Debug(message string) { logMessage(DEBUG, "", message, nil) } From 78c9b86d7efb451a5055202810540b97f48350a3 Mon Sep 17 00:00:00 2001 From: afjcjsbx Date: Fri, 13 Mar 2026 14:02:28 +0100 Subject: [PATCH 02/56] added tests --- pkg/logger/logger_test.go | 111 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 111 insertions(+) diff --git a/pkg/logger/logger_test.go b/pkg/logger/logger_test.go index 6e6f8dfa8..87be4fe97 100644 --- a/pkg/logger/logger_test.go +++ b/pkg/logger/logger_test.go @@ -137,3 +137,114 @@ func TestLoggerHelperFunctions(t *testing.T) { DebugC("test", "Debug with component") WarnF("Warning with fields", map[string]any{"key": "value"}) } + +func TestFormatFieldValue(t *testing.T) { + tests := []struct { + name string + input any + expected string + }{ + // Basic types test (default case of the switch) + { + name: "Integer Type", + input: 42, + expected: "42", + }, + { + name: "Boolean Type", + input: true, + expected: "true", + }, + { + name: "Unsupported Struct Type", + input: struct{ A int }{A: 1}, + expected: "{1}", + }, + + // Simple strings and byte slices test + { + name: "Simple string without spaces", + input: "simple_value", + expected: "simple_value", + }, + { + name: "Simple byte slice", + input: []byte("byte_value"), + expected: "byte_value", + }, + + // Unquoting test (strconv.Unquote) + { + name: "Quoted string", + input: `"quoted_value"`, + expected: "quoted_value", + }, + + // Strings with newline (\n) test + { + name: "String with newline", + input: "line1\nline2", + expected: "\nline1\nline2", + }, + { + name: "Quoted string with newline (Unquote -> newline)", + input: `"line1\nline2"`, // Escaped \n that Unquote will resolve + expected: "\nline1\nline2", + }, + + // Strings with spaces test (which should be quoted) + { + name: "String with spaces", + input: "hello world", + expected: `"hello world"`, + }, + { + name: "Quoted string with spaces (Unquote -> has spaces -> Re-quote)", + input: `"hello world"`, + expected: `"hello world"`, + }, + + // JSON formats test (strings with spaces that start/end with brackets) + { + name: "Valid JSON object", + input: `{"key": "value"}`, + expected: `{"key": "value"}`, + }, + { + name: "Valid JSON array", + input: `[1, 2, "three"]`, + expected: `[1, 2, "three"]`, + }, + { + name: "Fake JSON (starts with { but doesn't end with })", + input: `{"key": "value"`, // Missing closing bracket, has spaces + expected: `"{\"key\": \"value\""`, + }, + { + name: "Empty JSON (object)", + input: `{ }`, + expected: `{ }`, + }, + + // 7. Edge Cases + { + name: "Empty string", + input: "", + expected: "", + }, + { + name: "Whitespace only string", + input: " ", + expected: `" "`, + }, + } + + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + actual := formatFieldValue(tt.input) + if actual != tt.expected { + t.Errorf("formatFieldValue() = %q, expected %q", actual, tt.expected) + } + }) + } +} From 555af137b4feed27f1046e9680a6a6ed390f0a52 Mon Sep 17 00:00:00 2001 From: GPER <570165887@qq.com> Date: Sat, 14 Mar 2026 09:30:02 +0800 Subject: [PATCH 03/56] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E4=BD=BF=E7=94=A8?= =?UTF-8?q?=E7=81=AB=E5=B1=B1coding=20plain=E9=85=8D=E7=BD=AE=E5=8F=82?= =?UTF-8?q?=E6=95=B0=20(#1511)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.fr.md | 3 ++- README.ja.md | 3 ++- README.md | 3 ++- README.pt-br.md | 3 ++- README.vi.md | 3 ++- README.zh.md | 3 ++- 6 files changed, 12 insertions(+), 6 deletions(-) diff --git a/README.fr.md b/README.fr.md index 4d8059c4b..59dc0cb84 100644 --- a/README.fr.md +++ b/README.fr.md @@ -222,7 +222,8 @@ picoclaw onboard { "model_name": "ark-code-latest", "model": "volcengine/ark-code-latest", - "api_key": "sk-your-api-key" + "api_key": "sk-your-api-key", + "api_base":"https://ark.cn-beijing.volces.com/api/coding/v3" }, { "model_name": "gpt-5.4", diff --git a/README.ja.md b/README.ja.md index fa48daa0f..6702fe3f8 100644 --- a/README.ja.md +++ b/README.ja.md @@ -184,7 +184,8 @@ picoclaw onboard { "model_name": "ark-code-latest", "model": "volcengine/ark-code-latest", - "api_key": "sk-your-api-key" + "api_key": "sk-your-api-key", + "api_base":"https://ark.cn-beijing.volces.com/api/coding/v3" }, { "model_name": "gpt-5.4", diff --git a/README.md b/README.md index 58cdfe323..16252f83b 100644 --- a/README.md +++ b/README.md @@ -252,7 +252,8 @@ picoclaw onboard { "model_name": "ark-code-latest", "model": "volcengine/ark-code-latest", - "api_key": "sk-your-api-key" + "api_key": "sk-your-api-key", + "api_base":"https://ark.cn-beijing.volces.com/api/coding/v3" }, { "model_name": "gpt-5.4", diff --git a/README.pt-br.md b/README.pt-br.md index def3a5c2e..91bf23619 100644 --- a/README.pt-br.md +++ b/README.pt-br.md @@ -223,7 +223,8 @@ picoclaw onboard { "model_name": "ark-code-latest", "model": "volcengine/ark-code-latest", - "api_key": "sk-your-api-key" + "api_key": "sk-your-api-key", + "api_base":"https://ark.cn-beijing.volces.com/api/coding/v3" }, { "model_name": "gpt-5.4", diff --git a/README.vi.md b/README.vi.md index bf3fb14ce..0ca95d5d7 100644 --- a/README.vi.md +++ b/README.vi.md @@ -203,7 +203,8 @@ picoclaw onboard { "model_name": "ark-code-latest", "model": "volcengine/ark-code-latest", - "api_key": "sk-your-api-key" + "api_key": "sk-your-api-key", + "api_base":"https://ark.cn-beijing.volces.com/api/coding/v3" }, { "model_name": "gpt-5.4", diff --git a/README.zh.md b/README.zh.md index 2998c41f1..6458cfced 100644 --- a/README.zh.md +++ b/README.zh.md @@ -234,7 +234,8 @@ picoclaw onboard { "model_name": "ark-code-latest", "model": "volcengine/ark-code-latest", - "api_key": "sk-your-api-key" + "api_key": "sk-your-api-key", + "api_base":"https://ark.cn-beijing.volces.com/api/coding/v3" }, { "model_name": "gpt-5.4", From de0dd241b9bf2ddf8348a58ef4f90bce41ffe4a0 Mon Sep 17 00:00:00 2001 From: horsley Date: Sat, 14 Mar 2026 02:52:06 +0000 Subject: [PATCH 04/56] docs: add Ask DeepWiki badge to all README variants --- README.fr.md | 1 + README.ja.md | 1 + README.md | 1 + README.pt-br.md | 1 + README.vi.md | 1 + README.zh.md | 1 + 6 files changed, 6 insertions(+) diff --git a/README.fr.md b/README.fr.md index 59dc0cb84..2701627e8 100644 --- a/README.fr.md +++ b/README.fr.md @@ -9,6 +9,7 @@ Go Hardware License + Ask DeepWiki
Website Twitter diff --git a/README.ja.md b/README.ja.md index 6702fe3f8..0b84c6036 100644 --- a/README.ja.md +++ b/README.ja.md @@ -10,6 +10,7 @@ Go Hardware License +Ask DeepWiki

[中文](README.zh.md) | **日本語** | [Português](README.pt-br.md) | [Tiếng Việt](README.vi.md) | [Français](README.fr.md) | [English](README.md) diff --git a/README.md b/README.md index 16252f83b..298e854c9 100644 --- a/README.md +++ b/README.md @@ -9,6 +9,7 @@ Go Hardware License + Ask DeepWiki
Website Twitter diff --git a/README.pt-br.md b/README.pt-br.md index 91bf23619..e75d1e0c4 100644 --- a/README.pt-br.md +++ b/README.pt-br.md @@ -9,6 +9,7 @@ Go Hardware License + Ask DeepWiki
Website Twitter diff --git a/README.vi.md b/README.vi.md index 0ca95d5d7..2110ddb61 100644 --- a/README.vi.md +++ b/README.vi.md @@ -9,6 +9,7 @@ Go Hardware License + Ask DeepWiki
Website Twitter diff --git a/README.zh.md b/README.zh.md index 6458cfced..61e890715 100644 --- a/README.zh.md +++ b/README.zh.md @@ -9,6 +9,7 @@ Go Hardware License + Ask DeepWiki
Website Twitter From b9aaad95cd1770deeb7a78d9d137fc807c12a365 Mon Sep 17 00:00:00 2001 From: Hoshina Date: Sat, 14 Mar 2026 12:01:47 +0800 Subject: [PATCH 05/56] refactor(media): centralize temp media dir path --- pkg/channels/feishu/feishu_64.go | 2 +- pkg/channels/matrix/matrix.go | 4 +--- pkg/channels/matrix/matrix_test.go | 3 ++- pkg/media/tempdir.go | 13 +++++++++++++ pkg/utils/media.go | 3 ++- 5 files changed, 19 insertions(+), 6 deletions(-) create mode 100644 pkg/media/tempdir.go diff --git a/pkg/channels/feishu/feishu_64.go b/pkg/channels/feishu/feishu_64.go index 5dbbcf0af..9c462e41e 100644 --- a/pkg/channels/feishu/feishu_64.go +++ b/pkg/channels/feishu/feishu_64.go @@ -618,7 +618,7 @@ func (c *FeishuChannel) downloadResource( } // Write to the shared picoclaw_media directory using a unique name to avoid collisions. - mediaDir := filepath.Join(os.TempDir(), "picoclaw_media") + mediaDir := media.TempDir() if mkdirErr := os.MkdirAll(mediaDir, 0o700); mkdirErr != nil { logger.ErrorCF("feishu", "Failed to create media directory", map[string]any{ "error": mkdirErr.Error(), diff --git a/pkg/channels/matrix/matrix.go b/pkg/channels/matrix/matrix.go index bec5dfdac..4cbe95c5c 100644 --- a/pkg/channels/matrix/matrix.go +++ b/pkg/channels/matrix/matrix.go @@ -35,8 +35,6 @@ const ( roomKindCacheTTL = 5 * time.Minute roomKindCacheCleanupPeriod = 1 * time.Minute roomKindCacheMaxEntries = 2048 - - matrixMediaTempDirName = "picoclaw_media" ) var matrixMentionHrefRegexp = regexp.MustCompile(`(?i)]+href=["']([^"']+)["']`) @@ -1105,7 +1103,7 @@ func (c *MatrixChannel) stripSelfMention(text string) string { } func matrixMediaTempDir() (string, error) { - mediaDir := filepath.Join(os.TempDir(), matrixMediaTempDirName) + mediaDir := media.TempDir() if err := os.MkdirAll(mediaDir, 0o700); err != nil { return "", err } diff --git a/pkg/channels/matrix/matrix_test.go b/pkg/channels/matrix/matrix_test.go index 07a35c021..7484c8d87 100644 --- a/pkg/channels/matrix/matrix_test.go +++ b/pkg/channels/matrix/matrix_test.go @@ -15,6 +15,7 @@ import ( "maunium.net/go/mautrix/id" "github.com/sipeed/picoclaw/pkg/config" + "github.com/sipeed/picoclaw/pkg/media" ) func TestMatrixLocalpartMentionRegexp(t *testing.T) { @@ -165,7 +166,7 @@ func TestMatrixMediaTempDir(t *testing.T) { if err != nil { t.Fatalf("matrixMediaTempDir failed: %v", err) } - if filepath.Base(dir) != matrixMediaTempDirName { + if filepath.Base(dir) != media.TempDirName { t.Fatalf("unexpected media dir base: %q", filepath.Base(dir)) } diff --git a/pkg/media/tempdir.go b/pkg/media/tempdir.go new file mode 100644 index 000000000..45942b34f --- /dev/null +++ b/pkg/media/tempdir.go @@ -0,0 +1,13 @@ +package media + +import ( + "os" + "path/filepath" +) + +const TempDirName = "picoclaw_media" + +// TempDir returns the shared temporary directory used for downloaded media. +func TempDir() string { + return filepath.Join(os.TempDir(), TempDirName) +} diff --git a/pkg/utils/media.go b/pkg/utils/media.go index 3e1c5d88e..82e9f5f45 100644 --- a/pkg/utils/media.go +++ b/pkg/utils/media.go @@ -12,6 +12,7 @@ import ( "github.com/google/uuid" "github.com/sipeed/picoclaw/pkg/logger" + "github.com/sipeed/picoclaw/pkg/media" ) // IsAudioFile checks if a file is an audio file based on its filename extension and content type. @@ -67,7 +68,7 @@ func DownloadFile(urlStr, filename string, opts DownloadOptions) string { opts.LoggerPrefix = "utils" } - mediaDir := filepath.Join(os.TempDir(), "picoclaw_media") + mediaDir := media.TempDir() if err := os.MkdirAll(mediaDir, 0o700); err != nil { logger.ErrorCF(opts.LoggerPrefix, "Failed to create media directory", map[string]any{ "error": err.Error(), From 1bc05e83927ad0f914e96d6546a016f6fb9fbc6f Mon Sep 17 00:00:00 2001 From: Hoshina Date: Sat, 14 Mar 2026 12:02:06 +0800 Subject: [PATCH 06/56] fix(tools): allow sandbox access to temp media files --- pkg/agent/instance.go | 27 +++++++++++- pkg/agent/instance_test.go | 86 +++++++++++++++++++++++++++++++++++++ pkg/agent/loop.go | 3 ++ pkg/tools/filesystem.go | 48 ++++++++++++++++++--- pkg/tools/send_file.go | 17 +++++++- pkg/tools/send_file_test.go | 39 +++++++++++++++++ pkg/tools/shell.go | 44 +++++++++++++------ 7 files changed, 241 insertions(+), 23 deletions(-) diff --git a/pkg/agent/instance.go b/pkg/agent/instance.go index 0c7baa1ee..1c3635322 100644 --- a/pkg/agent/instance.go +++ b/pkg/agent/instance.go @@ -10,6 +10,7 @@ import ( "strings" "github.com/sipeed/picoclaw/pkg/config" + "github.com/sipeed/picoclaw/pkg/media" "github.com/sipeed/picoclaw/pkg/memory" "github.com/sipeed/picoclaw/pkg/providers" "github.com/sipeed/picoclaw/pkg/routing" @@ -66,7 +67,7 @@ func NewAgentInstance( readRestrict := restrict && !defaults.AllowReadOutsideWorkspace // Compile path whitelist patterns from config. - allowReadPaths := compilePatterns(cfg.Tools.AllowReadPaths) + allowReadPaths := buildAllowReadPatterns(cfg) allowWritePaths := compilePatterns(cfg.Tools.AllowWritePaths) toolsRegistry := tools.NewToolRegistry() @@ -82,7 +83,7 @@ func NewAgentInstance( toolsRegistry.Register(tools.NewListDirTool(workspace, readRestrict, allowReadPaths)) } if cfg.Tools.IsToolEnabled("exec") { - execTool, err := tools.NewExecToolWithConfig(workspace, restrict, cfg) + execTool, err := tools.NewExecToolWithConfig(workspace, restrict, cfg, allowReadPaths) if err != nil { log.Fatalf("Critical error: unable to initialize exec tool: %v", err) } @@ -282,6 +283,28 @@ func compilePatterns(patterns []string) []*regexp.Regexp { return compiled } +func buildAllowReadPatterns(cfg *config.Config) []*regexp.Regexp { + var configured []string + if cfg != nil { + configured = cfg.Tools.AllowReadPaths + } + + compiled := compilePatterns(configured) + mediaDirPattern := regexp.MustCompile(mediaTempDirPattern()) + for _, pattern := range compiled { + if pattern.String() == mediaDirPattern.String() { + return compiled + } + } + + return append(compiled, mediaDirPattern) +} + +func mediaTempDirPattern() string { + sep := regexp.QuoteMeta(string(os.PathSeparator)) + return "^" + regexp.QuoteMeta(filepath.Clean(media.TempDir())) + "(?:" + sep + "|$)" +} + // Close releases resources held by the agent's session store. func (a *AgentInstance) Close() error { if a.Sessions != nil { diff --git a/pkg/agent/instance_test.go b/pkg/agent/instance_test.go index 4f41ecd1c..f8057bb2f 100644 --- a/pkg/agent/instance_test.go +++ b/pkg/agent/instance_test.go @@ -1,10 +1,14 @@ package agent import ( + "context" "os" + "path/filepath" + "strings" "testing" "github.com/sipeed/picoclaw/pkg/config" + "github.com/sipeed/picoclaw/pkg/media" ) func TestNewAgentInstance_UsesDefaultsTemperatureAndMaxTokens(t *testing.T) { @@ -160,3 +164,85 @@ func TestNewAgentInstance_ResolveCandidatesFromModelListAlias(t *testing.T) { }) } } + +func TestNewAgentInstance_AllowsMediaTempDirForReadListAndExec(t *testing.T) { + workspace := t.TempDir() + mediaDir := media.TempDir() + if err := os.MkdirAll(mediaDir, 0o700); err != nil { + t.Fatalf("MkdirAll(mediaDir) error = %v", err) + } + + mediaFile, err := os.CreateTemp(mediaDir, "instance-tool-*.txt") + if err != nil { + t.Fatalf("CreateTemp(mediaDir) error = %v", err) + } + mediaPath := mediaFile.Name() + if _, err := mediaFile.WriteString("attachment content"); err != nil { + mediaFile.Close() + t.Fatalf("WriteString(mediaFile) error = %v", err) + } + if err := mediaFile.Close(); err != nil { + t.Fatalf("Close(mediaFile) error = %v", err) + } + t.Cleanup(func() { _ = os.Remove(mediaPath) }) + + cfg := &config.Config{ + Agents: config.AgentsConfig{ + Defaults: config.AgentDefaults{ + Workspace: workspace, + Model: "test-model", + RestrictToWorkspace: true, + }, + }, + Tools: config.ToolsConfig{ + ReadFile: config.ReadFileToolConfig{Enabled: true}, + ListDir: config.ToolConfig{Enabled: true}, + Exec: config.ExecConfig{ + ToolConfig: config.ToolConfig{Enabled: true}, + EnableDenyPatterns: true, + AllowRemote: true, + }, + }, + } + + agent := NewAgentInstance(nil, &cfg.Agents.Defaults, cfg, &mockProvider{}) + + readTool, ok := agent.Tools.Get("read_file") + if !ok { + t.Fatal("read_file tool not registered") + } + readResult := readTool.Execute(context.Background(), map[string]any{"path": mediaPath}) + if readResult.IsError { + t.Fatalf("read_file should allow media temp dir, got: %s", readResult.ForLLM) + } + if !strings.Contains(readResult.ForLLM, "attachment content") { + t.Fatalf("read_file output missing media content: %s", readResult.ForLLM) + } + + listTool, ok := agent.Tools.Get("list_dir") + if !ok { + t.Fatal("list_dir tool not registered") + } + listResult := listTool.Execute(context.Background(), map[string]any{"path": mediaDir}) + if listResult.IsError { + t.Fatalf("list_dir should allow media temp dir, got: %s", listResult.ForLLM) + } + if !strings.Contains(listResult.ForLLM, filepath.Base(mediaPath)) { + t.Fatalf("list_dir output missing media file: %s", listResult.ForLLM) + } + + execTool, ok := agent.Tools.Get("exec") + if !ok { + t.Fatal("exec tool not registered") + } + execResult := execTool.Execute(context.Background(), map[string]any{ + "command": "cat " + filepath.Base(mediaPath), + "working_dir": mediaDir, + }) + if execResult.IsError { + t.Fatalf("exec should allow media temp dir, got: %s", execResult.ForLLM) + } + if !strings.Contains(execResult.ForLLM, "attachment content") { + t.Fatalf("exec output missing media content: %s", execResult.ForLLM) + } +} diff --git a/pkg/agent/loop.go b/pkg/agent/loop.go index dfa339dee..8a0303b50 100644 --- a/pkg/agent/loop.go +++ b/pkg/agent/loop.go @@ -117,6 +117,8 @@ func registerSharedTools( registry *AgentRegistry, provider providers.LLMProvider, ) { + allowReadPaths := buildAllowReadPatterns(cfg) + for _, agentID := range registry.ListAgentIDs() { agent, ok := registry.GetAgent(agentID) if !ok { @@ -195,6 +197,7 @@ func registerSharedTools( cfg.Agents.Defaults.RestrictToWorkspace, cfg.Agents.Defaults.GetMaxMediaSize(), nil, + allowReadPaths, ) agent.Tools.Register(sendFileTool) } diff --git a/pkg/tools/filesystem.go b/pkg/tools/filesystem.go index 6b1cb1475..21385b01b 100644 --- a/pkg/tools/filesystem.go +++ b/pkg/tools/filesystem.go @@ -22,6 +22,10 @@ const MaxReadFileSize = 64 * 1024 // 64KB limit to avoid context overflow // validatePath ensures the given path is within the workspace if restrict is true. func validatePath(path, workspace string, restrict bool) (string, error) { + return validatePathWithAllowPaths(path, workspace, restrict, nil) +} + +func validatePathWithAllowPaths(path, workspace string, restrict bool, patterns []*regexp.Regexp) (string, error) { if workspace == "" { return path, fmt.Errorf("workspace is not defined") } @@ -42,6 +46,10 @@ func validatePath(path, workspace string, restrict bool) (string, error) { } if restrict { + if isAllowedPath(absPath, patterns) { + return absPath, nil + } + if !isWithinWorkspace(absPath, absWorkspace) { return "", fmt.Errorf("access denied: path is outside the workspace") } @@ -73,6 +81,39 @@ func validatePath(path, workspace string, restrict bool) (string, error) { return absPath, nil } +func isAllowedPath(path string, patterns []*regexp.Regexp) bool { + if len(patterns) == 0 { + return false + } + + cleaned := filepath.Clean(path) + if !matchesAllowedPath(cleaned, patterns) { + return false + } + + resolved, err := filepath.EvalSymlinks(cleaned) + if err == nil { + return matchesAllowedPath(resolved, patterns) + } + if os.IsNotExist(err) { + parentResolved, parentErr := resolveExistingAncestor(filepath.Dir(cleaned)) + if parentErr == nil { + return matchesAllowedPath(parentResolved, patterns) + } + } + + return false +} + +func matchesAllowedPath(path string, patterns []*regexp.Regexp) bool { + for _, pattern := range patterns { + if pattern.MatchString(path) { + return true + } + } + return false +} + func resolveExistingAncestor(path string) (string, error) { for current := filepath.Clean(path); ; current = filepath.Dir(current) { if resolved, err := filepath.EvalSymlinks(current); err == nil { @@ -625,12 +666,7 @@ type whitelistFs struct { } func (w *whitelistFs) matches(path string) bool { - for _, p := range w.patterns { - if p.MatchString(path) { - return true - } - } - return false + return matchesAllowedPath(path, w.patterns) } func (w *whitelistFs) ReadFile(path string) ([]byte, error) { diff --git a/pkg/tools/send_file.go b/pkg/tools/send_file.go index 1a03e58ed..a67bd4210 100644 --- a/pkg/tools/send_file.go +++ b/pkg/tools/send_file.go @@ -6,6 +6,7 @@ import ( "mime" "os" "path/filepath" + "regexp" "strings" "github.com/h2non/filetype" @@ -21,20 +22,32 @@ type SendFileTool struct { restrict bool maxFileSize int mediaStore media.MediaStore + allowPaths []*regexp.Regexp defaultChannel string defaultChatID string } -func NewSendFileTool(workspace string, restrict bool, maxFileSize int, store media.MediaStore) *SendFileTool { +func NewSendFileTool( + workspace string, + restrict bool, + maxFileSize int, + store media.MediaStore, + allowPaths ...[]*regexp.Regexp, +) *SendFileTool { if maxFileSize <= 0 { maxFileSize = config.DefaultMaxMediaSize } + var patterns []*regexp.Regexp + if len(allowPaths) > 0 { + patterns = allowPaths[0] + } return &SendFileTool{ workspace: workspace, restrict: restrict, maxFileSize: maxFileSize, mediaStore: store, + allowPaths: patterns, } } @@ -92,7 +105,7 @@ func (t *SendFileTool) Execute(ctx context.Context, args map[string]any) *ToolRe return ErrorResult("media store not configured") } - resolved, err := validatePath(path, t.workspace, t.restrict) + resolved, err := validatePathWithAllowPaths(path, t.workspace, t.restrict, t.allowPaths) if err != nil { return ErrorResult(fmt.Sprintf("invalid path: %v", err)) } diff --git a/pkg/tools/send_file_test.go b/pkg/tools/send_file_test.go index 08d129674..6daaab31c 100644 --- a/pkg/tools/send_file_test.go +++ b/pkg/tools/send_file_test.go @@ -4,6 +4,7 @@ import ( "context" "os" "path/filepath" + "regexp" "strings" "testing" @@ -128,6 +129,44 @@ func TestSendFileTool_CustomFilename(t *testing.T) { } } +func TestSendFileTool_AllowsWhitelistedMediaTempPath(t *testing.T) { + workspace := t.TempDir() + mediaDir := media.TempDir() + if err := os.MkdirAll(mediaDir, 0o700); err != nil { + t.Fatalf("MkdirAll(mediaDir) error = %v", err) + } + + testFile, err := os.CreateTemp(mediaDir, "send-file-*.txt") + if err != nil { + t.Fatalf("CreateTemp(mediaDir) error = %v", err) + } + testPath := testFile.Name() + if _, err := testFile.WriteString("forward me"); err != nil { + testFile.Close() + t.Fatalf("WriteString(testFile) error = %v", err) + } + if err := testFile.Close(); err != nil { + t.Fatalf("Close(testFile) error = %v", err) + } + t.Cleanup(func() { _ = os.Remove(testPath) }) + + pattern := regexp.MustCompile( + "^" + regexp.QuoteMeta(filepath.Clean(mediaDir)) + "(?:" + regexp.QuoteMeta(string(os.PathSeparator)) + "|$)", + ) + + store := media.NewFileMediaStore() + tool := NewSendFileTool(workspace, true, 0, store, []*regexp.Regexp{pattern}) + tool.SetContext("feishu", "chat123") + + result := tool.Execute(context.Background(), map[string]any{"path": testPath}) + if result.IsError { + t.Fatalf("expected whitelisted temp media file to be sendable, got: %s", result.ForLLM) + } + if len(result.Media) != 1 { + t.Fatalf("expected 1 media ref, got %d", len(result.Media)) + } +} + func TestDetectMediaType_MagicBytes(t *testing.T) { dir := t.TempDir() diff --git a/pkg/tools/shell.go b/pkg/tools/shell.go index 9ea05bb12..0dc85ae21 100644 --- a/pkg/tools/shell.go +++ b/pkg/tools/shell.go @@ -23,6 +23,7 @@ type ExecTool struct { denyPatterns []*regexp.Regexp allowPatterns []*regexp.Regexp customAllowPatterns []*regexp.Regexp + allowedPathPatterns []*regexp.Regexp restrictToWorkspace bool allowRemote bool } @@ -95,14 +96,23 @@ var ( } ) -func NewExecTool(workingDir string, restrict bool) (*ExecTool, error) { - return NewExecToolWithConfig(workingDir, restrict, nil) +func NewExecTool(workingDir string, restrict bool, allowPaths ...[]*regexp.Regexp) (*ExecTool, error) { + return NewExecToolWithConfig(workingDir, restrict, nil, allowPaths...) } -func NewExecToolWithConfig(workingDir string, restrict bool, config *config.Config) (*ExecTool, error) { +func NewExecToolWithConfig( + workingDir string, + restrict bool, + config *config.Config, + allowPaths ...[]*regexp.Regexp, +) (*ExecTool, error) { denyPatterns := make([]*regexp.Regexp, 0) customAllowPatterns := make([]*regexp.Regexp, 0) + var allowedPathPatterns []*regexp.Regexp allowRemote := true + if len(allowPaths) > 0 { + allowedPathPatterns = allowPaths[0] + } if config != nil { execConfig := config.Tools.Exec @@ -146,6 +156,7 @@ func NewExecToolWithConfig(workingDir string, restrict bool, config *config.Conf denyPatterns: denyPatterns, allowPatterns: nil, customAllowPatterns: customAllowPatterns, + allowedPathPatterns: allowedPathPatterns, restrictToWorkspace: restrict, allowRemote: allowRemote, }, nil @@ -198,7 +209,7 @@ func (t *ExecTool) Execute(ctx context.Context, args map[string]any) *ToolResult cwd := t.workingDir if wd, ok := args["working_dir"].(string); ok && wd != "" { if t.restrictToWorkspace && t.workingDir != "" { - resolvedWD, err := validatePath(wd, t.workingDir, true) + resolvedWD, err := validatePathWithAllowPaths(wd, t.workingDir, true, t.allowedPathPatterns) if err != nil { return ErrorResult("Command blocked by safety guard (" + err.Error() + ")") } @@ -226,16 +237,20 @@ func (t *ExecTool) Execute(ctx context.Context, args map[string]any) *ToolResult if err != nil { return ErrorResult(fmt.Sprintf("Command blocked by safety guard (path resolution failed: %v)", err)) } - absWorkspace, _ := filepath.Abs(t.workingDir) - wsResolved, _ := filepath.EvalSymlinks(absWorkspace) - if wsResolved == "" { - wsResolved = absWorkspace + if isAllowedPath(resolved, t.allowedPathPatterns) { + cwd = resolved + } else { + absWorkspace, _ := filepath.Abs(t.workingDir) + wsResolved, _ := filepath.EvalSymlinks(absWorkspace) + if wsResolved == "" { + wsResolved = absWorkspace + } + rel, err := filepath.Rel(wsResolved, resolved) + if err != nil || !filepath.IsLocal(rel) { + return ErrorResult("Command blocked by safety guard (working directory escaped workspace)") + } + cwd = resolved } - rel, err := filepath.Rel(wsResolved, resolved) - if err != nil || !filepath.IsLocal(rel) { - return ErrorResult("Command blocked by safety guard (working directory escaped workspace)") - } - cwd = resolved } // timeout == 0 means no timeout @@ -412,6 +427,9 @@ func (t *ExecTool) guardCommand(command, cwd string) string { if safePaths[p] { continue } + if isAllowedPath(p, t.allowedPathPatterns) { + continue + } rel, err := filepath.Rel(cwdPath, p) if err != nil { From 345452fba840d1839e82bab58f9e8894c4844abe Mon Sep 17 00:00:00 2001 From: Hoshina Date: Sat, 14 Mar 2026 12:08:11 +0800 Subject: [PATCH 07/56] refactor(tools): remove unused validatePath wrapper --- pkg/tools/filesystem.go | 5 ----- 1 file changed, 5 deletions(-) diff --git a/pkg/tools/filesystem.go b/pkg/tools/filesystem.go index 21385b01b..d25ec1254 100644 --- a/pkg/tools/filesystem.go +++ b/pkg/tools/filesystem.go @@ -20,11 +20,6 @@ import ( const MaxReadFileSize = 64 * 1024 // 64KB limit to avoid context overflow -// validatePath ensures the given path is within the workspace if restrict is true. -func validatePath(path, workspace string, restrict bool) (string, error) { - return validatePathWithAllowPaths(path, workspace, restrict, nil) -} - func validatePathWithAllowPaths(path, workspace string, restrict bool, patterns []*regexp.Regexp) (string, error) { if workspace == "" { return path, fmt.Errorf("workspace is not defined") From 0c5d7500e8eeff1e734d4d2577e0f822018eea3e Mon Sep 17 00:00:00 2001 From: dataCenter430 <161712630+dataCenter430@users.noreply.github.com> Date: Sat, 14 Mar 2026 05:09:11 +0100 Subject: [PATCH 08/56] feat: expose local file paths for non-image media to enable agent file tools (#1516) * feat: expose local file paths for non-image media to enable agent file tools * fix: Golang Lint error --- pkg/agent/loop.go | 2 +- pkg/agent/loop_media.go | 158 +++++++++++++++++++++++++++------------- pkg/agent/loop_test.go | 149 ++++++++++++++++++++++++++++++++++++- 3 files changed, 256 insertions(+), 53 deletions(-) diff --git a/pkg/agent/loop.go b/pkg/agent/loop.go index dfa339dee..f20a56b9c 100644 --- a/pkg/agent/loop.go +++ b/pkg/agent/loop.go @@ -881,7 +881,7 @@ func (al *AgentLoop) runAgentLoop( opts.ChatID, ) - // Resolve media:// refs to base64 data URLs (streaming) + // Resolve media:// refs: images→base64 data URLs, non-images→local paths in content cfg := al.GetConfig() maxMediaSize := cfg.Agents.Defaults.GetMaxMediaSize() messages = resolveMediaRefs(messages, al.mediaStore, maxMediaSize) diff --git a/pkg/agent/loop_media.go b/pkg/agent/loop_media.go index 82547a008..1380f0214 100644 --- a/pkg/agent/loop_media.go +++ b/pkg/agent/loop_media.go @@ -20,9 +20,10 @@ import ( "github.com/sipeed/picoclaw/pkg/providers" ) -// resolveMediaRefs replaces media:// refs in message Media fields with base64 data URLs. -// Uses streaming base64 encoding (file handle → encoder → buffer) to avoid holding -// both raw bytes and encoded string in memory simultaneously. +// resolveMediaRefs resolves media:// refs in messages. +// Images are base64-encoded into the Media array for multimodal LLMs. +// Non-image files (documents, audio, video) have their local path injected +// into Content so the agent can access them via file tools like read_file. // Returns a new slice; original messages are not mutated. func resolveMediaRefs(messages []providers.Message, store media.MediaStore, maxSize int) []providers.Message { if store == nil { @@ -38,6 +39,8 @@ func resolveMediaRefs(messages []providers.Message, store media.MediaStore, maxS } resolved := make([]string, 0, len(m.Media)) + var pathTags []string + for _, ref := range m.Media { if !strings.HasPrefix(ref, "media://") { resolved = append(resolved, ref) @@ -61,62 +64,117 @@ func resolveMediaRefs(messages []providers.Message, store media.MediaStore, maxS }) continue } - if info.Size() > int64(maxSize) { - logger.WarnCF("agent", "Media file too large, skipping", map[string]any{ - "path": localPath, - "size": info.Size(), - "max_size": maxSize, - }) - continue - } - // Determine MIME type: prefer metadata, fallback to magic-bytes detection - mime := meta.ContentType - if mime == "" { - kind, ftErr := filetype.MatchFile(localPath) - if ftErr != nil || kind == filetype.Unknown { - logger.WarnCF("agent", "Unknown media type, skipping", map[string]any{ - "path": localPath, - }) - continue + mime := detectMIME(localPath, meta) + + if strings.HasPrefix(mime, "image/") { + dataURL := encodeImageToDataURL(localPath, mime, info, maxSize) + if dataURL != "" { + resolved = append(resolved, dataURL) } - mime = kind.MIME.Value - } - - // Streaming base64: open file → base64 encoder → buffer - // Peak memory: ~1.33x file size (buffer only, no raw bytes copy) - f, err := os.Open(localPath) - if err != nil { - logger.WarnCF("agent", "Failed to open media file", map[string]any{ - "path": localPath, - "error": err.Error(), - }) continue } - prefix := "data:" + mime + ";base64," - encodedLen := base64.StdEncoding.EncodedLen(int(info.Size())) - var buf bytes.Buffer - buf.Grow(len(prefix) + encodedLen) - buf.WriteString(prefix) - - encoder := base64.NewEncoder(base64.StdEncoding, &buf) - if _, err := io.Copy(encoder, f); err != nil { - f.Close() - logger.WarnCF("agent", "Failed to encode media file", map[string]any{ - "path": localPath, - "error": err.Error(), - }) - continue - } - encoder.Close() - f.Close() - - resolved = append(resolved, buf.String()) + pathTags = append(pathTags, buildPathTag(mime, localPath)) } result[i].Media = resolved + if len(pathTags) > 0 { + result[i].Content = injectPathTags(result[i].Content, pathTags) + } } return result } + +// detectMIME determines the MIME type from metadata or magic-bytes detection. +// Returns empty string if detection fails. +func detectMIME(localPath string, meta media.MediaMeta) string { + if meta.ContentType != "" { + return meta.ContentType + } + kind, err := filetype.MatchFile(localPath) + if err != nil || kind == filetype.Unknown { + return "" + } + return kind.MIME.Value +} + +// encodeImageToDataURL base64-encodes an image file into a data URL. +// Returns empty string if the file exceeds maxSize or encoding fails. +func encodeImageToDataURL(localPath, mime string, info os.FileInfo, maxSize int) string { + if info.Size() > int64(maxSize) { + logger.WarnCF("agent", "Media file too large, skipping", map[string]any{ + "path": localPath, + "size": info.Size(), + "max_size": maxSize, + }) + return "" + } + + f, err := os.Open(localPath) + if err != nil { + logger.WarnCF("agent", "Failed to open media file", map[string]any{ + "path": localPath, + "error": err.Error(), + }) + return "" + } + defer f.Close() + + prefix := "data:" + mime + ";base64," + encodedLen := base64.StdEncoding.EncodedLen(int(info.Size())) + var buf bytes.Buffer + buf.Grow(len(prefix) + encodedLen) + buf.WriteString(prefix) + + encoder := base64.NewEncoder(base64.StdEncoding, &buf) + if _, err := io.Copy(encoder, f); err != nil { + logger.WarnCF("agent", "Failed to encode media file", map[string]any{ + "path": localPath, + "error": err.Error(), + }) + return "" + } + encoder.Close() + + return buf.String() +} + +// buildPathTag creates a structured tag exposing the local file path. +// Tag type is derived from MIME: [audio:/path], [video:/path], or [file:/path]. +func buildPathTag(mime, localPath string) string { + switch { + case strings.HasPrefix(mime, "audio/"): + return "[audio:" + localPath + "]" + case strings.HasPrefix(mime, "video/"): + return "[video:" + localPath + "]" + default: + return "[file:" + localPath + "]" + } +} + +// injectPathTags replaces generic media tags in content with path-bearing versions, +// or appends if no matching generic tag is found. +func injectPathTags(content string, tags []string) string { + for _, tag := range tags { + var generic string + switch { + case strings.HasPrefix(tag, "[audio:"): + generic = "[audio]" + case strings.HasPrefix(tag, "[video:"): + generic = "[video]" + case strings.HasPrefix(tag, "[file:"): + generic = "[file]" + } + + if generic != "" && strings.Contains(content, generic) { + content = strings.Replace(content, generic, tag, 1) + } else if content == "" { + content = tag + } else { + content += " " + tag + } + } + return content +} diff --git a/pkg/agent/loop_test.go b/pkg/agent/loop_test.go index 1e8d92db8..a6604e87f 100644 --- a/pkg/agent/loop_test.go +++ b/pkg/agent/loop_test.go @@ -1095,7 +1095,7 @@ func TestResolveMediaRefs_SkipsOversizedFile(t *testing.T) { } } -func TestResolveMediaRefs_SkipsUnknownType(t *testing.T) { +func TestResolveMediaRefs_UnknownTypeInjectsPath(t *testing.T) { store := media.NewFileMediaStore() dir := t.TempDir() @@ -1111,7 +1111,11 @@ func TestResolveMediaRefs_SkipsUnknownType(t *testing.T) { result := resolveMediaRefs(messages, store, config.DefaultMaxMediaSize) if len(result[0].Media) != 0 { - t.Fatalf("expected 0 media (unknown type), got %d", len(result[0].Media)) + t.Fatalf("expected 0 media entries, got %d", len(result[0].Media)) + } + expected := "hi [file:" + txtPath + "]" + if result[0].Content != expected { + t.Fatalf("expected content %q, got %q", expected, result[0].Content) } } @@ -1173,3 +1177,144 @@ func TestResolveMediaRefs_UsesMetaContentType(t *testing.T) { t.Fatalf("expected jpeg prefix, got %q", result[0].Media[0][:30]) } } + +func TestResolveMediaRefs_PDFInjectsFilePath(t *testing.T) { + store := media.NewFileMediaStore() + dir := t.TempDir() + + pdfPath := filepath.Join(dir, "report.pdf") + // PDF magic bytes + os.WriteFile(pdfPath, []byte("%PDF-1.4 test content"), 0o644) + ref, _ := store.Store(pdfPath, media.MediaMeta{ContentType: "application/pdf"}, "test") + + messages := []providers.Message{ + {Role: "user", Content: "report.pdf [file]", Media: []string{ref}}, + } + result := resolveMediaRefs(messages, store, config.DefaultMaxMediaSize) + + if len(result[0].Media) != 0 { + t.Fatalf("expected 0 media (non-image), got %d", len(result[0].Media)) + } + expected := "report.pdf [file:" + pdfPath + "]" + if result[0].Content != expected { + t.Fatalf("expected content %q, got %q", expected, result[0].Content) + } +} + +func TestResolveMediaRefs_AudioInjectsAudioPath(t *testing.T) { + store := media.NewFileMediaStore() + dir := t.TempDir() + + oggPath := filepath.Join(dir, "voice.ogg") + os.WriteFile(oggPath, []byte("fake audio"), 0o644) + ref, _ := store.Store(oggPath, media.MediaMeta{ContentType: "audio/ogg"}, "test") + + messages := []providers.Message{ + {Role: "user", Content: "voice.ogg [audio]", Media: []string{ref}}, + } + result := resolveMediaRefs(messages, store, config.DefaultMaxMediaSize) + + if len(result[0].Media) != 0 { + t.Fatalf("expected 0 media, got %d", len(result[0].Media)) + } + expected := "voice.ogg [audio:" + oggPath + "]" + if result[0].Content != expected { + t.Fatalf("expected content %q, got %q", expected, result[0].Content) + } +} + +func TestResolveMediaRefs_VideoInjectsVideoPath(t *testing.T) { + store := media.NewFileMediaStore() + dir := t.TempDir() + + mp4Path := filepath.Join(dir, "clip.mp4") + os.WriteFile(mp4Path, []byte("fake video"), 0o644) + ref, _ := store.Store(mp4Path, media.MediaMeta{ContentType: "video/mp4"}, "test") + + messages := []providers.Message{ + {Role: "user", Content: "clip.mp4 [video]", Media: []string{ref}}, + } + result := resolveMediaRefs(messages, store, config.DefaultMaxMediaSize) + + if len(result[0].Media) != 0 { + t.Fatalf("expected 0 media, got %d", len(result[0].Media)) + } + expected := "clip.mp4 [video:" + mp4Path + "]" + if result[0].Content != expected { + t.Fatalf("expected content %q, got %q", expected, result[0].Content) + } +} + +func TestResolveMediaRefs_NoGenericTagAppendsPath(t *testing.T) { + store := media.NewFileMediaStore() + dir := t.TempDir() + + csvPath := filepath.Join(dir, "data.csv") + os.WriteFile(csvPath, []byte("a,b,c"), 0o644) + ref, _ := store.Store(csvPath, media.MediaMeta{ContentType: "text/csv"}, "test") + + messages := []providers.Message{ + {Role: "user", Content: "here is my data", Media: []string{ref}}, + } + result := resolveMediaRefs(messages, store, config.DefaultMaxMediaSize) + + expected := "here is my data [file:" + csvPath + "]" + if result[0].Content != expected { + t.Fatalf("expected content %q, got %q", expected, result[0].Content) + } +} + +func TestResolveMediaRefs_EmptyContentGetsPathTag(t *testing.T) { + store := media.NewFileMediaStore() + dir := t.TempDir() + + docPath := filepath.Join(dir, "doc.docx") + os.WriteFile(docPath, []byte("fake docx"), 0o644) + docxMIME := "application/vnd.openxmlformats-officedocument.wordprocessingml.document" + ref, _ := store.Store(docPath, media.MediaMeta{ContentType: docxMIME}, "test") + + messages := []providers.Message{ + {Role: "user", Content: "", Media: []string{ref}}, + } + result := resolveMediaRefs(messages, store, config.DefaultMaxMediaSize) + + expected := "[file:" + docPath + "]" + if result[0].Content != expected { + t.Fatalf("expected content %q, got %q", expected, result[0].Content) + } +} + +func TestResolveMediaRefs_MixedImageAndFile(t *testing.T) { + store := media.NewFileMediaStore() + dir := t.TempDir() + + pngPath := filepath.Join(dir, "photo.png") + pngHeader := []byte{ + 0x89, 0x50, 0x4E, 0x47, 0x0D, 0x0A, 0x1A, 0x0A, + 0x00, 0x00, 0x00, 0x0D, 0x49, 0x48, 0x44, 0x52, + 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x01, 0x08, 0x02, + 0x00, 0x00, 0x00, 0x90, 0x77, 0x53, 0xDE, + } + os.WriteFile(pngPath, pngHeader, 0o644) + imgRef, _ := store.Store(pngPath, media.MediaMeta{}, "test") + + pdfPath := filepath.Join(dir, "report.pdf") + os.WriteFile(pdfPath, []byte("%PDF-1.4 test"), 0o644) + fileRef, _ := store.Store(pdfPath, media.MediaMeta{ContentType: "application/pdf"}, "test") + + messages := []providers.Message{ + {Role: "user", Content: "check these [file]", Media: []string{imgRef, fileRef}}, + } + result := resolveMediaRefs(messages, store, config.DefaultMaxMediaSize) + + if len(result[0].Media) != 1 { + t.Fatalf("expected 1 media (image only), got %d", len(result[0].Media)) + } + if !strings.HasPrefix(result[0].Media[0], "data:image/png;base64,") { + t.Fatal("expected image to be base64 encoded") + } + expectedContent := "check these [file:" + pdfPath + "]" + if result[0].Content != expectedContent { + t.Fatalf("expected content %q, got %q", expectedContent, result[0].Content) + } +} From 93369c0011861631abc0d9b70856879a2224ce14 Mon Sep 17 00:00:00 2001 From: horsley Date: Sat, 14 Mar 2026 09:20:49 +0000 Subject: [PATCH 09/56] docs: reorganize README badge layout with docs and wiki links --- README.fr.md | 7 +++++-- README.ja.md | 20 +++++++++++++------- README.md | 6 +++--- README.pt-br.md | 7 +++++-- README.vi.md | 7 +++++-- README.zh.md | 7 +++++-- 6 files changed, 36 insertions(+), 18 deletions(-) diff --git a/README.fr.md b/README.fr.md index 2701627e8..d5fe873bf 100644 --- a/README.fr.md +++ b/README.fr.md @@ -4,15 +4,18 @@

PicoClaw : Assistant IA Ultra-Efficace en Go

Matériel à 10$ · 10 Mo de RAM · Démarrage en 1s · 皮皮虾,我们走!

-

Go Hardware License - Ask DeepWiki
Website + Docs + Wiki +
Twitter + + Discord

[中文](README.zh.md) | [日本語](README.ja.md) | [Português](README.pt-br.md) | [Tiếng Việt](README.vi.md) | [English](README.md) | **Français** diff --git a/README.ja.md b/README.ja.md index 0b84c6036..7fff46d13 100644 --- a/README.ja.md +++ b/README.ja.md @@ -5,13 +5,19 @@

$10 ハードウェア · 10MB RAM · 1秒起動 · 行くぜ、シャコ!

- -

-Go -Hardware -License -Ask DeepWiki -

+

+ Go + Hardware + License +
+ Website + Docs + Wiki +
+ Twitter + + Discord +

[中文](README.zh.md) | **日本語** | [Português](README.pt-br.md) | [Tiếng Việt](README.vi.md) | [Français](README.fr.md) | [English](README.md) diff --git a/README.md b/README.md index 298e854c9..e64daf0e4 100644 --- a/README.md +++ b/README.md @@ -4,16 +4,16 @@

PicoClaw: Ultra-Efficient AI Assistant in Go

$10 Hardware · 10MB RAM · 1s Boot · 皮皮虾,我们走!

-

Go Hardware License - Ask DeepWiki
Website - Twitter + Docs + Wiki
+ Twitter Discord

diff --git a/README.pt-br.md b/README.pt-br.md index e75d1e0c4..3fe24d7ea 100644 --- a/README.pt-br.md +++ b/README.pt-br.md @@ -4,15 +4,18 @@

PicoClaw: Assistente de IA Ultra-Eficiente em Go

Hardware de $10 · 10MB de RAM · Boot em 1s · 皮皮虾,我们走!

-

Go Hardware License - Ask DeepWiki
Website + Docs + Wiki +
Twitter + + Discord

[中文](README.zh.md) | [日本語](README.ja.md) | **Português** | [Tiếng Việt](README.vi.md) | [Français](README.fr.md) | [English](README.md) diff --git a/README.vi.md b/README.vi.md index 2110ddb61..3ee0209f6 100644 --- a/README.vi.md +++ b/README.vi.md @@ -4,15 +4,18 @@

PicoClaw: Trợ lý AI Siêu Nhẹ viết bằng Go

Phần cứng $10 · RAM 10MB · Khởi động 1 giây · Nào, xuất phát!

-

Go Hardware License - Ask DeepWiki
Website + Docs + Wiki +
Twitter + + Discord

[中文](README.zh.md) | [日本語](README.ja.md) | [Português](README.pt-br.md) | **Tiếng Việt** | [Français](README.fr.md) | [English](README.md) diff --git a/README.zh.md b/README.zh.md index 61e890715..66d7c5f7c 100644 --- a/README.zh.md +++ b/README.zh.md @@ -4,15 +4,18 @@

PicoClaw: 基于Go语言的超高效 AI 助手

10$硬件 · 10MB内存 · 1秒启动 · 皮皮虾,我们走!

-

Go Hardware License - Ask DeepWiki
Website + Docs + Wiki +
Twitter + + Discord

**中文** | [日本語](README.ja.md) | [Português](README.pt-br.md) | [Tiếng Việt](README.vi.md) | [Français](README.fr.md) | [English](README.md) From 0f700a6bf054c786d97a58bc944c0388aa33bafc Mon Sep 17 00:00:00 2001 From: Guoguo <16666742+imguoguo@users.noreply.github.com> Date: Sat, 14 Mar 2026 18:36:19 +0800 Subject: [PATCH 10/56] docs: update wechat qrcode (#1564) --- assets/wechat.png | Bin 352888 -> 94960 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/assets/wechat.png b/assets/wechat.png index 4cfcbbb1a8a24f35dfceb8554aee56f2fb1c8ec9..d7881fa4f0c702681c3baf7462d1a5f2ba162aa3 100644 GIT binary patch literal 94960 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 ~AV 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 literal 352888 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νECe-OA-i>O%}aIb@Sb zU0Z2(1yk%`9>;hXV5+pJW`6#UBY=ZNOAn*CQ2N&1F(I@i;jOBsXMdeX((kt_c*+FZFd*c z<;#;n5kHiDOcO)O{?ikOYBF!^86&Km8yV?mgf|^-T8~jntn1PDxupbF;d(6~`3eRV%o!y(S9BU?)hV8?lJqKhh7#SpHgZ|qT#y*ZS?-kpQ&)CneC9uUU)2oWcg z6;+L(l#dW4muory4#!QmHJbM=;>!pjPWqs6%kl8C)KN<{o^;Ii&+Dnns=czq=JUkq z)TwRGGjsLFa2%MeG4uzr6w(y_kib%G{1}O+r94F?a?F#A1c6pyJ0mBsr9PRM%9_lbGxro zws|m!7a_Hrsp#^6IsHI}3ilHd1w4WRfD(RWNrw6xN);~3DLzY;vZZ~qQ0X5F?b2&q zc&}hj=eW$uq8-~cGixK&s7Ll&VEmUsWt*aU&KM;uy@xpaXYa+4hNB z?9XEeF>XUh3_-Z#bmP_?tIMm0;sHAsu~}ilEzVPE=z)b8txirCGK>4Xe9PnJi79r9 zoya<2eC9nKA#(k!R3BAR@d_>?Ml#h>$XN;A`b5qpwrZ$}ozHu8Rntd~FIX0>kQwTG z^OsGYdP0TBCfh(<2w72(Ot#1`^6WkS=sjy)-T|E4&um1@q)tiV{kB|2QwEX%3o5a6 zrl-p3>T=}9M0`zp;DnT}#d+Ad?-vhr`j@_hr;)wDeGh(@^>kE}6_=vhucgp-I1Q-) zWW8(3Tf}U={rMloxLf~z+6^azxt7HHw2?Jz{6OEELygsE<-&rhF{MFVmU#n3v`j7k z#g_Orw#4&G>af@%A+VI*SbY~RrCSK}Lzfkq)%enUh~dI=o7vc}Q6`!mk8SPK(>X_s zO(MM2W#D7olDEW2_G<#n@s~4{3)B4=0SQs!CMIV-`)11ei|ZspfpQUN zt%)Ph5JE}^#q8fK)X<>Xoup~ArC5&qh9*{**{lRb*;-| z4?<|Hr@E^acvX>e!km7(@l_*fW>!jjckZ%bl?c;jvU$`+`%lUsr$+B`ZF84B|m(ESwMA6e@{m0eB|NT6#ch>)}#wzyLD%{uz{tQ^p>2zcU^1 zd|A8d+a+B084A?iSsSO0b#{kC(G6`TAc-lDgf!^``WM@0vIiBBcUY+UJ4x`sj=ui& zbu~h(sVUmEhHZrlQ&U(bfWh|+oW{~gzu$$xBI|33@(~bVscs`3EkTXbTjCf|J!G#) zL?VPg?<#h}GL&XeIeB9{v*_Yerb4q<-49X%ofv-+?0$S;P8ugI8V6NduUj&RB(W|~ z1;x2FzJG`Fn`if8SmepHK62e+Sz8IQ%X{l^r@E}>7)E6pG7N<~bl${8uwGT3X`?qa z98-5}WRjSj=|s-bb8~}%cuKZvYS|67yg;&=a)kNB?G?R(% zo((43K~vr?4nMiH9HH@?9)Y#YWS&huL8g98DlYmChohtFzv(9$ta4LT!#TaiD$EGZ z!8`-Y`WTh%A3_~#SI8;J3uj`}a^&jJ zyy~io^WMs! zfH0nzX{V2kXRD80V~|sw$I0wzbq25bJ^t4WrkkTsQSU(oI5TK@d>ROY^i2i&Pf1FP z?hJ*8)tXNLle-N{zZ1x>ht=Mllhv*+L^|jhPdasHA?1K+0LH`073#NouFz$8Y&w#K zU26d$^+h2AH15*nKF(lhOKh4qn@M-4$HDh+O_xuiWuL$g+hVXH`z}O2K|&KMpWxS= zjw0fX@<;jBkr%N;s4{xLgL}pswxG0t)5NcMH>YdXoT5OYG<%WdMYrCAnV49Tfv*5S}H$xpD!rdxuUCDW3qJMgKP2LqbWVk zH`*O%@z8v+vHtYfafY!EjMmfc^F>I6>`GsU&17x)c)d&dQr9{b0O_?9M*S6H9tJuv z;zR^<^e;N3PWtk>@b}k5$Hfv|7r~;)9(W$h4s-L*{mNUSIM$Vk-M|~~{BrADUrmtY zj`~FTPZ*;Tqo!BgVmea4GzU5H_A&pPwnwu7IJ0;tmJq+@xdNrKJ=0>qE2Gdok&gR+ z6_xh2qS7ue0jbZ@sd4_zU_832gNP4%lgu%-adYFseCVPspA7hi`-QbGwQYRzeW8**am2cT!pQ?4OQZ95^m(jm(C7W$ED&ZR=c}`_PkpIhZ;1|JDY?}lp~8q zK{_S^o&Bl@l+?bSk66M-DU*{Y3x@=KqDIcf?OeD;DXU&W_+STLQ`aCCE}cr^bJTBr zUz=h|nysVW$}e=x4$o}N0DUe^gI>P$9Ce7l+)rayWh?+*N~My_-!DF5ef(V2(t>`OSGuRW-%e>@GcYH|1gMadP)iTiog@x@8x z{?GnTLpB27c8UXh`B5Kc!huTmswym((WR&=4w2#WCg~6oND(A~e^=>}ilFApcI-ZU z23ghJddIQN8#jZyrcpVK>!+lpHa{Kzd;tyNoO6@7d^IqgQ`H6Zlh5@jf%JyM11Grt zacKO>H~DH!L`%4}5E`ypyRvd{-CioH;+I$>C*S|e#2-@Mxq2c#XvxsZoOKjh8=Qii znzS3aBNt^Bx2+cYlU1m{AE!efL@IB6q=t3c9hv2Aa9QiWB=TY!2#)O8V<9jebT)Z0 zubd-v$t(E2f9fmXZr{+=Snr2=o~t|KDW#7c8z&1H=;ktZQC{n$oB2l%q)tD`ZX~mR ze41SH?K^>x<|0pa_}rNE_+`O+IdI&a4U7L%S-+apVgGwd`FqeXRy2d4k8r=o3)A{H z+;&T*lV{s!0(I!Opc3$)ItkF=b03qnc8ZEQN7iba$J^82fNJodee57tZ4BF&zqAuu z|G@>W*W~8RUPudJrY2( z#oc?NvvqJ>-jl9EvLFDO@h#?-yO$LONFhXED%mq5#K`>&++E?iS$(&{W?4VtT+yQNWP+4g znN%+Y#j5NxT~U_STIC2OH)r2O9&h9_Bb5N4svrV{=JpfHuWaBGY2YL8vCZqb$@Y_@ z?Z~~OzGB`milx`;b2<)UtX;>_u}?c@msFB)PMa+dcc{n9)%7fb-G5`;4`YArbd6eMp07^CqC-JGT#y)(Fs*COJvc3A<=9R>NC`q=keh*X>y0|9b<7oV^3^teU$l+$hF%t zxxd&qSjIgbd!>ReO26IAVt#$>lucaK?bV(ORgA7`$5BG(-K`)InPuT%r5-QI+5omM z;>5;4Jr_>hkukH5X9CX--(f9Om4f74#DwBZ8xXL0-aJr`RNy0!aCf(9!Iydh&VF$@ zPg_nXwtv2ckeb|WrrlsC|S7IR?qu0)WLfa53Hil&>9j8ylV{r-mk1` zK&8c-WI?g6n?qM?-0~sEr9+;F!omh`E^K!tCsY*EzInN_@LuYQezTP86g!XTXEu@~ z&`oc67oUh`Rt`BEBD2c1{^T=3SXH8rYE${|T~pF9%$~WW5A=w~jZRd?*&(GFcUL7% zOY)>$Q*>|QHjqECYE%iV-EaVyr8b5+5g8e*r1rSM|Sg-~9K#$Z25jn-qA+TZW%S8;znPz;6``FZA&2hOeorlW$S#K-X zcA(a^9*k0V+*t1TMiVvz(8*T*hjQbMfJ)P*Rlni0z`dI*)A_}0pDZ7`%I<4znnP{E ziX19ONeSV_kAZq3XkSI%FQj;nLoG*Tc?)BN@USYv8>JdlxMcKK@bL%eG^7IG(A`)R zR#i=O%I5sZaI7?~k{Co`{uEbeRb=3auUQImyV)7lr`A*$-J|}Y0o4Yp1wG77i{6rbsV)cn z{urY+h&qLT@|zw3MitJ^aAAn-jB|?MUC1y6eARo|>W{ocho}bR@v?X)&KTZVCzCtW zo1vSEnDtk}Qos+Dl1MwmG1!W~R!^^6GFP7LUY46YXyvL|We0O0U0?M8V?%$0FZ3ND z5nu`suj6}iS|=5ulgYAN2P0=5HlsbovB!qheU+>(1(wQXdtH8qZa3FG)yjI`i_x3} z%)FiVI2c}n`Ygi)!Jtw3-m^Y{gaGplhWQ#k3Ax2_y*49L)VIRAsb&kk5Os!h6ZMVn za&BQ04Z{tOhq_-GN_9VeALO3M5EeEtSXo{27a?P7Pi3?HnuPzs0_uKKVUxGi?LVqb zpIf!zDwG4^f1D0HE>a8Fmj0FZxv-_{x*#F2c*YL$xLU20=JLB6P+^a8l;uPxr1K4m z!h!Q?W3=2pBP0SmD-)uqD+o6q{Q|qUn-+VlLaygg`Bb-Ro(wu{gYg4cSj%x>VJ-hQ z<^9SXkV5)WHvf#BdLbTnq}8Nf<7pjZ4zQO2-$FzfJ*d7D6rGaRPtlv(W6imG{~+}= z;CQMQ3oTKu^{pp?uZ>TqRxyiL>1pjfQPxfPIs?i zGypDcsdcf(;qVSy~V? zF>!MuYb}aOfe&*9L8R5W_}avBD`8I?#r+!E(1jrw=b19avqN{NaSLRk@va9ZXWR|{ zRe)ATCp*trb7-C#_)Pq$gjmz|f zCWo>2R`%Up6}bmL#ym<21?K*$VsJ;QAQ6ctY$}lj>|Dler zXj84q)0S#BylGO{dfi~%uC13*Wogi2(7gVZL92)3b{6Kx&H24r9Ijui(u>qchC&7glmP9EAc7ISa7<6jU>``0&0e>hr-It(m_IkZJp z(V)OUT2vX?pLr-#Qnoq%=B?<`d*=ILbE{vO*ShT=RS)V?O;l~Gnh3Gr&~z$N!lJ1B zTaGJi(7VECq|9tWiIE_HZocHl|G!vAMuS7f(n|JdIC09qBPz9@l|9Ak0geBr8aa60 zN%VmA20t86QdWP9YV$!SQ@fnxv7Du;V)R|CWP!De&MuJ>Fe7`N#8f|%Df|0xsSks< zl;k8D!^-rrwCIK9${4k&_^bmO=d<1u3eQ3Ine(94Z<)AEU0{$q#P!iIB`CY@Yd& z;0Rfv10%#UE^59ZYoE{d!N&r4P1%ZB1q?0amy$3?kFMU9N=2M&Acd;h@KBJN@h`Fl zYiB9ZV_J*_&c{VR7D#?#F8UKuMp3q&AK=FKfZv()Mx#x=-+sNR%qba_ixu~!Z;uL1 zkN^?vtx;Ay-)zT8r$3YG%%$+dSTK$&;*A4Vh?%YR1*TxhsBV2F4?$>j4R_DJ(YP=n ziA>TALYyMN{E0VK#Tf-eja4*G&PF^XcS$<*H2BDLUD)+AzX|{Ge<;iL6=m7}Ed2w^ z0s%>?a`g@F^IsBz<3{P{RmzZ_pre%0J7>ZSCQr;VCOH+knJudPuhfbp;q^FGf8-;| zz7uQnV$GEO0Vv|Tz^e=vAaHUrzSCer`(u6Xv$UT+Gq0Oo(c|codlDH{WqvUuNg(r2 z`Dci$j%>spGy41Y=k}>YFCRvB9U(}+`oYF_*gE-cugGsn5}gL zLPVjNoCYi~Q}ef}dhhz;o7Q|lsLwmld;VKr68I2KdLU;3u0J{IjdT83CJlXivuSxPl;-2jhTY7T zaxXo30F!KKb!06-r71G&)I5>};1ASfaAzs1>+6Us5yhl~F}o$f@lO}Y3wngM=gA|~K4VDcrCJ46js$sA9$+*O zr1pA;_pr~`%OFf1B@cCd5h- zeyERlZW{@4AkgBYsAJkBu(5IG!WqMXjgKr6(6G)inaejP=Rq%hmKZ&kArvtGVYkhOk21Z?Ug?20qNCu5Uc~r(m(anO#-{VdZG6P z$81bj!w+#&e|6C<7MA)c=cR62j-Qgcjl|751E@Y8RH81uQ!8uS@D(A!+qXnt(-UTcKi>I&g>nrKMy1#B9Q7Ds{BMmH0h&qlukoAWvE9s3jFL+@ ziC~sHIp&_0^}M$Q32ycKA3Z;(g=Enho!Bx%p@bGTIMsG;HSfdF>M@!v#pcd|j(M}J zN8q8W7Yi-sAq9$3qRMQ(I>?~ASPVq(Tnd`TjD?t*)WD;SN`hasy-h@B;`SST4M@ z=*n^BT5jrXmDknOMMHgD{bT^6&nOpvW}As>iVi+*@+6-WOWWFOxCLZK|JO-)UbP0E zLPmC2fTkqiDq{@!y6QG$c>>P2_Xt8WCx*Gr;4-T@pPM)q*PG1y&CNcMK11qA z=D{=0*XbyP+*kHR>s{gEtb|DimWzhbf)TmMM$Dk79Q@1U>vmjx2#ktj#M*3t%-NlI z$~GSjXiRx2`3R`t&qQo}CM=h2vCOH+9C!fCiw3y9)V$BBx$gxn7g&ibS#@s=rIgwP zPPC7e1P5wzecn%Wk$pYazq7$54NrH%yIxqj@#Pwt`yy&ul`hEs*O8UZVi_VFFr<+P zVM;J6EVj~H?DhgbWNrR($2Tn${k^_7NwxiJA`=4YMusDa)kWlEsWn4~*e}=%k$TKq zwdBMN0iBWmIGV98$ptm`w0C_z*h$lWnu-#;F=W9eb?_f#GHm8YaVYq0r^}kg@AC?J z)n7rcx~WRR>qjmw3W=vk5;-zgGN?7vG2D&SRRQnjZ5Rb%h;!xANqRN=)!~#cU&a)D z;~>xRH%>>FVX?31um>enm`n!h;~`8}=b{e2L4(xy;Vr3iGn)zyw`oC9f&#RoH*|r6 z>466*3zVGj2pJ=iPxp=XSS`HX;uHxP8ueNkMKdUd4A%9VOz%iDO;WGWoCNidlrSru z(ygDEa5O$VP>V@*I3+Sw0upf`W3yF%)lXRdWWmLpk+rcq zGn`;;4-NV%t&qMUg1J$59{qG=sGUo5oNa9%)5>7+XD6+FdK41z&;{_^@tH7hXu|p= zVG)s2tr+5P__fpBR=t$Vsk~XC%M_Em4S~0HPLFD~#yzI#kYxsX;2T~xRod9$<8tY^xV9V`OVwb@@ONzxp$l`oQ6tbCM?FK* zDRxF!1U{e8KplE=;xt}~K=h17^MAboc9ALgn$d#WOQx{e*cl>WCT^&7v~H?~QN$Ti z{*KX(PMmMx+*gQXYG|t{qu}u-AI}+%8=c|0<3zH@BIenbhf-Df+orxLF~E>zR{^<$ zsZU{!jq=4E%(Tz7bafj7ldf*zje#mKuzL%Vn8-q7YLZGc zcmIqbHhfi<8Lb8-z@dZfq|X@9a&#(Ip`w4Uq+Q0*5kJGK6?JE_X@UEWmx!Y57alVD zUlBpyy`V5i*A5U}20Ii@e#2rl_K0-l&tbFe+QGb z3~MR(CMGMsOltCEuigPOu_*X=_Ws50k7Db1($SZs+)wtP;IWiCxh)#vzP_E{23q2+i+sa3(90z-76;%fm9jdr)nU1v7NE( zjyR-Xv*&_o3o1%6%HzO@-qwleyIB(E##TBY*QR>Y>Q?w;D5j^FE~CSt<$GjhPmA!< zH%hEuvr*+kN&|FVEoke~qX++y)cp7#|FwOU6>QI^7GBxOdjw90ZlqKuH%Yhg#q8lE z`@&wMwnTGZCgPW@$KSAN-U@|AH|?i(Y^vD;vfM{c!pTxXzP`%fVqP9RX%h_JzJ56AqyW0e*G4S;?Q6iyz=}7DUAlJNE68(|$ zo;b(aFm6Ykvn+968+10F9cOcyVVXBtsZ;ChbgK^78?42SB&6O;am42%o3Cktc%%B3 z>CbKFya!Z`h<6+dzjs%&O4cT{R8%hQRTPA)BJC3Z{X`6R;~_)DnK(dE=<>E|SwC@f zbgm|Ni?hMjTMc39*ddf0SVrq-Ib!i(&YhMRcQpt_wJl#R;EkfZ1V9Nm@J;wXCq(+C z|DSl)F9$1b{c-|3Fx>|ZNxk^GXKepity6P`?uxNf+X6TE9UN4>DY?LfxEjFnX4%n; z56N7gMZSJu7VPEAAtE5~@iPa}Z*q$3=FfdPj3CpDuMydTeL(!LUbQhN&B~Qb)+;DW zAJ^=^DOIuZRH!1#juO#ge~zJvp*W+PJIJh0iDAaQd3*}2px|u4!cI_^!`s7Lxov?F zpm!0$V*Q-bE+b~(WC0ImRtf{-N{PYGMrJ023&~tH;yKg1a~VY1B0zouJQW5x=#sCW zr$F16M=0fUBJ7E!6Z_gNBCJoXV zq`hn!ovwpj>GvnSEbA@%$sxkktITOE?{VJi5rw?t7>~%e`o~NfTx^-MR59^Nq-Fj* z(ZFtfpDfbfy?#hi2Zt2Ie`S4Uz;BGgp*Hk@@(?)r2XU=Xs@ar->)_He5*_j4F@m;= z5D@=prYGCU5#VvG?|)Pj-}_~*!BUVJ(+-J%>_UD#oE^*9dOPNT5Olfd#@;Z39JpM& zpC683S5upF(;^-q3Y8C+!e&dL3S&|SO;XrHi(>oeI@Xwl_o z$AV=Me9!k$x&rS@p0AI764-CTNQKEOsW3US+Ijt0N2$Y#G*i9P zE_9`Od-H*B5ih2ht7%eI$bsE@a?Ms`S)A;Il5BNJ7zYUsU}YrRr|iAHbj%voK4|Ne zZVRB}KCY0}Ptlu`H2Av`3hj0{qRJf$n$MkrtsZ?E)9H4<+?_1i_=bj%gEo>dRTzME zlG0fVZ5e|@lh=ThlTsyPevmV;sL`9NdRaIvQPS~Y^>6Pye^A1^fm&dPpybA=G@Y0x>(`;6h_K@{EwR6hS(*_1ED_Y!-Hc9!FOW7!9mm+!!sA*jn6t>mny@9tF zkBa?7{Fm$HQ!O>ow#G(jr{l(%LyUxYtlO|KDNDW#5LN=#&EJO*Q#`}`o;KdaHkqWQ z-y}Nn?XmtAU2osMJ+1)s*J0)@uSuPVr2Jpu`2V1y{ADc%a+XijH|P8;1zkREg*9v0xIvg|iy0=IaV5Ys5z@rtfPbilDje)n zBj_OLQJMqEt>9H#JY=lLt@xo(I+tb=NUS!fchIks0+sxg%^KvXZ^$VwTxN!`fkQHpM|r z>@sohA#4(4rBor;VS`^8*55DebLvX8OPK!zEDLD=OD`0;*DsXwKk^{(3bh1^8988? zv__6l6=tU8#BrWNtcsQCM3JmCqs?jvu)dr~BlV}9f%)+4s)j9HgRDM@`r3q>Z1xIK zsAL+1Ie)Rzd~ZFd1vwaa;sGnWi;qWsmRsWYvQ(M3?-Qf5nY6xR$o>3y;{;T$O17cz zKb$1x$4ZD#H_8!h?U09F`W|L2`(F0;F_ljY&7@n7GQAu+D&+ynLI29R31bJUFBQ{T7hM1!omC+J%GbC1uzR4Gi|fy*7ThUS*Bf z4>nv5mA!#hzf2T!aV(m*04E<=11=j>ai`{X$4Wz1`CTx&3G{?V7*`#Y*UB>|oN%wO z1!F6(;`|t#jRck&H2~tJ?cdgdx3JJc;5)6ijY|t9e(?mUK>Azqm-u|yDG9BhR(d

E!BtsbA)M4DS3exufDt_$*1#cZv{`V(nz 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

-N2B#AUJ4(fC(0#c;Uk_(&L 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%0D4*Z(UO_`MTN#2r)@MAVxyO(2Nm)0Gd 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 From bb1a4145274c78e1b8267af89a1816cd7b0107f5 Mon Sep 17 00:00:00 2001 From: Hoshina Date: Sat, 14 Mar 2026 19:58:23 +0800 Subject: [PATCH 11/56] fix(tools): harden whitelist path resolution --- pkg/tools/filesystem.go | 42 +++++++++++++++++++++++-------- pkg/tools/filesystem_test.go | 49 ++++++++++++++++++++++++++++++++++++ 2 files changed, 80 insertions(+), 11 deletions(-) diff --git a/pkg/tools/filesystem.go b/pkg/tools/filesystem.go index d25ec1254..92946ef98 100644 --- a/pkg/tools/filesystem.go +++ b/pkg/tools/filesystem.go @@ -82,22 +82,19 @@ func isAllowedPath(path string, patterns []*regexp.Regexp) bool { } cleaned := filepath.Clean(path) + if !filepath.IsAbs(cleaned) { + return false + } if !matchesAllowedPath(cleaned, patterns) { return false } - resolved, err := filepath.EvalSymlinks(cleaned) - if err == nil { - return matchesAllowedPath(resolved, patterns) - } - if os.IsNotExist(err) { - parentResolved, parentErr := resolveExistingAncestor(filepath.Dir(cleaned)) - if parentErr == nil { - return matchesAllowedPath(parentResolved, patterns) - } + resolved, err := resolvePathAgainstExistingAncestor(cleaned) + if err != nil { + return false } - return false + return matchesAllowedPath(resolved, patterns) } func matchesAllowedPath(path string, patterns []*regexp.Regexp) bool { @@ -122,6 +119,29 @@ func resolveExistingAncestor(path string) (string, error) { } } +func resolvePathAgainstExistingAncestor(path string) (string, error) { + cleaned := filepath.Clean(path) + for current := cleaned; ; current = filepath.Dir(current) { + resolved, err := filepath.EvalSymlinks(current) + if err == nil { + suffix, relErr := filepath.Rel(current, cleaned) + if relErr != nil { + return "", relErr + } + if suffix == "." { + return filepath.Clean(resolved), nil + } + return filepath.Clean(filepath.Join(resolved, suffix)), nil + } + if !os.IsNotExist(err) { + return "", err + } + if filepath.Dir(current) == current { + return "", os.ErrNotExist + } + } +} + func isWithinWorkspace(candidate, workspace string) bool { rel, err := filepath.Rel(filepath.Clean(workspace), filepath.Clean(candidate)) return err == nil && filepath.IsLocal(rel) @@ -661,7 +681,7 @@ type whitelistFs struct { } func (w *whitelistFs) matches(path string) bool { - return matchesAllowedPath(path, w.patterns) + return isAllowedPath(path, w.patterns) } func (w *whitelistFs) ReadFile(path string) ([]byte, error) { diff --git a/pkg/tools/filesystem_test.go b/pkg/tools/filesystem_test.go index 0bbf6caf0..78d69273f 100644 --- a/pkg/tools/filesystem_test.go +++ b/pkg/tools/filesystem_test.go @@ -521,6 +521,55 @@ func TestWhitelistFs_AllowsMatchingPaths(t *testing.T) { } } +func TestWhitelistFs_BlocksSymlinkEscapeInAllowedDir(t *testing.T) { + workspace := t.TempDir() + allowedDir := t.TempDir() + secretDir := t.TempDir() + secretFile := filepath.Join(secretDir, "secret.txt") + if err := os.WriteFile(secretFile, []byte("top secret"), 0o644); err != nil { + t.Fatalf("WriteFile(secretFile) error = %v", err) + } + + linkPath := filepath.Join(allowedDir, "link_out") + if err := os.Symlink(secretDir, linkPath); err != nil { + t.Skipf("symlink not supported in this environment: %v", err) + } + + patterns := []*regexp.Regexp{regexp.MustCompile(`^` + regexp.QuoteMeta(allowedDir))} + tool := NewReadFileTool(workspace, true, MaxReadFileSize, patterns) + + result := tool.Execute(context.Background(), map[string]any{"path": filepath.Join(linkPath, "secret.txt")}) + if !result.IsError { + t.Fatalf("expected symlink escape from allowed dir to be blocked, got: %s", result.ForLLM) + } +} + +func TestWhitelistFs_WriteAllowsNewFileUnderAllowedDir(t *testing.T) { + workspace := t.TempDir() + rootDir := t.TempDir() + allowedDir := filepath.Join(rootDir, "allowed") + targetFile := filepath.Join(allowedDir, "nested", "file.txt") + + patterns := []*regexp.Regexp{regexp.MustCompile(`^` + regexp.QuoteMeta(allowedDir))} + tool := NewWriteFileTool(workspace, true, patterns) + + result := tool.Execute(context.Background(), map[string]any{ + "path": targetFile, + "content": "outside write", + }) + if result.IsError { + t.Fatalf("expected whitelisted write to succeed, got: %s", result.ForLLM) + } + + data, err := os.ReadFile(targetFile) + if err != nil { + t.Fatalf("ReadFile(targetFile) error = %v", err) + } + if string(data) != "outside write" { + t.Fatalf("target file content = %q, want %q", string(data), "outside write") + } +} + // TestReadFileTool_ChunkedReading verifies the pagination logic of the tool // by reading a file in multiple chunks using 'offset' and 'length'. func TestReadFileTool_ChunkedReading(t *testing.T) { From f71eaaf7f8d8189319453314c157d3ab969798a4 Mon Sep 17 00:00:00 2001 From: Hoshina Date: Sat, 14 Mar 2026 21:03:23 +0800 Subject: [PATCH 12/56] fix(cron): default scheduled jobs to agent execution --- pkg/tools/cron.go | 6 +++--- pkg/tools/cron_test.go | 22 ++++++++++++++++++++++ 2 files changed, 25 insertions(+), 3 deletions(-) diff --git a/pkg/tools/cron.go b/pkg/tools/cron.go index 648cc3c6c..25608a54c 100644 --- a/pkg/tools/cron.go +++ b/pkg/tools/cron.go @@ -96,7 +96,7 @@ func (t *CronTool) Parameters() map[string]any { }, "deliver": map[string]any{ "type": "boolean", - "description": "If true, send message directly to channel. If false, let agent process message (for complex tasks). Default: true", + "description": "If true, send message directly to channel. If false, let agent process message (for complex tasks). Default: false", }, }, "required": []string{"action"}, @@ -174,8 +174,8 @@ func (t *CronTool) addJob(ctx context.Context, args map[string]any) *ToolResult return ErrorResult("one of at_seconds, every_seconds, or cron_expr is required") } - // Read deliver parameter, default to true - deliver := true + // Read deliver parameter, default to false so scheduled tasks execute through the agent + deliver := false if d, ok := args["deliver"].(bool); ok { deliver = d } diff --git a/pkg/tools/cron_test.go b/pkg/tools/cron_test.go index 1776abc65..f1e857949 100644 --- a/pkg/tools/cron_test.go +++ b/pkg/tools/cron_test.go @@ -114,3 +114,25 @@ func TestCronTool_NonCommandJobAllowedFromRemoteChannel(t *testing.T) { t.Fatalf("expected non-command reminder to succeed from remote channel, got: %s", result.ForLLM) } } + +func TestCronTool_NonCommandJobDefaultsDeliverToFalse(t *testing.T) { + tool := newTestCronTool(t) + ctx := WithToolContext(context.Background(), "telegram", "chat-1") + result := tool.Execute(ctx, map[string]any{ + "action": "add", + "message": "send me a poem", + "at_seconds": float64(600), + }) + + if result.IsError { + t.Fatalf("expected non-command reminder to succeed, got: %s", result.ForLLM) + } + + jobs := tool.cronService.ListJobs(false) + if len(jobs) != 1 { + t.Fatalf("expected 1 job, got %d", len(jobs)) + } + if jobs[0].Payload.Deliver { + t.Fatal("expected deliver=false by default for non-command jobs") + } +} From 5fb4b3bedf47735cdaaaab199ce3031ca6f8459f Mon Sep 17 00:00:00 2001 From: Kunal Karmakar <5303824+kunalk16@users.noreply.github.com> Date: Sat, 14 Mar 2026 20:22:34 +0530 Subject: [PATCH 13/56] feat(provider): add support for azure openai provider (#1422) * Add support for azure openai provider * Add checks for deployment model name * Apply suggestion from @Copilot Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Addressing @Copilot suggestion to remove the init() function which seemed redundant * Fix readme * Fix linting checks --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- README.fr.md | 1 + README.ja.md | 1 + README.md | 2 + README.pt-br.md | 1 + README.vi.md | 1 + README.zh.md | 1 + config/config.example.json | 6 + pkg/config/defaults.go | 9 + pkg/providers/azure/provider.go | 150 +++++ pkg/providers/azure/provider_test.go | 232 ++++++++ pkg/providers/common/common.go | 380 +++++++++++++ pkg/providers/common/common_test.go | 558 +++++++++++++++++++ pkg/providers/factory_provider.go | 19 + pkg/providers/factory_provider_test.go | 72 +++ pkg/providers/openai_compat/provider.go | 327 +---------- pkg/providers/openai_compat/provider_test.go | 9 +- 16 files changed, 1446 insertions(+), 323 deletions(-) create mode 100644 pkg/providers/azure/provider.go create mode 100644 pkg/providers/azure/provider_test.go create mode 100644 pkg/providers/common/common.go create mode 100644 pkg/providers/common/common_test.go diff --git a/README.fr.md b/README.fr.md index d5fe873bf..49a02fb77 100644 --- a/README.fr.md +++ b/README.fr.md @@ -991,6 +991,7 @@ Cette conception permet également le **support multi-agent** avec une sélectio | **BytePlus** | `byteplus/` | `https://ark.ap-southeast.bytepluses.com/api/v3` | OpenAI | [Obtenir Clé](https://www.byteplus.com/) | | **LongCat** | `longcat/` | `https://api.longcat.chat/openai` | OpenAI | [Obtenir une clé](https://longcat.chat/platform) | | **ModelScope (魔搭)**| `modelscope/` | `https://api-inference.modelscope.cn/v1` | OpenAI | [Obtenir un Token](https://modelscope.cn/my/tokens) | +| **Azure OpenAI** | `azure/` | `https://{resource}.openai.azure.com` | Azure | [Obtenir Clé](https://portal.azure.com) | | **Antigravity** | `antigravity/` | Google Cloud | Custom | OAuth uniquement | | **GitHub Copilot** | `github-copilot/` | `localhost:4321` | gRPC | - | diff --git a/README.ja.md b/README.ja.md index 7fff46d13..c0d27de4f 100644 --- a/README.ja.md +++ b/README.ja.md @@ -935,6 +935,7 @@ HEARTBEAT_OK 応答 ユーザーが直接結果を受け取る | **BytePlus** | `byteplus/` | `https://ark.ap-southeast.bytepluses.com/api/v3` | OpenAI | [キーを取得](https://www.byteplus.com) | | **LongCat** | `longcat/` | `https://api.longcat.chat/openai` | OpenAI | [キーを取得](https://longcat.chat/platform) | | **ModelScope (魔搭)**| `modelscope/` | `https://api-inference.modelscope.cn/v1` | OpenAI | [トークンを取得](https://modelscope.cn/my/tokens) | +| **Azure OpenAI** | `azure/` | `https://{resource}.openai.azure.com` | Azure | [キーを取得](https://portal.azure.com) | | **Antigravity** | `antigravity/` | Google Cloud | カスタム | OAuthのみ | | **GitHub Copilot** | `github-copilot/` | `localhost:4321` | gRPC | - | diff --git a/README.md b/README.md index e64daf0e4..159ac706f 100644 --- a/README.md +++ b/README.md @@ -1006,6 +1006,7 @@ The subagent has access to tools (message, web_search, etc.) and can communicate | `groq` | LLM + **Voice transcription** (Whisper) | [console.groq.com](https://console.groq.com) | | `cerebras` | LLM (Cerebras direct) | [cerebras.ai](https://cerebras.ai) | | `vivgrid` | LLM (Vivgrid direct) | [vivgrid.com](https://vivgrid.com) | +| `azure` | LLM (Azure OpenAI) | [portal.azure.com](https://portal.azure.com) | ### Model Configuration (model_list) @@ -1042,6 +1043,7 @@ This design also enables **multi-agent support** with flexible provider selectio | **Vivgrid** | `vivgrid/` | `https://api.vivgrid.com/v1` | OpenAI | [Get Key](https://vivgrid.com) | | **LongCat** | `longcat/` | `https://api.longcat.chat/openai` | OpenAI | [Get Key](https://longcat.chat/platform) | | **ModelScope (魔搭)**| `modelscope/` | `https://api-inference.modelscope.cn/v1` | OpenAI | [Get Token](https://modelscope.cn/my/tokens) | +| **Azure OpenAI** | `azure/` | `https://{resource}.openai.azure.com` | Azure | [Get Key](https://portal.azure.com) | | **Antigravity** | `antigravity/` | Google Cloud | Custom | OAuth only | | **GitHub Copilot** | `github-copilot/` | `localhost:4321` | gRPC | - | diff --git a/README.pt-br.md b/README.pt-br.md index 3fe24d7ea..56946139b 100644 --- a/README.pt-br.md +++ b/README.pt-br.md @@ -987,6 +987,7 @@ Este design também possibilita o **suporte multi-agent** com seleção flexíve | **BytePlus** | `byteplus/` | `https://ark.ap-southeast.bytepluses.com/api/v3` | OpenAI | [Obter Chave](https://www.byteplus.com) | | **LongCat** | `longcat/` | `https://api.longcat.chat/openai` | OpenAI | [Obter Chave](https://longcat.chat/platform) | | **ModelScope (魔搭)**| `modelscope/` | `https://api-inference.modelscope.cn/v1` | OpenAI | [Obter Token](https://modelscope.cn/my/tokens) | +| **Azure OpenAI** | `azure/` | `https://{resource}.openai.azure.com` | Azure | [Obter Chave](https://portal.azure.com) | | **Antigravity** | `antigravity/` | Google Cloud | Custom | Apenas OAuth | | **GitHub Copilot** | `github-copilot/` | `localhost:4321` | gRPC | - | diff --git a/README.vi.md b/README.vi.md index 3ee0209f6..a542d6507 100644 --- a/README.vi.md +++ b/README.vi.md @@ -956,6 +956,7 @@ Thiết kế này cũng cho phép **hỗ trợ đa tác nhân** với lựa ch | **BytePlus** | `byteplus/` | `https://ark.ap-southeast.bytepluses.com/api/v3` | OpenAI | [Lấy Khóa](https://www.byteplus.com) | | **LongCat** | `longcat/` | `https://api.longcat.chat/openai` | OpenAI | [Lấy Key](https://longcat.chat/platform) | | **ModelScope (魔搭)**| `modelscope/` | `https://api-inference.modelscope.cn/v1` | OpenAI | [Lấy Token](https://modelscope.cn/my/tokens) | +| **Azure OpenAI** | `azure/` | `https://{resource}.openai.azure.com` | Azure | [Lấy Khóa](https://portal.azure.com) | | **Antigravity** | `antigravity/` | Google Cloud | Tùy chỉnh | Chỉ OAuth | | **GitHub Copilot** | `github-copilot/` | `localhost:4321` | gRPC | - | diff --git a/README.zh.md b/README.zh.md index 66d7c5f7c..9877ef9f4 100644 --- a/README.zh.md +++ b/README.zh.md @@ -528,6 +528,7 @@ Agent 读取 HEARTBEAT.md | **BytePlus** | `byteplus/` | `https://ark.ap-southeast.bytepluses.com/api/v3` | OpenAI | [获取密钥](https://www.byteplus.com) | | **LongCat** | `longcat/` | `https://api.longcat.chat/openai` | OpenAI | [获取密钥](https://longcat.chat/platform) | | **ModelScope (魔搭)**| `modelscope/` | `https://api-inference.modelscope.cn/v1` | OpenAI | [获取 Token](https://modelscope.cn/my/tokens) | +| **Azure OpenAI** | `azure/` | `https://{resource}.openai.azure.com` | Azure | [获取密钥](https://portal.azure.com) | | **Antigravity** | `antigravity/` | Google Cloud | 自定义 | 仅 OAuth | | **GitHub Copilot** | `github-copilot/` | `localhost:4321` | gRPC | - | diff --git a/config/config.example.json b/config/config.example.json index 094aa46df..1c11cd42a 100644 --- a/config/config.example.json +++ b/config/config.example.json @@ -53,6 +53,12 @@ "api_key": "your-modelscope-access-token", "api_base": "https://api-inference.modelscope.cn/v1" }, + { + "model_name": "azure-gpt5", + "model": "azure/my-gpt5-deployment", + "api_key": "your-azure-api-key", + "api_base": "https://your-resource.openai.azure.com" + }, { "model_name": "loadbalanced-gpt-5.4", "model": "openai/gpt-5.4", diff --git a/pkg/config/defaults.go b/pkg/config/defaults.go index 189af0a84..dc534d852 100644 --- a/pkg/config/defaults.go +++ b/pkg/config/defaults.go @@ -384,6 +384,15 @@ func DefaultConfig() *Config { APIBase: "http://localhost:8000/v1", APIKey: "", }, + + // Azure OpenAI - https://portal.azure.com + // model_name is a user-friendly alias; the model field's path after "azure/" is your deployment name + { + ModelName: "azure-gpt5", + Model: "azure/my-gpt5-deployment", + APIBase: "https://your-resource.openai.azure.com", + APIKey: "", + }, }, Gateway: GatewayConfig{ Host: "127.0.0.1", diff --git a/pkg/providers/azure/provider.go b/pkg/providers/azure/provider.go new file mode 100644 index 000000000..6e1d07e78 --- /dev/null +++ b/pkg/providers/azure/provider.go @@ -0,0 +1,150 @@ +package azure + +import ( + "bytes" + "context" + "encoding/json" + "fmt" + "net/http" + "net/url" + "strings" + "time" + + "github.com/sipeed/picoclaw/pkg/providers/common" + "github.com/sipeed/picoclaw/pkg/providers/protocoltypes" +) + +type ( + LLMResponse = protocoltypes.LLMResponse + Message = protocoltypes.Message + ToolDefinition = protocoltypes.ToolDefinition +) + +const ( + // azureAPIVersion is the Azure OpenAI API version used for all requests. + azureAPIVersion = "2024-10-21" + defaultRequestTimeout = common.DefaultRequestTimeout +) + +// Provider implements the LLM provider interface for Azure OpenAI endpoints. +// It handles Azure-specific authentication (api-key header), URL construction +// (deployment-based), and request body formatting (max_completion_tokens, no model field). +type Provider struct { + apiKey string + apiBase string + httpClient *http.Client +} + +// Option configures the Azure Provider. +type Option func(*Provider) + +// WithRequestTimeout sets the HTTP request timeout. +func WithRequestTimeout(timeout time.Duration) Option { + return func(p *Provider) { + if timeout > 0 { + p.httpClient.Timeout = timeout + } + } +} + +// NewProvider creates a new Azure OpenAI provider. +func NewProvider(apiKey, apiBase, proxy string, opts ...Option) *Provider { + p := &Provider{ + apiKey: apiKey, + apiBase: strings.TrimRight(apiBase, "/"), + httpClient: common.NewHTTPClient(proxy), + } + + for _, opt := range opts { + if opt != nil { + opt(p) + } + } + + return p +} + +// NewProviderWithTimeout creates a new Azure OpenAI provider with a custom request timeout in seconds. +func NewProviderWithTimeout(apiKey, apiBase, proxy string, requestTimeoutSeconds int) *Provider { + return NewProvider( + apiKey, apiBase, proxy, + WithRequestTimeout(time.Duration(requestTimeoutSeconds)*time.Second), + ) +} + +// Chat sends a chat completion request to the Azure OpenAI endpoint. +// The model parameter is used as the Azure deployment name in the URL. +func (p *Provider) Chat( + ctx context.Context, + messages []Message, + tools []ToolDefinition, + model string, + options map[string]any, +) (*LLMResponse, error) { + if p.apiBase == "" { + return nil, fmt.Errorf("Azure API base not configured") + } + + // model is the deployment name for Azure OpenAI + deployment := model + + // Build Azure-specific URL safely using url.JoinPath and query encoding + // to prevent path traversal or query injection via deployment names. + base, err := url.JoinPath(p.apiBase, "openai/deployments", deployment, "chat/completions") + if err != nil { + return nil, fmt.Errorf("failed to build Azure request URL: %w", err) + } + requestURL := base + "?api-version=" + azureAPIVersion + + // Build request body — no "model" field (Azure infers from deployment URL) + requestBody := map[string]any{ + "messages": common.SerializeMessages(messages), + } + + if len(tools) > 0 { + requestBody["tools"] = tools + requestBody["tool_choice"] = "auto" + } + + // Azure OpenAI always uses max_completion_tokens + if maxTokens, ok := common.AsInt(options["max_tokens"]); ok { + requestBody["max_completion_tokens"] = maxTokens + } + + if temperature, ok := common.AsFloat(options["temperature"]); ok { + requestBody["temperature"] = temperature + } + + jsonData, err := json.Marshal(requestBody) + if err != nil { + return nil, fmt.Errorf("failed to marshal request: %w", err) + } + + req, err := http.NewRequestWithContext(ctx, "POST", requestURL, bytes.NewReader(jsonData)) + if err != nil { + return nil, fmt.Errorf("failed to create request: %w", err) + } + + // Azure uses api-key header instead of Authorization: Bearer + req.Header.Set("Content-Type", "application/json") + if p.apiKey != "" { + req.Header.Set("api-key", p.apiKey) + } + + resp, err := p.httpClient.Do(req) + if err != nil { + return nil, fmt.Errorf("failed to send request: %w", err) + } + defer resp.Body.Close() + + if resp.StatusCode != http.StatusOK { + return nil, common.HandleErrorResponse(resp, p.apiBase) + } + + return common.ReadAndParseResponse(resp, p.apiBase) +} + +// GetDefaultModel returns an empty string as Azure deployments are user-configured. +func (p *Provider) GetDefaultModel() string { + return "" +} diff --git a/pkg/providers/azure/provider_test.go b/pkg/providers/azure/provider_test.go new file mode 100644 index 000000000..8f44edff5 --- /dev/null +++ b/pkg/providers/azure/provider_test.go @@ -0,0 +1,232 @@ +package azure + +import ( + "encoding/json" + "net/http" + "net/http/httptest" + "testing" + "time" +) + +// writeValidResponse writes a minimal valid Azure OpenAI chat completion response. +func writeValidResponse(w http.ResponseWriter) { + resp := map[string]any{ + "choices": []map[string]any{ + { + "message": map[string]any{"content": "ok"}, + "finish_reason": "stop", + }, + }, + } + w.Header().Set("Content-Type", "application/json") + json.NewEncoder(w).Encode(resp) +} + +func TestProviderChat_AzureURLConstruction(t *testing.T) { + var capturedPath string + var capturedAPIVersion string + + server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + capturedPath = r.URL.Path + capturedAPIVersion = r.URL.Query().Get("api-version") + writeValidResponse(w) + })) + defer server.Close() + + p := NewProvider("test-key", server.URL, "") + _, err := p.Chat(t.Context(), []Message{{Role: "user", Content: "hi"}}, nil, "my-gpt5-deployment", nil) + if err != nil { + t.Fatalf("Chat() error = %v", err) + } + + wantPath := "/openai/deployments/my-gpt5-deployment/chat/completions" + if capturedPath != wantPath { + t.Errorf("URL path = %q, want %q", capturedPath, wantPath) + } + if capturedAPIVersion != azureAPIVersion { + t.Errorf("api-version = %q, want %q", capturedAPIVersion, azureAPIVersion) + } +} + +func TestProviderChat_AzureAuthHeader(t *testing.T) { + var capturedAPIKey string + var capturedAuth string + + server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + capturedAPIKey = r.Header.Get("api-key") + capturedAuth = r.Header.Get("Authorization") + writeValidResponse(w) + })) + defer server.Close() + + p := NewProvider("test-azure-key", server.URL, "") + _, err := p.Chat(t.Context(), []Message{{Role: "user", Content: "hi"}}, nil, "deployment", nil) + if err != nil { + t.Fatalf("Chat() error = %v", err) + } + + if capturedAPIKey != "test-azure-key" { + t.Errorf("api-key header = %q, want %q", capturedAPIKey, "test-azure-key") + } + if capturedAuth != "" { + t.Errorf("Authorization header should be empty, got %q", capturedAuth) + } +} + +func TestProviderChat_AzureOmitsModelFromBody(t *testing.T) { + var requestBody map[string]any + + server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + json.NewDecoder(r.Body).Decode(&requestBody) + writeValidResponse(w) + })) + defer server.Close() + + p := NewProvider("test-key", server.URL, "") + _, err := p.Chat(t.Context(), []Message{{Role: "user", Content: "hi"}}, nil, "deployment", nil) + if err != nil { + t.Fatalf("Chat() error = %v", err) + } + + if _, exists := requestBody["model"]; exists { + t.Error("request body should not contain 'model' field for Azure OpenAI") + } +} + +func TestProviderChat_AzureUsesMaxCompletionTokens(t *testing.T) { + var requestBody map[string]any + + server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + json.NewDecoder(r.Body).Decode(&requestBody) + writeValidResponse(w) + })) + defer server.Close() + + p := NewProvider("test-key", server.URL, "") + _, err := p.Chat( + t.Context(), + []Message{{Role: "user", Content: "hi"}}, + nil, + "deployment", + map[string]any{"max_tokens": 2048}, + ) + if err != nil { + t.Fatalf("Chat() error = %v", err) + } + + if _, exists := requestBody["max_completion_tokens"]; !exists { + t.Error("request body should contain 'max_completion_tokens'") + } + if _, exists := requestBody["max_tokens"]; exists { + t.Error("request body should not contain 'max_tokens'") + } +} + +func TestProviderChat_AzureHTTPError(t *testing.T) { + server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + http.Error(w, `{"error":"unauthorized"}`, http.StatusUnauthorized) + })) + defer server.Close() + + p := NewProvider("bad-key", server.URL, "") + _, err := p.Chat(t.Context(), []Message{{Role: "user", Content: "hi"}}, nil, "deployment", nil) + if err == nil { + t.Fatal("expected error, got nil") + } +} + +func TestProviderChat_AzureParseToolCalls(t *testing.T) { + server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + resp := map[string]any{ + "choices": []map[string]any{ + { + "message": map[string]any{ + "content": "", + "tool_calls": []map[string]any{ + { + "id": "call_1", + "type": "function", + "function": map[string]any{ + "name": "get_weather", + "arguments": `{"city":"Seattle"}`, + }, + }, + }, + }, + "finish_reason": "tool_calls", + }, + }, + } + w.Header().Set("Content-Type", "application/json") + json.NewEncoder(w).Encode(resp) + })) + defer server.Close() + + p := NewProvider("test-key", server.URL, "") + out, err := p.Chat(t.Context(), []Message{{Role: "user", Content: "weather?"}}, nil, "deployment", nil) + if err != nil { + t.Fatalf("Chat() error = %v", err) + } + + if len(out.ToolCalls) != 1 { + t.Fatalf("len(ToolCalls) = %d, want 1", len(out.ToolCalls)) + } + if out.ToolCalls[0].Name != "get_weather" { + t.Errorf("ToolCalls[0].Name = %q, want %q", out.ToolCalls[0].Name, "get_weather") + } +} + +func TestProvider_AzureEmptyAPIBase(t *testing.T) { + p := NewProvider("test-key", "", "") + _, err := p.Chat(t.Context(), []Message{{Role: "user", Content: "hi"}}, nil, "deployment", nil) + if err == nil { + t.Fatal("expected error for empty API base") + } +} + +func TestProvider_AzureRequestTimeoutDefault(t *testing.T) { + p := NewProvider("test-key", "https://example.com", "") + if p.httpClient.Timeout != defaultRequestTimeout { + t.Errorf("timeout = %v, want %v", p.httpClient.Timeout, defaultRequestTimeout) + } +} + +func TestProvider_AzureRequestTimeoutOverride(t *testing.T) { + p := NewProvider("test-key", "https://example.com", "", WithRequestTimeout(300*time.Second)) + if p.httpClient.Timeout != 300*time.Second { + t.Errorf("timeout = %v, want %v", p.httpClient.Timeout, 300*time.Second) + } +} + +func TestProvider_AzureNewProviderWithTimeout(t *testing.T) { + p := NewProviderWithTimeout("test-key", "https://example.com", "", 180) + if p.httpClient.Timeout != 180*time.Second { + t.Errorf("timeout = %v, want %v", p.httpClient.Timeout, 180*time.Second) + } +} + +func TestProviderChat_AzureDeploymentNameEscaped(t *testing.T) { + var capturedPath string + + server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + capturedPath = r.URL.RawPath // use RawPath to see percent-encoding + if capturedPath == "" { + capturedPath = r.URL.Path + } + writeValidResponse(w) + })) + defer server.Close() + + p := NewProvider("test-key", server.URL, "") + + // Deployment name with characters that could cause path injection + _, err := p.Chat(t.Context(), []Message{{Role: "user", Content: "hi"}}, nil, "my deploy/../../admin", nil) + if err != nil { + t.Fatalf("Chat() error = %v", err) + } + + // The slash and special chars in the deployment name must be escaped, not treated as path separators + if capturedPath == "/openai/deployments/my deploy/../../admin/chat/completions" { + t.Fatal("deployment name was interpolated without escaping — path injection possible") + } +} diff --git a/pkg/providers/common/common.go b/pkg/providers/common/common.go new file mode 100644 index 000000000..23680a1bf --- /dev/null +++ b/pkg/providers/common/common.go @@ -0,0 +1,380 @@ +// PicoClaw - Ultra-lightweight personal AI agent +// License: MIT +// +// Copyright (c) 2026 PicoClaw contributors + +// Package common provides shared utilities used by multiple LLM provider +// implementations (openai_compat, azure, etc.). +package common + +import ( + "bufio" + "bytes" + "encoding/json" + "fmt" + "io" + "log" + "net/http" + "net/url" + "strings" + "time" + + "github.com/sipeed/picoclaw/pkg/providers/protocoltypes" +) + +// Re-export protocol types used across providers. +type ( + ToolCall = protocoltypes.ToolCall + FunctionCall = protocoltypes.FunctionCall + LLMResponse = protocoltypes.LLMResponse + UsageInfo = protocoltypes.UsageInfo + Message = protocoltypes.Message + ToolDefinition = protocoltypes.ToolDefinition + ToolFunctionDefinition = protocoltypes.ToolFunctionDefinition + ExtraContent = protocoltypes.ExtraContent + GoogleExtra = protocoltypes.GoogleExtra + ReasoningDetail = protocoltypes.ReasoningDetail +) + +const DefaultRequestTimeout = 120 * time.Second + +// NewHTTPClient creates an *http.Client with an optional proxy and the default timeout. +func NewHTTPClient(proxy string) *http.Client { + client := &http.Client{ + Timeout: DefaultRequestTimeout, + } + if proxy != "" { + parsed, err := url.Parse(proxy) + if err == nil { + // Preserve http.DefaultTransport settings (TLS, HTTP/2, timeouts, etc.) + if base, ok := http.DefaultTransport.(*http.Transport); ok { + tr := base.Clone() + tr.Proxy = http.ProxyURL(parsed) + client.Transport = tr + } else { + // Fallback: minimal transport if DefaultTransport is not *http.Transport. + client.Transport = &http.Transport{ + Proxy: http.ProxyURL(parsed), + } + } + } else { + log.Printf("common: invalid proxy URL %q: %v", proxy, err) + } + } + return client +} + +// --- Message serialization --- + +// openaiMessage is the wire-format message for OpenAI-compatible APIs. +// It mirrors protocoltypes.Message but omits SystemParts, which is an +// internal field that would be unknown to third-party endpoints. +type openaiMessage struct { + Role string `json:"role"` + Content string `json:"content"` + ReasoningContent string `json:"reasoning_content,omitempty"` + ToolCalls []ToolCall `json:"tool_calls,omitempty"` + ToolCallID string `json:"tool_call_id,omitempty"` +} + +// SerializeMessages converts internal Message structs to the OpenAI wire format. +// - Strips SystemParts (unknown to third-party endpoints) +// - Converts messages with Media to multipart content format (text + image_url parts) +// - Preserves ToolCallID, ToolCalls, and ReasoningContent for all messages +func SerializeMessages(messages []Message) []any { + out := make([]any, 0, len(messages)) + for _, m := range messages { + if len(m.Media) == 0 { + out = append(out, openaiMessage{ + Role: m.Role, + Content: m.Content, + ReasoningContent: m.ReasoningContent, + ToolCalls: m.ToolCalls, + ToolCallID: m.ToolCallID, + }) + continue + } + + // Multipart content format for messages with media + parts := make([]map[string]any, 0, 1+len(m.Media)) + if m.Content != "" { + parts = append(parts, map[string]any{ + "type": "text", + "text": m.Content, + }) + } + for _, mediaURL := range m.Media { + if strings.HasPrefix(mediaURL, "data:image/") { + parts = append(parts, map[string]any{ + "type": "image_url", + "image_url": map[string]any{ + "url": mediaURL, + }, + }) + } + } + + msg := map[string]any{ + "role": m.Role, + "content": parts, + } + if m.ToolCallID != "" { + msg["tool_call_id"] = m.ToolCallID + } + if len(m.ToolCalls) > 0 { + msg["tool_calls"] = m.ToolCalls + } + if m.ReasoningContent != "" { + msg["reasoning_content"] = m.ReasoningContent + } + out = append(out, msg) + } + return out +} + +// --- Response parsing --- + +// ParseResponse parses a JSON chat completion response body into an LLMResponse. +func ParseResponse(body io.Reader) (*LLMResponse, error) { + var apiResponse struct { + Choices []struct { + Message struct { + Content string `json:"content"` + ReasoningContent string `json:"reasoning_content"` + Reasoning string `json:"reasoning"` + ReasoningDetails []ReasoningDetail `json:"reasoning_details"` + ToolCalls []struct { + ID string `json:"id"` + Type string `json:"type"` + Function *struct { + Name string `json:"name"` + Arguments json.RawMessage `json:"arguments"` + } `json:"function"` + ExtraContent *struct { + Google *struct { + ThoughtSignature string `json:"thought_signature"` + } `json:"google"` + } `json:"extra_content"` + } `json:"tool_calls"` + } `json:"message"` + FinishReason string `json:"finish_reason"` + } `json:"choices"` + Usage *UsageInfo `json:"usage"` + } + + if err := json.NewDecoder(body).Decode(&apiResponse); err != nil { + return nil, fmt.Errorf("failed to decode response: %w", err) + } + + if len(apiResponse.Choices) == 0 { + return &LLMResponse{ + Content: "", + FinishReason: "stop", + }, nil + } + + choice := apiResponse.Choices[0] + toolCalls := make([]ToolCall, 0, len(choice.Message.ToolCalls)) + for _, tc := range choice.Message.ToolCalls { + arguments := make(map[string]any) + name := "" + + // Extract thought_signature from Gemini/Google-specific extra content + thoughtSignature := "" + if tc.ExtraContent != nil && tc.ExtraContent.Google != nil { + thoughtSignature = tc.ExtraContent.Google.ThoughtSignature + } + + if tc.Function != nil { + name = tc.Function.Name + arguments = DecodeToolCallArguments(tc.Function.Arguments, name) + } + + toolCall := ToolCall{ + ID: tc.ID, + Name: name, + Arguments: arguments, + ThoughtSignature: thoughtSignature, + } + + if thoughtSignature != "" { + toolCall.ExtraContent = &ExtraContent{ + Google: &GoogleExtra{ + ThoughtSignature: thoughtSignature, + }, + } + } + + toolCalls = append(toolCalls, toolCall) + } + + return &LLMResponse{ + Content: choice.Message.Content, + ReasoningContent: choice.Message.ReasoningContent, + Reasoning: choice.Message.Reasoning, + ReasoningDetails: choice.Message.ReasoningDetails, + ToolCalls: toolCalls, + FinishReason: choice.FinishReason, + Usage: apiResponse.Usage, + }, nil +} + +// DecodeToolCallArguments decodes a tool call's arguments from raw JSON. +func DecodeToolCallArguments(raw json.RawMessage, name string) map[string]any { + arguments := make(map[string]any) + raw = bytes.TrimSpace(raw) + if len(raw) == 0 || bytes.Equal(raw, []byte("null")) { + return arguments + } + + var decoded any + if err := json.Unmarshal(raw, &decoded); err != nil { + log.Printf("common: failed to decode tool call arguments payload for %q: %v", name, err) + arguments["raw"] = string(raw) + return arguments + } + + switch v := decoded.(type) { + case string: + if strings.TrimSpace(v) == "" { + return arguments + } + if err := json.Unmarshal([]byte(v), &arguments); err != nil { + log.Printf("common: failed to decode tool call arguments for %q: %v", name, err) + arguments["raw"] = v + } + return arguments + case map[string]any: + return v + default: + log.Printf("common: unsupported tool call arguments type for %q: %T", name, decoded) + arguments["raw"] = string(raw) + return arguments + } +} + +// --- HTTP response helpers --- + +// HandleErrorResponse reads a non-200 response body and returns an appropriate error. +func HandleErrorResponse(resp *http.Response, apiBase string) error { + contentType := resp.Header.Get("Content-Type") + body, readErr := io.ReadAll(io.LimitReader(resp.Body, 256)) + if readErr != nil { + return fmt.Errorf("failed to read response: %w", readErr) + } + if LooksLikeHTML(body, contentType) { + return WrapHTMLResponseError(resp.StatusCode, body, contentType, apiBase) + } + return fmt.Errorf( + "API request failed:\n Status: %d\n Body: %s", + resp.StatusCode, + ResponsePreview(body, 128), + ) +} + +// ReadAndParseResponse peeks at the response body to detect HTML errors, +// then parses the JSON response into an LLMResponse. +func ReadAndParseResponse(resp *http.Response, apiBase string) (*LLMResponse, error) { + contentType := resp.Header.Get("Content-Type") + reader := bufio.NewReader(resp.Body) + prefix, err := reader.Peek(256) + if err != nil && err != io.EOF && err != bufio.ErrBufferFull { + return nil, fmt.Errorf("failed to inspect response: %w", err) + } + if LooksLikeHTML(prefix, contentType) { + return nil, WrapHTMLResponseError(resp.StatusCode, prefix, contentType, apiBase) + } + out, err := ParseResponse(reader) + if err != nil { + return nil, fmt.Errorf("failed to parse JSON response: %w", err) + } + return out, nil +} + +// LooksLikeHTML checks if the response body appears to be HTML. +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 + } + prefix := bytes.ToLower(leadingTrimmedPrefix(body, 128)) + return bytes.HasPrefix(prefix, []byte("" + } + if len(trimmed) <= maxLen { + return string(trimmed) + } + return string(trimmed[:maxLen]) + "..." +} + +func leadingTrimmedPrefix(body []byte, maxLen int) []byte { + i := 0 + for i < len(body) { + switch body[i] { + case ' ', '\t', '\n', '\r', '\f', '\v': + i++ + default: + end := i + maxLen + if end > len(body) { + end = len(body) + } + return body[i:end] + } + } + return nil +} + +// --- Numeric helpers --- + +// AsInt converts various numeric types to int. +func AsInt(v any) (int, bool) { + switch val := v.(type) { + case int: + return val, true + case int64: + return int(val), true + case float64: + return int(val), true + case float32: + return int(val), true + default: + return 0, false + } +} + +// AsFloat converts various numeric types to float64. +func AsFloat(v any) (float64, bool) { + switch val := v.(type) { + case float64: + return val, true + case float32: + return float64(val), true + case int: + return float64(val), true + case int64: + return float64(val), true + default: + return 0, false + } +} diff --git a/pkg/providers/common/common_test.go b/pkg/providers/common/common_test.go new file mode 100644 index 000000000..bb7e7434d --- /dev/null +++ b/pkg/providers/common/common_test.go @@ -0,0 +1,558 @@ +package common + +import ( + "encoding/json" + "net/http" + "net/http/httptest" + "net/url" + "strings" + "testing" + + "github.com/sipeed/picoclaw/pkg/providers/protocoltypes" +) + +// --- NewHTTPClient tests --- + +func TestNewHTTPClient_DefaultTimeout(t *testing.T) { + client := NewHTTPClient("") + if client.Timeout != DefaultRequestTimeout { + t.Errorf("timeout = %v, want %v", client.Timeout, DefaultRequestTimeout) + } +} + +func TestNewHTTPClient_WithProxy(t *testing.T) { + client := NewHTTPClient("http://127.0.0.1:8080") + transport, ok := client.Transport.(*http.Transport) + if !ok || transport == nil { + t.Fatalf("expected http.Transport with proxy, got %T", client.Transport) + } + req := &http.Request{URL: &url.URL{Scheme: "https", Host: "api.example.com"}} + gotProxy, err := transport.Proxy(req) + if err != nil { + t.Fatalf("proxy function error: %v", err) + } + if gotProxy == nil || gotProxy.String() != "http://127.0.0.1:8080" { + t.Errorf("proxy = %v, want http://127.0.0.1:8080", gotProxy) + } +} + +func TestNewHTTPClient_NoProxy(t *testing.T) { + client := NewHTTPClient("") + if client.Transport != nil { + t.Errorf("expected nil transport without proxy, got %T", client.Transport) + } +} + +func TestNewHTTPClient_InvalidProxy(t *testing.T) { + // Should not panic, just log and return client without proxy + client := NewHTTPClient("://bad-url") + if client == nil { + t.Fatal("expected non-nil client even with invalid proxy") + } +} + +// --- SerializeMessages tests --- + +func TestSerializeMessages_PlainText(t *testing.T) { + messages := []Message{ + {Role: "user", Content: "hello"}, + {Role: "assistant", Content: "hi", ReasoningContent: "thinking..."}, + } + result := SerializeMessages(messages) + + data, _ := json.Marshal(result) + var msgs []map[string]any + json.Unmarshal(data, &msgs) + + if msgs[0]["content"] != "hello" { + t.Errorf("expected plain string content, got %v", msgs[0]["content"]) + } + if msgs[1]["reasoning_content"] != "thinking..." { + t.Errorf("reasoning_content not preserved, got %v", msgs[1]["reasoning_content"]) + } +} + +func TestSerializeMessages_WithMedia(t *testing.T) { + messages := []Message{ + {Role: "user", Content: "describe this", Media: []string{"data:image/png;base64,abc123"}}, + } + result := SerializeMessages(messages) + + data, _ := json.Marshal(result) + var msgs []map[string]any + json.Unmarshal(data, &msgs) + + content, ok := msgs[0]["content"].([]any) + if !ok { + t.Fatalf("expected array content for media message, got %T", msgs[0]["content"]) + } + if len(content) != 2 { + t.Fatalf("expected 2 content parts, got %d", len(content)) + } +} + +func TestSerializeMessages_MediaWithToolCallID(t *testing.T) { + messages := []Message{ + {Role: "tool", Content: "result", Media: []string{"data:image/png;base64,xyz"}, ToolCallID: "call_1"}, + } + result := SerializeMessages(messages) + + data, _ := json.Marshal(result) + var msgs []map[string]any + json.Unmarshal(data, &msgs) + + if msgs[0]["tool_call_id"] != "call_1" { + t.Errorf("tool_call_id not preserved, got %v", msgs[0]["tool_call_id"]) + } +} + +func TestSerializeMessages_StripsSystemParts(t *testing.T) { + messages := []Message{ + { + Role: "system", + Content: "you are helpful", + SystemParts: []protocoltypes.ContentBlock{ + {Type: "text", Text: "you are helpful"}, + }, + }, + } + result := SerializeMessages(messages) + + data, _ := json.Marshal(result) + if strings.Contains(string(data), "system_parts") { + t.Error("system_parts should not appear in serialized output") + } +} + +// --- ParseResponse tests --- + +func TestParseResponse_BasicContent(t *testing.T) { + body := `{"choices":[{"message":{"content":"hello world"},"finish_reason":"stop"}]}` + out, err := ParseResponse(strings.NewReader(body)) + if err != nil { + t.Fatalf("ParseResponse() error = %v", err) + } + if out.Content != "hello world" { + t.Errorf("Content = %q, want %q", out.Content, "hello world") + } + if out.FinishReason != "stop" { + t.Errorf("FinishReason = %q, want %q", out.FinishReason, "stop") + } +} + +func TestParseResponse_EmptyChoices(t *testing.T) { + body := `{"choices":[]}` + out, err := ParseResponse(strings.NewReader(body)) + if err != nil { + t.Fatalf("ParseResponse() error = %v", err) + } + if out.Content != "" { + t.Errorf("Content = %q, want empty", out.Content) + } + if out.FinishReason != "stop" { + t.Errorf("FinishReason = %q, want %q", out.FinishReason, "stop") + } +} + +func TestParseResponse_WithToolCalls(t *testing.T) { + body := `{"choices":[{"message":{"content":"","tool_calls":[{"id":"call_1","type":"function","function":{"name":"get_weather","arguments":"{\"city\":\"SF\"}"}}]},"finish_reason":"tool_calls"}]}` + out, err := ParseResponse(strings.NewReader(body)) + if err != nil { + t.Fatalf("ParseResponse() error = %v", err) + } + if len(out.ToolCalls) != 1 { + t.Fatalf("len(ToolCalls) = %d, want 1", len(out.ToolCalls)) + } + if out.ToolCalls[0].Name != "get_weather" { + t.Errorf("ToolCalls[0].Name = %q, want %q", out.ToolCalls[0].Name, "get_weather") + } + if out.ToolCalls[0].Arguments["city"] != "SF" { + t.Errorf("ToolCalls[0].Arguments[city] = %v, want SF", out.ToolCalls[0].Arguments["city"]) + } +} + +func TestParseResponse_WithUsage(t *testing.T) { + body := `{"choices":[{"message":{"content":"ok"},"finish_reason":"stop"}],"usage":{"prompt_tokens":10,"completion_tokens":5,"total_tokens":15}}` + out, err := ParseResponse(strings.NewReader(body)) + if err != nil { + t.Fatalf("ParseResponse() error = %v", err) + } + if out.Usage == nil { + t.Fatal("Usage is nil") + } + if out.Usage.PromptTokens != 10 { + t.Errorf("PromptTokens = %d, want 10", out.Usage.PromptTokens) + } +} + +func TestParseResponse_WithReasoningContent(t *testing.T) { + body := `{"choices":[{"message":{"content":"2","reasoning_content":"Let me think... 1+1=2"},"finish_reason":"stop"}]}` + out, err := ParseResponse(strings.NewReader(body)) + if err != nil { + t.Fatalf("ParseResponse() error = %v", err) + } + if out.ReasoningContent != "Let me think... 1+1=2" { + t.Errorf("ReasoningContent = %q, want %q", out.ReasoningContent, "Let me think... 1+1=2") + } +} + +func TestParseResponse_InvalidJSON(t *testing.T) { + _, err := ParseResponse(strings.NewReader("not json")) + if err == nil { + t.Fatal("expected error for invalid JSON") + } +} + +// --- DecodeToolCallArguments tests --- + +func TestDecodeToolCallArguments_ObjectJSON(t *testing.T) { + raw := json.RawMessage(`{"city":"Seattle","units":"metric"}`) + args := DecodeToolCallArguments(raw, "test") + if args["city"] != "Seattle" { + t.Errorf("city = %v, want Seattle", args["city"]) + } + if args["units"] != "metric" { + t.Errorf("units = %v, want metric", args["units"]) + } +} + +func TestDecodeToolCallArguments_StringJSON(t *testing.T) { + raw := json.RawMessage(`"{\"city\":\"SF\"}"`) + args := DecodeToolCallArguments(raw, "test") + if args["city"] != "SF" { + t.Errorf("city = %v, want SF", args["city"]) + } +} + +func TestDecodeToolCallArguments_EmptyInput(t *testing.T) { + args := DecodeToolCallArguments(nil, "test") + if len(args) != 0 { + t.Errorf("expected empty map, got %v", args) + } +} + +func TestDecodeToolCallArguments_NullInput(t *testing.T) { + args := DecodeToolCallArguments(json.RawMessage(`null`), "test") + if len(args) != 0 { + t.Errorf("expected empty map, got %v", args) + } +} + +func TestDecodeToolCallArguments_InvalidJSON(t *testing.T) { + args := DecodeToolCallArguments(json.RawMessage(`not-json`), "test") + if _, ok := args["raw"]; !ok { + t.Error("expected 'raw' fallback key for invalid JSON") + } +} + +func TestDecodeToolCallArguments_EmptyStringJSON(t *testing.T) { + args := DecodeToolCallArguments(json.RawMessage(`" "`), "test") + if len(args) != 0 { + t.Errorf("expected empty map for whitespace string, got %v", args) + } +} + +// --- HandleErrorResponse tests --- + +func TestHandleErrorResponse_JSONError(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.StatusBadRequest) + w.Write([]byte(`{"error":"bad request"}`)) + })) + defer server.Close() + + resp, err := http.Get(server.URL) + if err != nil { + t.Fatalf("http.Get() error = %v", err) + } + defer resp.Body.Close() + err = HandleErrorResponse(resp, server.URL) + if err == nil { + t.Fatal("expected error") + } + if !strings.Contains(err.Error(), "400") { + t.Errorf("error should contain status code, got %v", err) + } + if strings.Contains(err.Error(), "HTML") { + t.Errorf("should not mention HTML for JSON error, got %v", err) + } +} + +func TestHandleErrorResponse_HTMLError(t *testing.T) { + server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + w.Header().Set("Content-Type", "text/html") + w.WriteHeader(http.StatusBadGateway) + w.Write([]byte("bad gateway")) + })) + defer server.Close() + + resp, err := http.Get(server.URL) + if err != nil { + t.Fatalf("http.Get() error = %v", err) + } + defer resp.Body.Close() + err = HandleErrorResponse(resp, server.URL) + if err == nil { + t.Fatal("expected error") + } + if !strings.Contains(err.Error(), "HTML instead of JSON") { + t.Errorf("expected HTML error message, got %v", err) + } +} + +// --- ReadAndParseResponse tests --- + +func TestReadAndParseResponse_ValidJSON(t *testing.T) { + server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + w.Header().Set("Content-Type", "application/json") + w.Write([]byte(`{"choices":[{"message":{"content":"ok"},"finish_reason":"stop"}]}`)) + })) + defer server.Close() + + resp, err := http.Get(server.URL) + if err != nil { + t.Fatalf("http.Get() error = %v", err) + } + defer resp.Body.Close() + out, err := ReadAndParseResponse(resp, server.URL) + if err != nil { + t.Fatalf("ReadAndParseResponse() error = %v", err) + } + if out.Content != "ok" { + t.Errorf("Content = %q, want %q", out.Content, "ok") + } +} + +func TestReadAndParseResponse_HTMLResponse(t *testing.T) { + server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + w.Header().Set("Content-Type", "text/html") + w.Write([]byte("login page")) + })) + defer server.Close() + + resp, err := http.Get(server.URL) + if err != nil { + t.Fatalf("http.Get() error = %v", err) + } + defer resp.Body.Close() + _, err = ReadAndParseResponse(resp, server.URL) + if err == nil { + t.Fatal("expected error for HTML response") + } + if !strings.Contains(err.Error(), "HTML instead of JSON") { + t.Errorf("expected HTML error, got %v", err) + } +} + +// --- LooksLikeHTML tests --- + +func TestLooksLikeHTML_ContentTypeHTML(t *testing.T) { + if !LooksLikeHTML(nil, "text/html; charset=utf-8") { + t.Error("expected true for text/html content type") + } +} + +func TestLooksLikeHTML_ContentTypeXHTML(t *testing.T) { + if !LooksLikeHTML(nil, "application/xhtml+xml") { + t.Error("expected true for xhtml content type") + } +} + +func TestLooksLikeHTML_BodyPrefix(t *testing.T) { + tests := []struct { + name string + body string + }{ + {"doctype", ""}, + {"html tag", ""}, + {"head tag", ""}, + {"body tag", "<body>content"}, + {"whitespace before", " \n\t<!DOCTYPE html>"}, + } + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + if !LooksLikeHTML([]byte(tt.body), "application/json") { + t.Errorf("expected true for body %q", tt.body) + } + }) + } +} + +func TestLooksLikeHTML_NotHTML(t *testing.T) { + if LooksLikeHTML([]byte(`{"error":"bad"}`), "application/json") { + t.Error("expected false for JSON body") + } +} + +// --- ResponsePreview tests --- + +func TestResponsePreview_Short(t *testing.T) { + got := ResponsePreview([]byte("hello"), 128) + if got != "hello" { + t.Errorf("got %q, want %q", got, "hello") + } +} + +func TestResponsePreview_Truncated(t *testing.T) { + body := strings.Repeat("a", 200) + got := ResponsePreview([]byte(body), 128) + if len(got) != 131 { // 128 + "..." + t.Errorf("len = %d, want 131", len(got)) + } + if !strings.HasSuffix(got, "...") { + t.Error("expected ... suffix") + } +} + +func TestResponsePreview_Empty(t *testing.T) { + got := ResponsePreview([]byte(""), 128) + if got != "<empty>" { + t.Errorf("got %q, want %q", got, "<empty>") + } +} + +func TestResponsePreview_Whitespace(t *testing.T) { + got := ResponsePreview([]byte(" \n\t "), 128) + if got != "<empty>" { + t.Errorf("got %q, want %q for whitespace-only body", got, "<empty>") + } +} + +// --- AsInt tests --- + +func TestAsInt(t *testing.T) { + tests := []struct { + name string + val any + want int + ok bool + }{ + {"int", 42, 42, true}, + {"int64", int64(99), 99, true}, + {"float64", float64(512), 512, true}, + {"float32", float32(256), 256, true}, + {"string", "nope", 0, false}, + {"nil", nil, 0, false}, + } + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + got, ok := AsInt(tt.val) + if ok != tt.ok || got != tt.want { + t.Errorf("AsInt(%v) = (%d, %v), want (%d, %v)", tt.val, got, ok, tt.want, tt.ok) + } + }) + } +} + +// --- AsFloat tests --- + +func TestAsFloat(t *testing.T) { + tests := []struct { + name string + val any + want float64 + ok bool + }{ + {"float64", float64(0.7), 0.7, true}, + {"float32", float32(0.5), float64(float32(0.5)), true}, + {"int", 1, 1.0, true}, + {"int64", int64(100), 100.0, true}, + {"string", "nope", 0, false}, + {"nil", nil, 0, false}, + } + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + got, ok := AsFloat(tt.val) + if ok != tt.ok || got != tt.want { + t.Errorf("AsFloat(%v) = (%f, %v), want (%f, %v)", tt.val, got, ok, tt.want, tt.ok) + } + }) + } +} + +// --- WrapHTMLResponseError tests --- + +func TestWrapHTMLResponseError(t *testing.T) { + err := WrapHTMLResponseError(502, []byte("<html>bad</html>"), "text/html", "https://api.example.com") + if err == nil { + t.Fatal("expected error") + } + msg := err.Error() + if !strings.Contains(msg, "502") { + t.Errorf("expected status code in error, got %v", msg) + } + if !strings.Contains(msg, "https://api.example.com") { + t.Errorf("expected api base in error, got %v", msg) + } + if !strings.Contains(msg, "HTML instead of JSON") { + t.Errorf("expected HTML mention in error, got %v", msg) + } +} + +// --- HandleErrorResponse with read failure --- + +func TestHandleErrorResponse_EmptyBody(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.StatusInternalServerError) + // empty body + })) + defer server.Close() + + resp, err := http.Get(server.URL) + if err != nil { + t.Fatalf("http.Get() error = %v", err) + } + defer resp.Body.Close() + err = HandleErrorResponse(resp, server.URL) + if err == nil { + t.Fatal("expected error") + } + if !strings.Contains(err.Error(), "500") { + t.Errorf("expected status code, got %v", err) + } +} + +// --- ReadAndParseResponse with invalid JSON --- + +func TestReadAndParseResponse_InvalidJSON(t *testing.T) { + server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + w.Header().Set("Content-Type", "application/json") + w.Write([]byte("not valid json")) + })) + defer server.Close() + + resp, err := http.Get(server.URL) + if err != nil { + t.Fatalf("http.Get() error = %v", err) + } + defer resp.Body.Close() + _, err = ReadAndParseResponse(resp, server.URL) + if err == nil { + t.Fatal("expected error for invalid JSON") + } +} + +// --- ParseResponse with thought_signature (Google/Gemini) --- + +func TestParseResponse_WithThoughtSignature(t *testing.T) { + body := `{"choices":[{"message":{"content":"","tool_calls":[{"id":"call_1","type":"function","function":{"name":"test_tool","arguments":"{}"},"extra_content":{"google":{"thought_signature":"sig123"}}}]},"finish_reason":"tool_calls"}]}` + out, err := ParseResponse(strings.NewReader(body)) + if err != nil { + t.Fatalf("ParseResponse() error = %v", err) + } + if len(out.ToolCalls) != 1 { + t.Fatalf("len(ToolCalls) = %d, want 1", len(out.ToolCalls)) + } + if out.ToolCalls[0].ThoughtSignature != "sig123" { + t.Errorf("ThoughtSignature = %q, want %q", out.ToolCalls[0].ThoughtSignature, "sig123") + } + if out.ToolCalls[0].ExtraContent == nil || out.ToolCalls[0].ExtraContent.Google == nil { + t.Fatal("ExtraContent.Google is nil") + } + if out.ToolCalls[0].ExtraContent.Google.ThoughtSignature != "sig123" { + t.Errorf("ExtraContent.Google.ThoughtSignature = %q, want %q", + out.ToolCalls[0].ExtraContent.Google.ThoughtSignature, "sig123") + } +} diff --git a/pkg/providers/factory_provider.go b/pkg/providers/factory_provider.go index e99e07bc2..b7567f9fc 100644 --- a/pkg/providers/factory_provider.go +++ b/pkg/providers/factory_provider.go @@ -11,6 +11,7 @@ import ( "github.com/sipeed/picoclaw/pkg/config" anthropicmessages "github.com/sipeed/picoclaw/pkg/providers/anthropic_messages" + "github.com/sipeed/picoclaw/pkg/providers/azure" ) // createClaudeAuthProvider creates a Claude provider using OAuth credentials from auth store. @@ -94,6 +95,24 @@ func CreateProviderFromConfig(cfg *config.ModelConfig) (LLMProvider, string, err cfg.RequestTimeout, ), modelID, nil + case "azure", "azure-openai": + // Azure OpenAI uses deployment-based URLs, api-key header auth, + // and always sends max_completion_tokens. + if cfg.APIKey == "" { + return nil, "", fmt.Errorf("api_key is required for azure protocol") + } + if cfg.APIBase == "" { + return nil, "", fmt.Errorf( + "api_base is required for azure protocol (e.g., https://your-resource.openai.azure.com)", + ) + } + return azure.NewProviderWithTimeout( + cfg.APIKey, + cfg.APIBase, + cfg.Proxy, + cfg.RequestTimeout, + ), modelID, nil + case "litellm", "openrouter", "groq", "zhipu", "gemini", "nvidia", "ollama", "moonshot", "shengsuanyun", "deepseek", "cerebras", "vivgrid", "volcengine", "vllm", "qwen", "mistral", "avian", diff --git a/pkg/providers/factory_provider_test.go b/pkg/providers/factory_provider_test.go index 00676ebf9..b678a7eb6 100644 --- a/pkg/providers/factory_provider_test.go +++ b/pkg/providers/factory_provider_test.go @@ -64,6 +64,12 @@ func TestExtractProtocol(t *testing.T) { wantProtocol: "nvidia", wantModelID: "meta/llama-3.1-8b", }, + { + name: "azure with prefix", + model: "azure/my-gpt5-deployment", + wantProtocol: "azure", + wantModelID: "my-gpt5-deployment", + }, } for _, tt := range tests { @@ -371,3 +377,69 @@ func TestCreateProviderFromConfig_RequestTimeoutPropagation(t *testing.T) { t.Fatalf("Chat() error = %q, want timeout-related error", errMsg) } } + +func TestCreateProviderFromConfig_Azure(t *testing.T) { + cfg := &config.ModelConfig{ + ModelName: "azure-gpt5", + Model: "azure/my-gpt5-deployment", + APIKey: "test-azure-key", + APIBase: "https://my-resource.openai.azure.com", + } + + provider, modelID, err := CreateProviderFromConfig(cfg) + if err != nil { + t.Fatalf("CreateProviderFromConfig() error = %v", err) + } + if provider == nil { + t.Fatal("CreateProviderFromConfig() returned nil provider") + } + if modelID != "my-gpt5-deployment" { + t.Errorf("modelID = %q, want %q", modelID, "my-gpt5-deployment") + } +} + +func TestCreateProviderFromConfig_AzureOpenAIAlias(t *testing.T) { + cfg := &config.ModelConfig{ + ModelName: "azure-gpt4", + Model: "azure-openai/my-deployment", + APIKey: "test-azure-key", + APIBase: "https://my-resource.openai.azure.com", + } + + provider, modelID, err := CreateProviderFromConfig(cfg) + if err != nil { + t.Fatalf("CreateProviderFromConfig() error = %v", err) + } + if provider == nil { + t.Fatal("CreateProviderFromConfig() returned nil provider") + } + if modelID != "my-deployment" { + t.Errorf("modelID = %q, want %q", modelID, "my-deployment") + } +} + +func TestCreateProviderFromConfig_AzureMissingAPIKey(t *testing.T) { + cfg := &config.ModelConfig{ + ModelName: "azure-gpt5", + Model: "azure/my-gpt5-deployment", + APIBase: "https://my-resource.openai.azure.com", + } + + _, _, err := CreateProviderFromConfig(cfg) + if err == nil { + t.Fatal("CreateProviderFromConfig() expected error for missing API key") + } +} + +func TestCreateProviderFromConfig_AzureMissingAPIBase(t *testing.T) { + cfg := &config.ModelConfig{ + ModelName: "azure-gpt5", + Model: "azure/my-gpt5-deployment", + APIKey: "test-azure-key", + } + + _, _, err := CreateProviderFromConfig(cfg) + if err == nil { + t.Fatal("CreateProviderFromConfig() expected error for missing API base") + } +} diff --git a/pkg/providers/openai_compat/provider.go b/pkg/providers/openai_compat/provider.go index f97bf3acd..fb2abaa5c 100644 --- a/pkg/providers/openai_compat/provider.go +++ b/pkg/providers/openai_compat/provider.go @@ -1,18 +1,16 @@ package openai_compat import ( - "bufio" "bytes" "context" "encoding/json" "fmt" - "io" - "log" "net/http" "net/url" "strings" "time" + "github.com/sipeed/picoclaw/pkg/providers/common" "github.com/sipeed/picoclaw/pkg/providers/protocoltypes" ) @@ -38,7 +36,7 @@ type Provider struct { type Option func(*Provider) -const defaultRequestTimeout = 120 * time.Second +const defaultRequestTimeout = common.DefaultRequestTimeout func WithMaxTokensField(maxTokensField string) Option { return func(p *Provider) { @@ -55,25 +53,10 @@ func WithRequestTimeout(timeout time.Duration) Option { } func NewProvider(apiKey, apiBase, proxy string, opts ...Option) *Provider { - client := &http.Client{ - Timeout: defaultRequestTimeout, - } - - if proxy != "" { - parsed, err := url.Parse(proxy) - if err == nil { - client.Transport = &http.Transport{ - Proxy: http.ProxyURL(parsed), - } - } else { - log.Printf("openai_compat: invalid proxy URL %q: %v", proxy, err) - } - } - p := &Provider{ apiKey: apiKey, apiBase: strings.TrimRight(apiBase, "/"), - httpClient: client, + httpClient: common.NewHTTPClient(proxy), } for _, opt := range opts { @@ -117,7 +100,7 @@ func (p *Provider) Chat( requestBody := map[string]any{ "model": model, - "messages": serializeMessages(messages), + "messages": common.SerializeMessages(messages), } if len(tools) > 0 { @@ -125,7 +108,7 @@ func (p *Provider) Chat( requestBody["tool_choice"] = "auto" } - if maxTokens, ok := asInt(options["max_tokens"]); ok { + if maxTokens, ok := common.AsInt(options["max_tokens"]); ok { // Use configured maxTokensField if specified, otherwise fallback to model-based detection fieldName := p.maxTokensField if fieldName == "" { @@ -141,7 +124,7 @@ func (p *Provider) Chat( requestBody[fieldName] = maxTokens } - if temperature, ok := asFloat(options["temperature"]); ok { + if temperature, ok := common.AsFloat(options["temperature"]); ok { lowerModel := strings.ToLower(model) // Kimi k2 models only support temperature=1. if strings.Contains(lowerModel, "kimi") && strings.Contains(lowerModel, "k2") { @@ -185,275 +168,11 @@ func (p *Provider) Chat( } defer resp.Body.Close() - contentType := resp.Header.Get("Content-Type") - - // Non-200: read a prefix to tell HTML error page apart from JSON error body. if resp.StatusCode != http.StatusOK { - body, readErr := io.ReadAll(io.LimitReader(resp.Body, 256)) - if readErr != nil { - return nil, fmt.Errorf("failed to read response: %w", readErr) - } - if looksLikeHTML(body, contentType) { - return nil, wrapHTMLResponseError(resp.StatusCode, body, contentType, p.apiBase) - } - return nil, fmt.Errorf( - "API request failed:\n Status: %d\n Body: %s", - resp.StatusCode, - responsePreview(body, 128), - ) + return nil, common.HandleErrorResponse(resp, p.apiBase) } - // Peek without consuming so the full stream reaches the JSON decoder. - reader := bufio.NewReader(resp.Body) - prefix, err := reader.Peek(256) // io.EOF/ErrBufferFull are normal; only real errors abort - if err != nil && err != io.EOF && err != bufio.ErrBufferFull { - return nil, fmt.Errorf("failed to inspect response: %w", err) - } - if looksLikeHTML(prefix, contentType) { - return nil, wrapHTMLResponseError(resp.StatusCode, prefix, contentType, p.apiBase) - } - - out, err := parseResponse(reader) - if err != nil { - return nil, fmt.Errorf("failed to parse JSON response: %w", err) - } - - return out, nil -} - -func wrapHTMLResponseError(statusCode int, body []byte, contentType, apiBase string) error { - 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 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 - } - prefix := bytes.ToLower(leadingTrimmedPrefix(body, 128)) - return bytes.HasPrefix(prefix, []byte("<!doctype html")) || - bytes.HasPrefix(prefix, []byte("<html")) || - bytes.HasPrefix(prefix, []byte("<head")) || - bytes.HasPrefix(prefix, []byte("<body")) -} - -func leadingTrimmedPrefix(body []byte, maxLen int) []byte { - i := 0 - for i < len(body) { - switch body[i] { - case ' ', '\t', '\n', '\r', '\f', '\v': - i++ - default: - end := i + maxLen - if end > len(body) { - end = len(body) - } - return body[i:end] - } - } - return nil -} - -func responsePreview(body []byte, maxLen int) string { - trimmed := bytes.TrimSpace(body) - if len(trimmed) == 0 { - return "<empty>" - } - if len(trimmed) <= maxLen { - return string(trimmed) - } - return string(trimmed[:maxLen]) + "..." -} - -func parseResponse(body io.Reader) (*LLMResponse, error) { - var apiResponse struct { - Choices []struct { - Message struct { - Content string `json:"content"` - ReasoningContent string `json:"reasoning_content"` - Reasoning string `json:"reasoning"` - ReasoningDetails []ReasoningDetail `json:"reasoning_details"` - ToolCalls []struct { - ID string `json:"id"` - Type string `json:"type"` - Function *struct { - Name string `json:"name"` - Arguments json.RawMessage `json:"arguments"` - } `json:"function"` - ExtraContent *struct { - Google *struct { - ThoughtSignature string `json:"thought_signature"` - } `json:"google"` - } `json:"extra_content"` - } `json:"tool_calls"` - } `json:"message"` - FinishReason string `json:"finish_reason"` - } `json:"choices"` - Usage *UsageInfo `json:"usage"` - } - - if err := json.NewDecoder(body).Decode(&apiResponse); err != nil { - return nil, fmt.Errorf("failed to decode response: %w", err) - } - - if len(apiResponse.Choices) == 0 { - return &LLMResponse{ - Content: "", - FinishReason: "stop", - }, nil - } - - choice := apiResponse.Choices[0] - toolCalls := make([]ToolCall, 0, len(choice.Message.ToolCalls)) - for _, tc := range choice.Message.ToolCalls { - arguments := make(map[string]any) - name := "" - - // Extract thought_signature from Gemini/Google-specific extra content - thoughtSignature := "" - if tc.ExtraContent != nil && tc.ExtraContent.Google != nil { - thoughtSignature = tc.ExtraContent.Google.ThoughtSignature - } - - if tc.Function != nil { - name = tc.Function.Name - arguments = decodeToolCallArguments(tc.Function.Arguments, name) - } - - // Build ToolCall with ExtraContent for Gemini 3 thought_signature persistence - toolCall := ToolCall{ - ID: tc.ID, - Name: name, - Arguments: arguments, - ThoughtSignature: thoughtSignature, - } - - if thoughtSignature != "" { - toolCall.ExtraContent = &ExtraContent{ - Google: &GoogleExtra{ - ThoughtSignature: thoughtSignature, - }, - } - } - - toolCalls = append(toolCalls, toolCall) - } - - return &LLMResponse{ - Content: choice.Message.Content, - ReasoningContent: choice.Message.ReasoningContent, - Reasoning: choice.Message.Reasoning, - ReasoningDetails: choice.Message.ReasoningDetails, - ToolCalls: toolCalls, - FinishReason: choice.FinishReason, - Usage: apiResponse.Usage, - }, nil -} - -func decodeToolCallArguments(raw json.RawMessage, name string) map[string]any { - arguments := make(map[string]any) - raw = bytes.TrimSpace(raw) - if len(raw) == 0 || bytes.Equal(raw, []byte("null")) { - return arguments - } - - var decoded any - if err := json.Unmarshal(raw, &decoded); err != nil { - log.Printf("openai_compat: failed to decode tool call arguments payload for %q: %v", name, err) - arguments["raw"] = string(raw) - return arguments - } - - switch v := decoded.(type) { - case string: - if strings.TrimSpace(v) == "" { - return arguments - } - if err := json.Unmarshal([]byte(v), &arguments); err != nil { - log.Printf("openai_compat: failed to decode tool call arguments for %q: %v", name, err) - arguments["raw"] = v - } - return arguments - case map[string]any: - return v - default: - log.Printf("openai_compat: unsupported tool call arguments type for %q: %T", name, decoded) - arguments["raw"] = string(raw) - return arguments - } -} - -// openaiMessage is the wire-format message for OpenAI-compatible APIs. -// It mirrors protocoltypes.Message but omits SystemParts, which is an -// internal field that would be unknown to third-party endpoints. -type openaiMessage struct { - Role string `json:"role"` - Content string `json:"content"` - ReasoningContent string `json:"reasoning_content,omitempty"` - ToolCalls []ToolCall `json:"tool_calls,omitempty"` - ToolCallID string `json:"tool_call_id,omitempty"` -} - -// serializeMessages converts internal Message structs to the OpenAI wire format. -// - Strips SystemParts (unknown to third-party endpoints) -// - Converts messages with Media to multipart content format (text + image_url parts) -// - Preserves ToolCallID, ToolCalls, and ReasoningContent for all messages -func serializeMessages(messages []Message) []any { - out := make([]any, 0, len(messages)) - for _, m := range messages { - if len(m.Media) == 0 { - out = append(out, openaiMessage{ - Role: m.Role, - Content: m.Content, - ReasoningContent: m.ReasoningContent, - ToolCalls: m.ToolCalls, - ToolCallID: m.ToolCallID, - }) - continue - } - - // Multipart content format for messages with media - parts := make([]map[string]any, 0, 1+len(m.Media)) - if m.Content != "" { - parts = append(parts, map[string]any{ - "type": "text", - "text": m.Content, - }) - } - for _, mediaURL := range m.Media { - if strings.HasPrefix(mediaURL, "data:image/") { - parts = append(parts, map[string]any{ - "type": "image_url", - "image_url": map[string]any{ - "url": mediaURL, - }, - }) - } - } - - msg := map[string]any{ - "role": m.Role, - "content": parts, - } - if m.ToolCallID != "" { - msg["tool_call_id"] = m.ToolCallID - } - if len(m.ToolCalls) > 0 { - msg["tool_calls"] = m.ToolCalls - } - if m.ReasoningContent != "" { - msg["reasoning_content"] = m.ReasoningContent - } - out = append(out, msg) - } - return out + return common.ReadAndParseResponse(resp, p.apiBase) } func normalizeModel(model, apiBase string) string { @@ -476,36 +195,6 @@ func normalizeModel(model, apiBase string) string { } } -func asInt(v any) (int, bool) { - switch val := v.(type) { - case int: - return val, true - case int64: - return int(val), true - case float64: - return int(val), true - case float32: - return int(val), true - default: - return 0, false - } -} - -func asFloat(v any) (float64, bool) { - switch val := v.(type) { - case float64: - return val, true - case float32: - return float64(val), true - case int: - return float64(val), true - case int64: - return float64(val), true - default: - return 0, false - } -} - // supportsPromptCacheKey reports whether the given API base is known to // support the prompt_cache_key request field. Currently only OpenAI's own // API and Azure OpenAI support this. All other OpenAI-compatible providers diff --git a/pkg/providers/openai_compat/provider_test.go b/pkg/providers/openai_compat/provider_test.go index 41f278a1b..ed9747f9d 100644 --- a/pkg/providers/openai_compat/provider_test.go +++ b/pkg/providers/openai_compat/provider_test.go @@ -12,6 +12,7 @@ import ( "testing" "time" + "github.com/sipeed/picoclaw/pkg/providers/common" "github.com/sipeed/picoclaw/pkg/providers/protocoltypes" ) @@ -648,7 +649,7 @@ func TestSerializeMessages_PlainText(t *testing.T) { {Role: "user", Content: "hello"}, {Role: "assistant", Content: "hi", ReasoningContent: "thinking..."}, } - result := serializeMessages(messages) + result := common.SerializeMessages(messages) data, err := json.Marshal(result) if err != nil { @@ -670,7 +671,7 @@ func TestSerializeMessages_WithMedia(t *testing.T) { messages := []protocoltypes.Message{ {Role: "user", Content: "describe this", Media: []string{"data:image/png;base64,abc123"}}, } - result := serializeMessages(messages) + result := common.SerializeMessages(messages) data, _ := json.Marshal(result) var msgs []map[string]any @@ -703,7 +704,7 @@ func TestSerializeMessages_MediaWithToolCallID(t *testing.T) { messages := []protocoltypes.Message{ {Role: "tool", Content: "image result", Media: []string{"data:image/png;base64,xyz"}, ToolCallID: "call_1"}, } - result := serializeMessages(messages) + result := common.SerializeMessages(messages) data, _ := json.Marshal(result) var msgs []map[string]any @@ -833,7 +834,7 @@ func TestSerializeMessages_StripsSystemParts(t *testing.T) { }, }, } - result := serializeMessages(messages) + result := common.SerializeMessages(messages) data, _ := json.Marshal(result) raw := string(data) From f7dd040ae4a6d07dca87617fc08e63fda82bde40 Mon Sep 17 00:00:00 2001 From: Hoshina <hoshina@evaz.org> Date: Sun, 15 Mar 2026 12:45:11 +0800 Subject: [PATCH 14/56] fix(provider/azure): lint err --- pkg/providers/azure/provider.go | 2 +- pkg/providers/azure/provider_test.go | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/pkg/providers/azure/provider.go b/pkg/providers/azure/provider.go index 6e1d07e78..e0ddbbde4 100644 --- a/pkg/providers/azure/provider.go +++ b/pkg/providers/azure/provider.go @@ -128,7 +128,7 @@ func (p *Provider) Chat( // Azure uses api-key header instead of Authorization: Bearer req.Header.Set("Content-Type", "application/json") if p.apiKey != "" { - req.Header.Set("api-key", p.apiKey) + req.Header.Set("Api-Key", p.apiKey) } resp, err := p.httpClient.Do(req) diff --git a/pkg/providers/azure/provider_test.go b/pkg/providers/azure/provider_test.go index 8f44edff5..531b81296 100644 --- a/pkg/providers/azure/provider_test.go +++ b/pkg/providers/azure/provider_test.go @@ -53,7 +53,7 @@ func TestProviderChat_AzureAuthHeader(t *testing.T) { var capturedAuth string server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { - capturedAPIKey = r.Header.Get("api-key") + capturedAPIKey = r.Header.Get("Api-Key") capturedAuth = r.Header.Get("Authorization") writeValidResponse(w) })) From 54f870c2559d2d7b29fb9487744138632c0c874b Mon Sep 17 00:00:00 2001 From: sky5454 <sky5454@users.noreply.github.com> Date: Sun, 15 Mar 2026 18:02:26 +0800 Subject: [PATCH 15/56] feat/sec add github's dependabot to scan the lib sec. --- .github/dependabot.yml | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 .github/dependabot.yml diff --git a/.github/dependabot.yml b/.github/dependabot.yml new file mode 100644 index 000000000..559a2249e --- /dev/null +++ b/.github/dependabot.yml @@ -0,0 +1,27 @@ +version: 2 + +updates: + + # Go dependencies (entire repo) + - package-ecosystem: "gomod" + directory: "/" + schedule: + interval: "weekly" + labels: + - "dependencies" + - "go" + + # Frontend dependencies + - package-ecosystem: "npm" + directory: "/web/frontend" + schedule: + interval: "weekly" + labels: + - "dependencies" + - "frontend" + + # GitHub Actions + - package-ecosystem: "github-actions" + directory: "/" + schedule: + interval: "weekly" \ No newline at end of file From 71e2b636d66c9d30250f027085d142d93d4246be Mon Sep 17 00:00:00 2001 From: BitToby <218712309+bittoby@users.noreply.github.com> Date: Mon, 16 Mar 2026 03:58:37 +0200 Subject: [PATCH 16/56] fix: Use secure defaults for Pico channel setup and stop leaking the token in the URL (#1563) * fix: Use secure defaults for Pico channel setup and stop leaking the token in the URL * fix: Derive default allow_origins from the setup request's Origin header instead of hardcoding localhost ports --- pkg/channels/pico/pico.go | 31 ++- web/backend/api/gateway.go | 2 +- web/backend/api/pico.go | 24 +- web/backend/api/pico_test.go | 237 +++++++++++++++++++ web/frontend/src/lib/pico-chat-controller.ts | 5 +- 5 files changed, 281 insertions(+), 18 deletions(-) create mode 100644 web/backend/api/pico_test.go diff --git a/pkg/channels/pico/pico.go b/pkg/channels/pico/pico.go index 8d8b62a67..206e71f92 100644 --- a/pkg/channels/pico/pico.go +++ b/pkg/channels/pico/pico.go @@ -251,7 +251,13 @@ func (c *PicoChannel) handleWebSocket(w http.ResponseWriter, r *http.Request) { return } - conn, err := c.upgrader.Upgrade(w, r, nil) + // Echo the matched subprotocol back so the browser accepts the upgrade. + var responseHeader http.Header + if proto := c.matchedSubprotocol(r); proto != "" { + responseHeader = http.Header{"Sec-WebSocket-Protocol": {proto}} + } + + conn, err := c.upgrader.Upgrade(w, r, responseHeader) if err != nil { logger.ErrorCF("pico", "WebSocket upgrade failed", map[string]any{ "error": err.Error(), @@ -282,8 +288,10 @@ func (c *PicoChannel) handleWebSocket(w http.ResponseWriter, r *http.Request) { go c.readLoop(pc) } -// authenticate checks the Bearer token from the Authorization header. -// Query parameter authentication is only allowed when AllowTokenQuery is explicitly enabled. +// authenticate checks the request for a valid token: +// 1. Authorization: Bearer <token> header +// 2. Sec-WebSocket-Protocol "token.<value>" (for browsers that can't set headers) +// 3. Query parameter "token" (only when AllowTokenQuery is on) func (c *PicoChannel) authenticate(r *http.Request) bool { token := c.config.Token if token == "" { @@ -298,6 +306,11 @@ func (c *PicoChannel) authenticate(r *http.Request) bool { } } + // Check Sec-WebSocket-Protocol subprotocol ("token.<value>") + if c.matchedSubprotocol(r) != "" { + return true + } + // Check query parameter only when explicitly allowed if c.config.AllowTokenQuery { if r.URL.Query().Get("token") == token { @@ -308,6 +321,18 @@ func (c *PicoChannel) authenticate(r *http.Request) bool { return false } +// matchedSubprotocol returns the "token.<value>" subprotocol that matches +// the configured token, or "" if none do. +func (c *PicoChannel) matchedSubprotocol(r *http.Request) string { + token := c.config.Token + for _, proto := range websocket.Subprotocols(r) { + if after, ok := strings.CutPrefix(proto, "token."); ok && after == token { + return proto + } + } + return "" +} + // readLoop reads messages from a WebSocket connection. func (c *PicoChannel) readLoop(pc *picoConn) { defer func() { diff --git a/web/backend/api/gateway.go b/web/backend/api/gateway.go index 1813cac92..f50f7609a 100644 --- a/web/backend/api/gateway.go +++ b/web/backend/api/gateway.go @@ -281,7 +281,7 @@ func (h *Handler) startGatewayLocked(initialStatus string) (int, error) { gateway.logs.Reset() // Ensure Pico Channel is configured before starting gateway - if _, err := h.ensurePicoChannel(); err != nil { + if _, err := h.ensurePicoChannel(""); err != nil { log.Printf("Warning: failed to ensure pico channel: %v", err) // Non-fatal: gateway can still start without pico channel } diff --git a/web/backend/api/pico.go b/web/backend/api/pico.go index a4590dcde..2d2201e16 100644 --- a/web/backend/api/pico.go +++ b/web/backend/api/pico.go @@ -65,9 +65,14 @@ func (h *Handler) handleRegenPicoToken(w http.ResponseWriter, r *http.Request) { }) } -// ensurePicoChannel checks if the Pico Channel is properly configured and -// enables it with sensible defaults if not. Returns true if config was changed. -func (h *Handler) ensurePicoChannel() (bool, error) { +// ensurePicoChannel enables the Pico channel with sane defaults if it isn't +// already configured. Returns true when the config was modified. +// +// callerOrigin is the Origin header from the setup request. If non-empty and +// no origins are configured yet, it's written as the allowed origin so the +// WebSocket handshake works for whatever host the caller is on (LAN, custom +// port, etc.). Pass "" when there's no request context. +func (h *Handler) ensurePicoChannel(callerOrigin string) (bool, error) { cfg, err := config.LoadConfig(h.configPath) if err != nil { return false, fmt.Errorf("failed to load config: %w", err) @@ -85,14 +90,9 @@ func (h *Handler) ensurePicoChannel() (bool, error) { changed = true } - if !cfg.Channels.Pico.AllowTokenQuery { - cfg.Channels.Pico.AllowTokenQuery = true - changed = true - } - - // Make sure origins are allowed (frontend might be running on a different port like 5173 during dev) - if len(cfg.Channels.Pico.AllowOrigins) == 0 { - cfg.Channels.Pico.AllowOrigins = []string{"*"} + // Seed origins from the request instead of hardcoding ports. + if len(cfg.Channels.Pico.AllowOrigins) == 0 && callerOrigin != "" { + cfg.Channels.Pico.AllowOrigins = []string{callerOrigin} changed = true } @@ -109,7 +109,7 @@ func (h *Handler) ensurePicoChannel() (bool, error) { // // POST /api/pico/setup func (h *Handler) handlePicoSetup(w http.ResponseWriter, r *http.Request) { - changed, err := h.ensurePicoChannel() + changed, err := h.ensurePicoChannel(r.Header.Get("Origin")) if err != nil { http.Error(w, err.Error(), http.StatusInternalServerError) return diff --git a/web/backend/api/pico_test.go b/web/backend/api/pico_test.go new file mode 100644 index 000000000..46149fa09 --- /dev/null +++ b/web/backend/api/pico_test.go @@ -0,0 +1,237 @@ +package api + +import ( + "encoding/json" + "net/http" + "net/http/httptest" + "path/filepath" + "testing" + + "github.com/sipeed/picoclaw/pkg/config" +) + +func TestEnsurePicoChannel_FreshConfig(t *testing.T) { + configPath := filepath.Join(t.TempDir(), "config.json") + h := NewHandler(configPath) + + changed, err := h.ensurePicoChannel("") + if err != nil { + t.Fatalf("ensurePicoChannel() error = %v", err) + } + if !changed { + t.Fatal("ensurePicoChannel() should report changed on a fresh config") + } + + cfg, err := config.LoadConfig(configPath) + if err != nil { + t.Fatalf("LoadConfig() error = %v", err) + } + + if !cfg.Channels.Pico.Enabled { + t.Error("expected Pico to be enabled after setup") + } + if cfg.Channels.Pico.Token == "" { + t.Error("expected a non-empty token after setup") + } +} + +func TestEnsurePicoChannel_DoesNotEnableTokenQuery(t *testing.T) { + configPath := filepath.Join(t.TempDir(), "config.json") + h := NewHandler(configPath) + + if _, err := h.ensurePicoChannel(""); err != nil { + t.Fatalf("ensurePicoChannel() error = %v", err) + } + + cfg, err := config.LoadConfig(configPath) + if err != nil { + t.Fatalf("LoadConfig() error = %v", err) + } + + if cfg.Channels.Pico.AllowTokenQuery { + t.Error("setup must not enable allow_token_query by default") + } +} + +func TestEnsurePicoChannel_DoesNotSetWildcardOrigins(t *testing.T) { + configPath := filepath.Join(t.TempDir(), "config.json") + h := NewHandler(configPath) + + if _, err := h.ensurePicoChannel("http://localhost:18800"); err != nil { + t.Fatalf("ensurePicoChannel() error = %v", err) + } + + cfg, err := config.LoadConfig(configPath) + if err != nil { + t.Fatalf("LoadConfig() error = %v", err) + } + + for _, origin := range cfg.Channels.Pico.AllowOrigins { + if origin == "*" { + t.Error("setup must not set wildcard origin '*'") + } + } +} + +func TestEnsurePicoChannel_NoOriginWithoutCaller(t *testing.T) { + configPath := filepath.Join(t.TempDir(), "config.json") + h := NewHandler(configPath) + + if _, err := h.ensurePicoChannel(""); err != nil { + t.Fatalf("ensurePicoChannel() error = %v", err) + } + + cfg, err := config.LoadConfig(configPath) + if err != nil { + t.Fatalf("LoadConfig() error = %v", err) + } + + // Without a caller origin, allow_origins stays empty (CheckOrigin + // allows all when the list is empty, so the channel still works). + if len(cfg.Channels.Pico.AllowOrigins) != 0 { + t.Errorf("allow_origins = %v, want empty when no caller origin", cfg.Channels.Pico.AllowOrigins) + } +} + +func TestEnsurePicoChannel_SetsCallerOrigin(t *testing.T) { + configPath := filepath.Join(t.TempDir(), "config.json") + h := NewHandler(configPath) + + lanOrigin := "http://192.168.1.9:18800" + if _, err := h.ensurePicoChannel(lanOrigin); err != nil { + t.Fatalf("ensurePicoChannel() error = %v", err) + } + + cfg, err := config.LoadConfig(configPath) + if err != nil { + t.Fatalf("LoadConfig() error = %v", err) + } + + if len(cfg.Channels.Pico.AllowOrigins) != 1 || cfg.Channels.Pico.AllowOrigins[0] != lanOrigin { + t.Errorf("allow_origins = %v, want [%s]", cfg.Channels.Pico.AllowOrigins, lanOrigin) + } +} + +func TestEnsurePicoChannel_PreservesUserSettings(t *testing.T) { + configPath := filepath.Join(t.TempDir(), "config.json") + + // Pre-configure with custom user settings + cfg := config.DefaultConfig() + cfg.Channels.Pico.Enabled = true + cfg.Channels.Pico.Token = "user-custom-token" + cfg.Channels.Pico.AllowTokenQuery = true + cfg.Channels.Pico.AllowOrigins = []string{"https://myapp.example.com"} + if err := config.SaveConfig(configPath, cfg); err != nil { + t.Fatalf("SaveConfig() error = %v", err) + } + + h := NewHandler(configPath) + + changed, err := h.ensurePicoChannel("") + if err != nil { + t.Fatalf("ensurePicoChannel() error = %v", err) + } + if changed { + t.Error("ensurePicoChannel() should not change a fully configured config") + } + + cfg, err = config.LoadConfig(configPath) + if err != nil { + t.Fatalf("LoadConfig() error = %v", err) + } + + if cfg.Channels.Pico.Token != "user-custom-token" { + t.Errorf("token = %q, want %q", cfg.Channels.Pico.Token, "user-custom-token") + } + if !cfg.Channels.Pico.AllowTokenQuery { + t.Error("user's allow_token_query=true must be preserved") + } + if len(cfg.Channels.Pico.AllowOrigins) != 1 || cfg.Channels.Pico.AllowOrigins[0] != "https://myapp.example.com" { + t.Errorf("allow_origins = %v, want [https://myapp.example.com]", cfg.Channels.Pico.AllowOrigins) + } +} + +func TestEnsurePicoChannel_Idempotent(t *testing.T) { + configPath := filepath.Join(t.TempDir(), "config.json") + h := NewHandler(configPath) + + origin := "http://localhost:18800" + + // First call sets things up + if _, err := h.ensurePicoChannel(origin); err != nil { + t.Fatalf("first ensurePicoChannel() error = %v", err) + } + + cfg1, _ := config.LoadConfig(configPath) + token1 := cfg1.Channels.Pico.Token + + // Second call should be a no-op + changed, err := h.ensurePicoChannel(origin) + if err != nil { + t.Fatalf("second ensurePicoChannel() error = %v", err) + } + if changed { + t.Error("second ensurePicoChannel() should not report changed") + } + + cfg2, _ := config.LoadConfig(configPath) + if cfg2.Channels.Pico.Token != token1 { + t.Error("token should not change on subsequent calls") + } +} + +func TestHandlePicoSetup_IncludesRequestOrigin(t *testing.T) { + configPath := filepath.Join(t.TempDir(), "config.json") + h := NewHandler(configPath) + + req := httptest.NewRequest("POST", "/api/pico/setup", nil) + req.Header.Set("Origin", "http://10.0.0.5:3000") + rec := httptest.NewRecorder() + + h.handlePicoSetup(rec, req) + + if rec.Code != http.StatusOK { + t.Fatalf("status = %d, want %d", rec.Code, http.StatusOK) + } + + cfg, err := config.LoadConfig(configPath) + if err != nil { + t.Fatalf("LoadConfig() error = %v", err) + } + + if len(cfg.Channels.Pico.AllowOrigins) != 1 || cfg.Channels.Pico.AllowOrigins[0] != "http://10.0.0.5:3000" { + t.Errorf("allow_origins = %v, want [http://10.0.0.5:3000]", cfg.Channels.Pico.AllowOrigins) + } +} + +func TestHandlePicoSetup_Response(t *testing.T) { + configPath := filepath.Join(t.TempDir(), "config.json") + h := NewHandler(configPath) + + req := httptest.NewRequest("POST", "/api/pico/setup", nil) + rec := httptest.NewRecorder() + + h.handlePicoSetup(rec, req) + + if rec.Code != http.StatusOK { + t.Fatalf("status = %d, want %d", rec.Code, http.StatusOK) + } + + var resp map[string]any + if err := json.NewDecoder(rec.Body).Decode(&resp); err != nil { + t.Fatalf("failed to decode response: %v", err) + } + + if resp["token"] == nil || resp["token"] == "" { + t.Error("response should contain a non-empty token") + } + if resp["ws_url"] == nil || resp["ws_url"] == "" { + t.Error("response should contain ws_url") + } + if resp["enabled"] != true { + t.Error("response should have enabled=true") + } + if resp["changed"] != true { + t.Error("response should have changed=true on first setup") + } +} diff --git a/web/frontend/src/lib/pico-chat-controller.ts b/web/frontend/src/lib/pico-chat-controller.ts index be3397bae..0e77d1ad0 100644 --- a/web/frontend/src/lib/pico-chat-controller.ts +++ b/web/frontend/src/lib/pico-chat-controller.ts @@ -165,8 +165,9 @@ export async function connectChat() { console.warn("Could not parse ws_url:", error) } - const url = `${finalWsUrl}?token=${encodeURIComponent(token)}&session_id=${encodeURIComponent(activeSessionIdRef)}` - const socket = new WebSocket(url) + const url = `${finalWsUrl}?session_id=${encodeURIComponent(activeSessionIdRef)}` + // Send token as a subprotocol so it doesn't end up in the URL. + const socket = new WebSocket(url, [`token.${token}`]) if (generation !== connectionGeneration) { socket.close() From 45c01f4d91bd2f1ec7d0945fbca09372571850b9 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 16 Mar 2026 10:42:04 +0800 Subject: [PATCH 17/56] chore(deps): bump golang.org/x/oauth2 from 0.35.0 to 0.36.0 (#1596) Bumps [golang.org/x/oauth2](https://github.com/golang/oauth2) from 0.35.0 to 0.36.0. - [Commits](https://github.com/golang/oauth2/compare/v0.35.0...v0.36.0) --- updated-dependencies: - dependency-name: golang.org/x/oauth2 dependency-version: 0.36.0 dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> 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 f29ef7207..a2ce5c511 100644 --- a/go.mod +++ b/go.mod @@ -27,7 +27,7 @@ require ( github.com/stretchr/testify v1.11.1 github.com/tencent-connect/botgo v0.2.1 go.mau.fi/whatsmeow v0.0.0-20260219150138-7ae702b1eed4 - golang.org/x/oauth2 v0.35.0 + golang.org/x/oauth2 v0.36.0 golang.org/x/time v0.14.0 google.golang.org/protobuf v1.36.11 gopkg.in/yaml.v3 v3.0.1 diff --git a/go.sum b/go.sum index addbab56c..c8ee84e87 100644 --- a/go.sum +++ b/go.sum @@ -270,8 +270,8 @@ golang.org/x/net v0.19.0/go.mod h1:CfAk/cbD4CthTvqiEl8NpboMuiuOYsAr/7NOjZJtv1U= golang.org/x/net v0.51.0 h1:94R/GTO7mt3/4wIKpcR5gkGmRLOuE/2hNGeWq/GBIFo= golang.org/x/net v0.51.0/go.mod h1:aamm+2QF5ogm02fjy5Bb7CQ0WMt1/WVM7FtyaTLlA9Y= golang.org/x/oauth2 v0.23.0/go.mod h1:XYTD2NtWslqkgxebSiOHnXEap4TF09sJSc7H1sXbhtI= -golang.org/x/oauth2 v0.35.0 h1:Mv2mzuHuZuY2+bkyWXIHMfhNdJAdwW3FuWeCPYN5GVQ= -golang.org/x/oauth2 v0.35.0/go.mod h1:lzm5WQJQwKZ3nwavOZ3IS5Aulzxi68dUSgRHujetwEA= +golang.org/x/oauth2 v0.36.0 h1:peZ/1z27fi9hUOFCAZaHyrpWG5lwe0RJEEEeH0ThlIs= +golang.org/x/oauth2 v0.36.0/go.mod h1:YDBUJMTkDnJS+A4BP4eZBjCqtokkg1hODuPjwiGPO7Q= golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20190911185100-cd5d95a43a6e/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= From dd936302d1223613693c7942364eb4d4d8597b4f Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 16 Mar 2026 10:46:54 +0800 Subject: [PATCH 18/56] chore(deps): bump github.com/mymmrac/telego from 1.6.0 to 1.7.0 (#1598) Bumps [github.com/mymmrac/telego](https://github.com/mymmrac/telego) from 1.6.0 to 1.7.0. - [Release notes](https://github.com/mymmrac/telego/releases) - [Commits](https://github.com/mymmrac/telego/compare/v1.6.0...v1.7.0) --- updated-dependencies: - dependency-name: github.com/mymmrac/telego dependency-version: 1.7.0 dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- go.mod | 4 ++-- go.sum | 8 ++++---- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/go.mod b/go.mod index a2ce5c511..c0e2fa60c 100644 --- a/go.mod +++ b/go.mod @@ -17,7 +17,7 @@ require ( 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.1 - github.com/mymmrac/telego v1.6.0 + github.com/mymmrac/telego v1.7.0 github.com/open-dingtalk/dingtalk-stream-sdk-go v0.9.1 github.com/openai/openai-go/v3 v3.22.0 github.com/rivo/tview v0.42.0 @@ -87,7 +87,7 @@ require ( github.com/twitchyliquid64/golang-asm v0.15.1 // indirect github.com/valyala/bytebufferpool v1.0.0 // indirect github.com/valyala/fasthttp v1.69.0 // indirect - github.com/valyala/fastjson v1.6.7 // indirect + github.com/valyala/fastjson v1.6.10 // indirect github.com/yosida95/uritemplate/v3 v3.0.2 // indirect golang.org/x/arch v0.24.0 // indirect golang.org/x/crypto v0.48.0 // indirect diff --git a/go.sum b/go.sum index c8ee84e87..11be48d87 100644 --- a/go.sum +++ b/go.sum @@ -136,8 +136,8 @@ github.com/mdp/qrterminal/v3 v3.2.1 h1:6+yQjiiOsSuXT5n9/m60E54vdgFsw0zhADHhHLrFe github.com/mdp/qrterminal/v3 v3.2.1/go.mod h1:jOTmXvnBsMy5xqLniO0R++Jmjs2sTm9dFSuQ5kpz/SU= 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/mymmrac/telego v1.7.0 h1:yRO/l00tFGG4nY66ufUKb4ARqv7qx9+LsjQv/b0NEyo= +github.com/mymmrac/telego v1.7.0/go.mod h1:pdLV346EgVuq7Xrh3kMggeBiazeHhsdEoK0RTEOPXRM= github.com/ncruces/go-strftime v1.0.0 h1:HMFp8mLCTPp341M/ZnA4qaf7ZlsbTc+miZjCLOFAw7w= github.com/ncruces/go-strftime v1.0.0/go.mod h1:Fwc5htZGVVkseilnfgOVb9mKy6w1naJmn9CehxcKcls= github.com/nxadm/tail v1.4.4/go.mod h1:kenIhsEOeOJmVchQTgglprH7qJGnHDVpk1VPCcaMI8A= @@ -216,8 +216,8 @@ github.com/valyala/bytebufferpool v1.0.0 h1:GqA5TC/0021Y/b9FG4Oi9Mr3q7XYx6Kllzaw github.com/valyala/bytebufferpool v1.0.0/go.mod h1:6bBcMArwyJ5K/AmCkWv1jt77kVWyCJ6HpOuEn7z0Csc= github.com/valyala/fasthttp v1.69.0 h1:fNLLESD2SooWeh2cidsuFtOcrEi4uB4m1mPrkJMZyVI= github.com/valyala/fasthttp v1.69.0/go.mod h1:4wA4PfAraPlAsJ5jMSqCE2ug5tqUPwKXxVj8oNECGcw= -github.com/valyala/fastjson v1.6.7 h1:ZE4tRy0CIkh+qDc5McjatheGX2czdn8slQjomexVpBM= -github.com/valyala/fastjson v1.6.7/go.mod h1:CLCAqky6SMuOcxStkYQvblddUtoRxhYMGLrsQns1aXY= +github.com/valyala/fastjson v1.6.10 h1:/yjJg8jaVQdYR3arGxPE2X5z89xrlhS0eGXdv+ADTh4= +github.com/valyala/fastjson v1.6.10/go.mod h1:e6FubmQouUNP73jtMLmcbxS6ydWIpOfhz34TSfO3JaE= github.com/vektah/gqlparser/v2 v2.5.27 h1:RHPD3JOplpk5mP5JGX8RKZkt2/Vwj/PZv0HxTdwFp0s= github.com/vektah/gqlparser/v2 v2.5.27/go.mod h1:D1/VCZtV3LPnQrcPBeR/q5jkSQIPti0uYCP/RI0gIeo= github.com/xyproto/randomstring v1.0.5 h1:YtlWPoRdgMu3NZtP45drfy1GKoojuR7hmRcnhZqKjWU= From e9d240d760bab164ceabf13f58f33d2909a45f37 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 16 Mar 2026 10:47:46 +0800 Subject: [PATCH 19/56] chore(deps): bump github.com/caarlos0/env/v11 from 11.3.1 to 11.4.0 (#1599) Bumps [github.com/caarlos0/env/v11](https://github.com/caarlos0/env) from 11.3.1 to 11.4.0. - [Release notes](https://github.com/caarlos0/env/releases) - [Commits](https://github.com/caarlos0/env/compare/v11.3.1...v11.4.0) --- updated-dependencies: - dependency-name: github.com/caarlos0/env/v11 dependency-version: 11.4.0 dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> 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 c0e2fa60c..e48b3006f 100644 --- a/go.mod +++ b/go.mod @@ -6,7 +6,7 @@ require ( github.com/adhocore/gronx v1.19.6 github.com/anthropics/anthropic-sdk-go v1.22.1 github.com/bwmarrin/discordgo v0.29.0 - github.com/caarlos0/env/v11 v11.3.1 + github.com/caarlos0/env/v11 v11.4.0 github.com/ergochat/irc-go v0.5.0 github.com/ergochat/readline v0.1.3 github.com/gdamore/tcell/v2 v2.13.8 diff --git a/go.sum b/go.sum index 11be48d87..810bdac62 100644 --- a/go.sum +++ b/go.sum @@ -23,8 +23,8 @@ github.com/bytedance/sonic v1.15.0 h1:/PXeWFaR5ElNcVE84U0dOHjiMHQOwNIx3K4ymzh/uS github.com/bytedance/sonic v1.15.0/go.mod h1:tFkWrPz0/CUCLEF4ri4UkHekCIcdnkqXw9VduqpJh0k= github.com/bytedance/sonic/loader v0.5.0 h1:gXH3KVnatgY7loH5/TkeVyXPfESoqSBSBEiDd5VjlgE= github.com/bytedance/sonic/loader v0.5.0/go.mod h1:AR4NYCk5DdzZizZ5djGqQ92eEhCCcdf5x77udYiSJRo= -github.com/caarlos0/env/v11 v11.3.1 h1:cArPWC15hWmEt+gWk7YBi7lEXTXCvpaSdCiZE2X5mCA= -github.com/caarlos0/env/v11 v11.3.1/go.mod h1:qupehSf/Y0TUTsxKywqRt/vJjN5nz6vauiYEUUr8P4U= +github.com/caarlos0/env/v11 v11.4.0 h1:Kcb6t5kIIr4XkoQC9AF2j+8E1Jsrl3Wz/hhm1LtoGAc= +github.com/caarlos0/env/v11 v11.4.0/go.mod h1:qupehSf/Y0TUTsxKywqRt/vJjN5nz6vauiYEUUr8P4U= github.com/cespare/xxhash/v2 v2.1.2/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs= github.com/cespare/xxhash/v2 v2.2.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs= github.com/cloudwego/base64x v0.1.6 h1:t11wG9AECkCDk5fMSoxmufanudBtJ+/HemLstXDLI2M= From 2f40a8c165810a88442630b231d25fbd17937ea3 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 16 Mar 2026 10:51:55 +0800 Subject: [PATCH 20/56] chore(deps): bump github.com/anthropics/anthropic-sdk-go (#1601) Bumps [github.com/anthropics/anthropic-sdk-go](https://github.com/anthropics/anthropic-sdk-go) from 1.22.1 to 1.26.0. - [Release notes](https://github.com/anthropics/anthropic-sdk-go/releases) - [Changelog](https://github.com/anthropics/anthropic-sdk-go/blob/main/CHANGELOG.md) - [Commits](https://github.com/anthropics/anthropic-sdk-go/compare/v1.22.1...v1.26.0) --- updated-dependencies: - dependency-name: github.com/anthropics/anthropic-sdk-go dependency-version: 1.26.0 dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- go.mod | 2 +- go.sum | 7 +++++-- 2 files changed, 6 insertions(+), 3 deletions(-) diff --git a/go.mod b/go.mod index e48b3006f..6f5de1605 100644 --- a/go.mod +++ b/go.mod @@ -4,7 +4,7 @@ go 1.25.7 require ( github.com/adhocore/gronx v1.19.6 - github.com/anthropics/anthropic-sdk-go v1.22.1 + github.com/anthropics/anthropic-sdk-go v1.26.0 github.com/bwmarrin/discordgo v0.29.0 github.com/caarlos0/env/v11 v11.4.0 github.com/ergochat/irc-go v0.5.0 diff --git a/go.sum b/go.sum index 810bdac62..0fb4be1b8 100644 --- a/go.sum +++ b/go.sum @@ -11,8 +11,8 @@ github.com/andreyvit/diff v0.0.0-20170406064948-c7f18ee00883 h1:bvNMNQO63//z+xNg github.com/andreyvit/diff v0.0.0-20170406064948-c7f18ee00883/go.mod h1:rCTlJbsFo29Kk6CurOXKm700vrz8f0KW0JNfpkRJY/8= github.com/andybalholm/brotli v1.2.0 h1:ukwgCxwYrmACq68yiUqwIWnGY0cTPox/M94sVwToPjQ= github.com/andybalholm/brotli v1.2.0/go.mod h1:rzTDkvFWvIrjDXZHkuS16NPggd91W3kUSvPlQ1pLaKY= -github.com/anthropics/anthropic-sdk-go v1.22.1 h1:xbsc3vJKCX/ELDZSpTNfz9wCgrFsamwFewPb1iI0Xh0= -github.com/anthropics/anthropic-sdk-go v1.22.1/go.mod h1:WTz31rIUHUHqai2UslPpw5CwXrQP3geYBioRV4WOLvE= +github.com/anthropics/anthropic-sdk-go v1.26.0 h1:oUTzFaUpAevfuELAP1sjL6CQJ9HHAfT7CoSYSac11PY= +github.com/anthropics/anthropic-sdk-go v1.26.0/go.mod h1:qUKmaW+uuPB64iy1l+4kOSvaLqPXnHTTBKH6RVZ7q5Q= github.com/beeper/argo-go v1.1.2 h1:UQI2G8F+NLfGTOmTUI0254pGKx/HUU/etbUGTJv91Fs= github.com/beeper/argo-go v1.1.2/go.mod h1:M+LJAnyowKVQ6Rdj6XYGEn+qcVFkb3R/MUpqkGR0hM4= github.com/bwmarrin/discordgo v0.29.0 h1:FmWeXFaKUwrcL3Cx65c20bTRW+vOb6k8AnaP+EgjDno= @@ -38,6 +38,8 @@ github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSs github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c= github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f/go.mod h1:cuUVRXasLTGF7a8hSLbxyZXjz+1KgoB3wDUb6vlszIc= +github.com/dnaeon/go-vcr v1.2.0 h1:zHCHvJYTMh1N7xnV7zf1m1GPBF9Ad0Jk/whtQ1663qI= +github.com/dnaeon/go-vcr v1.2.0/go.mod h1:R4UdLID7HZT3taECzJs4YgbbH6PIGXB6W/sc5OLb6RQ= github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY= 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= @@ -354,6 +356,7 @@ gopkg.in/tomb.v1 v1.0.0-20141024135613-dd632973f1e7/go.mod h1:dt/ZhP58zS4L8KSrWD gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= gopkg.in/yaml.v2 v2.2.4/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= gopkg.in/yaml.v2 v2.3.0/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= +gopkg.in/yaml.v2 v2.4.0 h1:D8xgwECY7CYvx+Y2n4sBz93Jn9JRvxdiyyo8CTfuKaY= gopkg.in/yaml.v2 v2.4.0/go.mod h1:RDklbk79AGWmwhnvt/jBztapEOGDOx6ZbXqjP6csGnQ= gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA= From 43eb6fe20c5670fa15ce261174e0c1a2ac1f3c80 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 16 Mar 2026 10:58:18 +0800 Subject: [PATCH 21/56] chore(deps): bump github.com/github/copilot-sdk/go from 0.1.23 to 0.1.32 (#1603) Bumps [github.com/github/copilot-sdk/go](https://github.com/github/copilot-sdk) from 0.1.23 to 0.1.32. - [Release notes](https://github.com/github/copilot-sdk/releases) - [Changelog](https://github.com/github/copilot-sdk/blob/main/CHANGELOG.md) - [Commits](https://github.com/github/copilot-sdk/compare/v0.1.23...v0.1.32) --- updated-dependencies: - dependency-name: github.com/github/copilot-sdk/go dependency-version: 0.1.32 dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <support@github.com> 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 6f5de1605..130db73ff 100644 --- a/go.mod +++ b/go.mod @@ -73,7 +73,7 @@ require ( github.com/bytedance/sonic v1.15.0 // indirect github.com/bytedance/sonic/loader v0.5.0 // indirect github.com/cloudwego/base64x v0.1.6 // indirect - github.com/github/copilot-sdk/go v0.1.23 + github.com/github/copilot-sdk/go v0.1.32 github.com/go-resty/resty/v2 v2.17.1 // indirect github.com/gogo/protobuf v1.3.2 // indirect github.com/google/jsonschema-go v0.4.2 // indirect diff --git a/go.sum b/go.sum index 0fb4be1b8..a4d8ed3d0 100644 --- a/go.sum +++ b/go.sum @@ -54,8 +54,8 @@ github.com/gdamore/encoding v1.0.1 h1:YzKZckdBL6jVt2Gc+5p82qhrGiqMdG/eNs6Wy0u3Uh github.com/gdamore/encoding v1.0.1/go.mod h1:0Z0cMFinngz9kS1QfMjCP8TY7em3bZYeeklsSDPivEo= github.com/gdamore/tcell/v2 v2.13.8 h1:Mys/Kl5wfC/GcC5Cx4C2BIQH9dbnhnkPgS9/wF3RlfU= github.com/gdamore/tcell/v2 v2.13.8/go.mod h1:+Wfe208WDdB7INEtCsNrAN6O2m+wsTPk1RAovjaILlo= -github.com/github/copilot-sdk/go v0.1.23 h1:uExtO/inZQndCZMiSAA1hvXINiz9tqo/MZgQzFzurxw= -github.com/github/copilot-sdk/go v0.1.23/go.mod h1:GdwwBfMbm9AABLEM3x5IZKw4ZfwCYxZ1BgyytmZenQ0= +github.com/github/copilot-sdk/go v0.1.32 h1:wc9SFWwxXhJts6vyzzboPLJqcEJGnHE8rMCAY1RrUgo= +github.com/github/copilot-sdk/go v0.1.32/go.mod h1:qc2iEF7hdO8kzSvbyGvrcGhuk2fzdW4xTtT0+1EH2ts= github.com/go-redis/redis/v8 v8.11.4/go.mod h1:2Z2wHZXdQpCDXEGzqMockDpNyYvi2l4Pxt6RJr792+w= github.com/go-resty/resty/v2 v2.6.0/go.mod h1:PwvJS6hvaPkjtjNg9ph+VrSD92bi5Zq73w/BIH7cC3Q= github.com/go-resty/resty/v2 v2.17.1 h1:x3aMpHK1YM9e4va/TMDRlusDDoZiQ+ViDu/WpA6xTM4= From b8dfd0befc44233c2193f599797aa0c0a781c687 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 16 Mar 2026 10:58:48 +0800 Subject: [PATCH 22/56] chore(deps): bump jotai from 2.18.0 to 2.18.1 in /web/frontend (#1605) Bumps [jotai](https://github.com/pmndrs/jotai) from 2.18.0 to 2.18.1. - [Release notes](https://github.com/pmndrs/jotai/releases) - [Commits](https://github.com/pmndrs/jotai/compare/v2.18.0...v2.18.1) --- updated-dependencies: - dependency-name: jotai dependency-version: 2.18.1 dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- web/frontend/package.json | 2 +- web/frontend/pnpm-lock.yaml | 10 +++++----- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/web/frontend/package.json b/web/frontend/package.json index 373b4d468..8d5b77fb9 100644 --- a/web/frontend/package.json +++ b/web/frontend/package.json @@ -24,7 +24,7 @@ "dayjs": "^1.11.19", "i18next": "^25.8.14", "i18next-browser-languagedetector": "^8.2.1", - "jotai": "^2.18.0", + "jotai": "^2.18.1", "radix-ui": "^1.4.3", "react": "^19.2.0", "react-dom": "^19.2.0", diff --git a/web/frontend/pnpm-lock.yaml b/web/frontend/pnpm-lock.yaml index 75acacfa5..a1ea2a512 100644 --- a/web/frontend/pnpm-lock.yaml +++ b/web/frontend/pnpm-lock.yaml @@ -42,8 +42,8 @@ importers: specifier: ^8.2.1 version: 8.2.1 jotai: - specifier: ^2.18.0 - version: 2.18.0(@babel/core@7.29.0)(@babel/template@7.28.6)(@types/react@19.2.14)(react@19.2.4) + specifier: ^2.18.1 + version: 2.18.1(@babel/core@7.29.0)(@babel/template@7.28.6)(@types/react@19.2.14)(react@19.2.4) radix-ui: specifier: ^1.4.3 version: 1.4.3(@types/react-dom@19.2.3(@types/react@19.2.14))(@types/react@19.2.14)(react-dom@19.2.4(react@19.2.4))(react@19.2.4) @@ -2669,8 +2669,8 @@ packages: jose@6.1.3: resolution: {integrity: sha512-0TpaTfihd4QMNwrz/ob2Bp7X04yuxJkjRGi4aKmOqwhov54i6u79oCv7T+C7lo70MKH6BesI3vscD1yb/yzKXQ==} - jotai@2.18.0: - resolution: {integrity: sha512-XI38kGWAvtxAZ+cwHcTgJsd+kJOJGf3OfL4XYaXWZMZ7IIY8e53abpIHvtVn1eAgJ5dlgwlGFnP4psrZ/vZbtA==} + jotai@2.18.1: + resolution: {integrity: sha512-e0NOzK+yRFwHo7DOp0DS0Ycq74KMEAObDWFGmfEL28PD9nLqBTt3/Ug7jf9ca72x0gC9LQZG9zH+0ISICmy3iA==} engines: {node: '>=12.20.0'} peerDependencies: '@babel/core': '>=7.0.0' @@ -6501,7 +6501,7 @@ snapshots: jose@6.1.3: {} - jotai@2.18.0(@babel/core@7.29.0)(@babel/template@7.28.6)(@types/react@19.2.14)(react@19.2.4): + jotai@2.18.1(@babel/core@7.29.0)(@babel/template@7.28.6)(@types/react@19.2.14)(react@19.2.4): optionalDependencies: '@babel/core': 7.29.0 '@babel/template': 7.28.6 From a93bd0132933b6a6251395ca4fa8c6fcf67ab3aa Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 16 Mar 2026 11:04:50 +0800 Subject: [PATCH 23/56] chore(deps-dev): bump @vitejs/plugin-react in /web/frontend (#1606) Bumps [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/tree/HEAD/packages/plugin-react) from 5.1.4 to 5.2.0. - [Release notes](https://github.com/vitejs/vite-plugin-react/releases) - [Changelog](https://github.com/vitejs/vite-plugin-react/blob/plugin-react@5.2.0/packages/plugin-react/CHANGELOG.md) - [Commits](https://github.com/vitejs/vite-plugin-react/commits/plugin-react@5.2.0/packages/plugin-react) --- updated-dependencies: - dependency-name: "@vitejs/plugin-react" dependency-version: 5.2.0 dependency-type: direct:development update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- web/frontend/package.json | 2 +- web/frontend/pnpm-lock.yaml | 12 ++++++------ 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/web/frontend/package.json b/web/frontend/package.json index 8d5b77fb9..189b93fc0 100644 --- a/web/frontend/package.json +++ b/web/frontend/package.json @@ -48,7 +48,7 @@ "@types/react": "^19.2.7", "@types/react-dom": "^19.2.3", "@typescript-eslint/eslint-plugin": "^8.56.1", - "@vitejs/plugin-react": "^5.1.1", + "@vitejs/plugin-react": "^5.2.0", "eslint": "^9.39.1", "eslint-config-prettier": "^10.1.8", "eslint-plugin-react-hooks": "^7.0.1", diff --git a/web/frontend/pnpm-lock.yaml b/web/frontend/pnpm-lock.yaml index a1ea2a512..2510d06ee 100644 --- a/web/frontend/pnpm-lock.yaml +++ b/web/frontend/pnpm-lock.yaml @@ -109,8 +109,8 @@ importers: specifier: ^8.56.1 version: 8.56.1(@typescript-eslint/parser@8.56.1(eslint@9.39.3(jiti@2.6.1))(typescript@5.9.3))(eslint@9.39.3(jiti@2.6.1))(typescript@5.9.3) '@vitejs/plugin-react': - specifier: ^5.1.1 - version: 5.1.4(vite@7.3.1(@types/node@24.11.0)(jiti@2.6.1)(lightningcss@1.31.1)(tsx@4.21.0)) + specifier: ^5.2.0 + version: 5.2.0(vite@7.3.1(@types/node@24.11.0)(jiti@2.6.1)(lightningcss@1.31.1)(tsx@4.21.0)) eslint: specifier: ^9.39.1 version: 9.39.3(jiti@2.6.1) @@ -1790,11 +1790,11 @@ packages: '@ungap/structured-clone@1.3.0': resolution: {integrity: sha512-WmoN8qaIAo7WTYWbAZuG8PYEhn5fkz7dZrqTBZ7dtt//lL2Gwms1IcnQ5yHqjDfX8Ft5j4YzDM23f87zBfDe9g==} - '@vitejs/plugin-react@5.1.4': - resolution: {integrity: sha512-VIcFLdRi/VYRU8OL/puL7QXMYafHmqOnwTZY50U1JPlCNj30PxCMx65c494b1K9be9hX83KVt0+gTEwTWLqToA==} + '@vitejs/plugin-react@5.2.0': + resolution: {integrity: sha512-YmKkfhOAi3wsB1PhJq5Scj3GXMn3WvtQ/JC0xoopuHoXSdmtdStOpFrYaT1kie2YgFBcIe64ROzMYRjCrYOdYw==} engines: {node: ^20.19.0 || >=22.12.0} peerDependencies: - vite: ^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 + vite: ^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0 accepts@2.0.0: resolution: {integrity: sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng==} @@ -5641,7 +5641,7 @@ snapshots: '@ungap/structured-clone@1.3.0': {} - '@vitejs/plugin-react@5.1.4(vite@7.3.1(@types/node@24.11.0)(jiti@2.6.1)(lightningcss@1.31.1)(tsx@4.21.0))': + '@vitejs/plugin-react@5.2.0(vite@7.3.1(@types/node@24.11.0)(jiti@2.6.1)(lightningcss@1.31.1)(tsx@4.21.0))': dependencies: '@babel/core': 7.29.0 '@babel/plugin-transform-react-jsx-self': 7.27.1(@babel/core@7.29.0) From 3bf8a27570112488d1a0f0bdec892e80dee23fb3 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 16 Mar 2026 11:05:03 +0800 Subject: [PATCH 24/56] chore(deps): bump react-i18next from 16.5.4 to 16.5.8 in /web/frontend (#1607) Bumps [react-i18next](https://github.com/i18next/react-i18next) from 16.5.4 to 16.5.8. - [Changelog](https://github.com/i18next/react-i18next/blob/master/CHANGELOG.md) - [Commits](https://github.com/i18next/react-i18next/compare/v16.5.4...v16.5.8) --- updated-dependencies: - dependency-name: react-i18next dependency-version: 16.5.8 dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- web/frontend/package.json | 2 +- web/frontend/pnpm-lock.yaml | 10 +++++----- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/web/frontend/package.json b/web/frontend/package.json index 189b93fc0..d6d13a8fd 100644 --- a/web/frontend/package.json +++ b/web/frontend/package.json @@ -28,7 +28,7 @@ "radix-ui": "^1.4.3", "react": "^19.2.0", "react-dom": "^19.2.0", - "react-i18next": "^16.5.4", + "react-i18next": "^16.5.8", "react-markdown": "^10.1.0", "react-textarea-autosize": "^8.5.9", "remark-gfm": "^4.0.1", diff --git a/web/frontend/pnpm-lock.yaml b/web/frontend/pnpm-lock.yaml index 2510d06ee..38820d871 100644 --- a/web/frontend/pnpm-lock.yaml +++ b/web/frontend/pnpm-lock.yaml @@ -54,8 +54,8 @@ importers: specifier: ^19.2.0 version: 19.2.4(react@19.2.4) react-i18next: - specifier: ^16.5.4 - version: 16.5.4(i18next@25.8.14(typescript@5.9.3))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(typescript@5.9.3) + specifier: ^16.5.8 + version: 16.5.8(i18next@25.8.14(typescript@5.9.3))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(typescript@5.9.3) react-markdown: specifier: ^10.1.0 version: 10.1.0(@types/react@19.2.14)(react@19.2.4) @@ -3323,8 +3323,8 @@ packages: peerDependencies: react: ^19.2.4 - react-i18next@16.5.4: - resolution: {integrity: sha512-6yj+dcfMncEC21QPhOTsW8mOSO+pzFmT6uvU7XXdvM/Cp38zJkmTeMeKmTrmCMD5ToT79FmiE/mRWiYWcJYW4g==} + react-i18next@16.5.8: + resolution: {integrity: sha512-2ABeHHlakxVY+LSirD+OiERxFL6+zip0PaHo979bgwzeHg27Sqc82xxXWIrSFmfWX0ZkrvXMHwhsi/NGUf5VQg==} peerDependencies: i18next: '>= 25.6.2' react: '>= 16.8.0' @@ -7310,7 +7310,7 @@ snapshots: react: 19.2.4 scheduler: 0.27.0 - react-i18next@16.5.4(i18next@25.8.14(typescript@5.9.3))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(typescript@5.9.3): + react-i18next@16.5.8(i18next@25.8.14(typescript@5.9.3))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(typescript@5.9.3): dependencies: '@babel/runtime': 7.28.6 html-parse-stringify: 3.0.1 From 99304d1f8e779294439660a443d5d45e5832cd9a Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 16 Mar 2026 11:05:17 +0800 Subject: [PATCH 25/56] chore(deps): bump dayjs from 1.11.19 to 1.11.20 in /web/frontend (#1608) Bumps [dayjs](https://github.com/iamkun/dayjs) from 1.11.19 to 1.11.20. - [Release notes](https://github.com/iamkun/dayjs/releases) - [Changelog](https://github.com/iamkun/dayjs/blob/dev/CHANGELOG.md) - [Commits](https://github.com/iamkun/dayjs/compare/v1.11.19...v1.11.20) --- updated-dependencies: - dependency-name: dayjs dependency-version: 1.11.20 dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- web/frontend/package.json | 2 +- web/frontend/pnpm-lock.yaml | 10 +++++----- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/web/frontend/package.json b/web/frontend/package.json index d6d13a8fd..6a4719adb 100644 --- a/web/frontend/package.json +++ b/web/frontend/package.json @@ -21,7 +21,7 @@ "@tanstack/react-router-devtools": "^1.163.3", "class-variance-authority": "^0.7.1", "clsx": "^2.1.1", - "dayjs": "^1.11.19", + "dayjs": "^1.11.20", "i18next": "^25.8.14", "i18next-browser-languagedetector": "^8.2.1", "jotai": "^2.18.1", diff --git a/web/frontend/pnpm-lock.yaml b/web/frontend/pnpm-lock.yaml index 38820d871..3c6c4c7cf 100644 --- a/web/frontend/pnpm-lock.yaml +++ b/web/frontend/pnpm-lock.yaml @@ -33,8 +33,8 @@ importers: specifier: ^2.1.1 version: 2.1.1 dayjs: - specifier: ^1.11.19 - version: 1.11.19 + specifier: ^1.11.20 + version: 1.11.20 i18next: specifier: ^25.8.14 version: 25.8.14(typescript@5.9.3) @@ -2060,8 +2060,8 @@ packages: resolution: {integrity: sha512-0R9ikRb668HB7QDxT1vkpuUBtqc53YyAwMwGeUFKRojY/NWKvdZ+9UYtRfGmhqNbRkTSVpMbmyhXipFFv2cb/A==} engines: {node: '>= 12'} - dayjs@1.11.19: - resolution: {integrity: sha512-t5EcLVS6QPBNqM2z8fakk/NKel+Xzshgt8FFKAn+qwlD1pzZWxh0nVCrvFK7ZDb6XucZeF9z8C7CBWTRIVApAw==} + dayjs@1.11.20: + resolution: {integrity: sha512-YbwwqR/uYpeoP4pu043q+LTDLFBLApUP6VxRihdfNTqu4ubqMlGDLd6ErXhEgsyvY0K6nCs7nggYumAN+9uEuQ==} debug@4.4.3: resolution: {integrity: sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==} @@ -5894,7 +5894,7 @@ snapshots: data-uri-to-buffer@4.0.1: {} - dayjs@1.11.19: {} + dayjs@1.11.20: {} debug@4.4.3: dependencies: From 4178b2cec5028ab0b86cc0bdd5c0ff0c2ffbca9f Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 16 Mar 2026 11:05:31 +0800 Subject: [PATCH 26/56] chore(deps): bump @tanstack/react-router in /web/frontend (#1609) Bumps [@tanstack/react-router](https://github.com/TanStack/router/tree/HEAD/packages/react-router) from 1.163.3 to 1.167.0. - [Release notes](https://github.com/TanStack/router/releases) - [Changelog](https://github.com/TanStack/router/blob/main/packages/react-router/CHANGELOG.md) - [Commits](https://github.com/TanStack/router/commits/@tanstack/react-router@1.167.0/packages/react-router) --- updated-dependencies: - dependency-name: "@tanstack/react-router" dependency-version: 1.167.0 dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- web/frontend/package.json | 2 +- web/frontend/pnpm-lock.yaml | 85 ++++++++++++++++++++++++++----------- 2 files changed, 61 insertions(+), 26 deletions(-) diff --git a/web/frontend/package.json b/web/frontend/package.json index 6a4719adb..f3bae6d6a 100644 --- a/web/frontend/package.json +++ b/web/frontend/package.json @@ -17,7 +17,7 @@ "@tabler/icons-react": "^3.38.0", "@tailwindcss/vite": "^4.2.1", "@tanstack/react-query": "^5.90.21", - "@tanstack/react-router": "^1.163.3", + "@tanstack/react-router": "^1.167.0", "@tanstack/react-router-devtools": "^1.163.3", "class-variance-authority": "^0.7.1", "clsx": "^2.1.1", diff --git a/web/frontend/pnpm-lock.yaml b/web/frontend/pnpm-lock.yaml index 3c6c4c7cf..ac2168798 100644 --- a/web/frontend/pnpm-lock.yaml +++ b/web/frontend/pnpm-lock.yaml @@ -21,11 +21,11 @@ importers: specifier: ^5.90.21 version: 5.90.21(react@19.2.4) '@tanstack/react-router': - specifier: ^1.163.3 - version: 1.163.3(react-dom@19.2.4(react@19.2.4))(react@19.2.4) + specifier: ^1.167.0 + version: 1.167.0(react-dom@19.2.4(react@19.2.4))(react@19.2.4) '@tanstack/react-router-devtools': specifier: ^1.163.3 - version: 1.163.3(@tanstack/react-router@1.163.3(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(@tanstack/router-core@1.163.3)(csstype@3.2.3)(react-dom@19.2.4(react@19.2.4))(react@19.2.4) + version: 1.163.3(@tanstack/react-router@1.167.0(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(@tanstack/router-core@1.167.0)(csstype@3.2.3)(react-dom@19.2.4(react@19.2.4))(react@19.2.4) class-variance-authority: specifier: ^0.7.1 version: 0.7.1 @@ -92,7 +92,7 @@ importers: version: 0.5.19(tailwindcss@4.2.1) '@tanstack/router-plugin': specifier: ^1.164.0 - version: 1.164.0(@tanstack/react-router@1.163.3(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(vite@7.3.1(@types/node@24.11.0)(jiti@2.6.1)(lightningcss@1.31.1)(tsx@4.21.0)) + version: 1.164.0(@tanstack/react-router@1.167.0(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(vite@7.3.1(@types/node@24.11.0)(jiti@2.6.1)(lightningcss@1.31.1)(tsx@4.21.0)) '@trivago/prettier-plugin-sort-imports': specifier: ^6.0.2 version: 6.0.2(prettier@3.8.1) @@ -1587,15 +1587,15 @@ packages: '@tanstack/router-core': optional: true - '@tanstack/react-router@1.163.3': - resolution: {integrity: sha512-hheBbFVb+PbxtrWp8iy6+TTRTbhx3Pn6hKo8Tv/sWlG89ZMcD1xpQWzx8ukHN9K8YWbh5rdzt4kv6u8X4kB28Q==} + '@tanstack/react-router@1.167.0': + resolution: {integrity: sha512-U7CamtXjuC8ixg1c32Rj/4A2OFBnjtMLdbgbyOGHrFHE7ULWS/yhnZLVXff0QSyn6qF92Oecek9mDMHCaTnB2Q==} engines: {node: '>=20.19'} peerDependencies: react: '>=18.0.0 || >=19.0.0' react-dom: '>=18.0.0 || >=19.0.0' - '@tanstack/react-store@0.9.1': - resolution: {integrity: sha512-YzJLnRvy5lIEFTLWBAZmcOjK3+2AepnBv/sr6NZmiqJvq7zTQggyK99Gw8fqYdMdHPQWXjz0epFKJXC+9V2xDA==} + '@tanstack/react-store@0.9.2': + resolution: {integrity: sha512-Vt5usJE5sHG/cMechQfmwvwne6ktGCELe89Lmvoxe3LKRoFrhPa8OCKWs0NliG8HTJElEIj7PLtaBQIcux5pAQ==} peerDependencies: react: ^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 react-dom: ^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 @@ -1604,6 +1604,10 @@ packages: resolution: {integrity: sha512-jPptiGq/w3nuPzcMC7RNa79aU+b6OjaDzWJnBcV2UAwL4ThJamRS4h42TdhJE+oF5yH9IEnCOGQdfnbw45LbfA==} engines: {node: '>=20.19'} + '@tanstack/router-core@1.167.0': + resolution: {integrity: sha512-pnaaUP+vMQEyL2XjZGe2PXmtzulxvXfGyvEMUs+AEBaNEk77xWA88bl3ujiBRbUxzpK0rxfJf+eSKPdZmBMFdQ==} + engines: {node: '>=20.19'} + '@tanstack/router-devtools-core@1.163.3': resolution: {integrity: sha512-FPi64IP0PT1IkoeyGmsD6JoOVOYAb85VCH0mUbSdD90yV0+1UB6oT+D7K27GXkp7SXMJN3mBEjU5rKnNnmSCIw==} engines: {node: '>=20.19'} @@ -1646,6 +1650,9 @@ packages: '@tanstack/store@0.9.1': resolution: {integrity: sha512-+qcNkOy0N1qSGsP7omVCW0SDrXtaDcycPqBDE726yryiA5eTDFpjBReaYjghVJwNf1pcPMyzIwTGlYjCSQR0Fg==} + '@tanstack/store@0.9.2': + resolution: {integrity: sha512-K013lUJEFJK2ofFQ/hZKJUmCnpcV00ebLyOyFOWQvyQHUOZp/iYO84BM6aOGiV81JzwbX0APTVmW8YI7yiG5oA==} + '@tanstack/virtual-file-routes@1.161.4': resolution: {integrity: sha512-42WoRePf8v690qG8yGRe/YOh+oHni9vUaUUfoqlS91U2scd3a5rkLtVsc6b7z60w3RogH0I00vdrC5AaeiZ18w==} engines: {node: '>=20.19'} @@ -2648,8 +2655,8 @@ packages: resolution: {integrity: sha512-e6rvdUCiQCAuumZslxRJWR/Doq4VpPR82kqclvcS0efgt430SlGIk05vdCN58+VrzgtIcfNODjozVielycD4Sw==} engines: {node: '>=16'} - isbot@5.1.35: - resolution: {integrity: sha512-waFfC72ZNfwLLuJ2iLaoVaqcNo+CAaLR7xCpAn0Y5WfGzkNHv7ZN39Vbi1y+kb+Zs46XHOX3tZNExroFUPX+Kg==} + isbot@5.1.36: + resolution: {integrity: sha512-C/ZtXyJqDPZ7G7JPr06ApWyYoHjYexQbS6hPYD4WYCzpv2Qes6Z+CCEfTX4Owzf+1EJ933PoI2p+B9v7wpGZBQ==} engines: {node: '>=18'} isexe@2.0.0: @@ -3476,10 +3483,20 @@ packages: peerDependencies: seroval: ^1.0 + seroval-plugins@1.5.1: + resolution: {integrity: sha512-4FbuZ/TMl02sqv0RTFexu0SP6V+ywaIe5bAWCCEik0fk17BhALgwvUDVF7e3Uvf9pxmwCEJsRPmlkUE6HdzLAw==} + engines: {node: '>=10'} + peerDependencies: + seroval: ^1.0 + seroval@1.5.0: resolution: {integrity: sha512-OE4cvmJ1uSPrKorFIH9/w/Qwuvi/IMcGbv5RKgcJ/zjA/IohDLU6SVaxFN9FwajbP7nsX0dQqMDes1whk3y+yw==} engines: {node: '>=10'} + seroval@1.5.1: + resolution: {integrity: sha512-OwrZRZAfhHww0WEnKHDY8OM0U/Qs8OTfIDWhUD4BLpNJUfXK4cGmjiagGze086m+mhI+V2nD0gfbHEnJjb9STA==} + engines: {node: '>=10'} + serve-static@2.2.1: resolution: {integrity: sha512-xRXBn0pPqQTVQiC8wyQrKs2MOlX24zQ0POGaj0kultvoOCstBQM5yvOhAVSUwOMjQtTvsPWoNCHfPGwaaQJhTw==} engines: {node: '>= 18'} @@ -5365,31 +5382,31 @@ snapshots: '@tanstack/query-core': 5.90.20 react: 19.2.4 - '@tanstack/react-router-devtools@1.163.3(@tanstack/react-router@1.163.3(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(@tanstack/router-core@1.163.3)(csstype@3.2.3)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)': + '@tanstack/react-router-devtools@1.163.3(@tanstack/react-router@1.167.0(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(@tanstack/router-core@1.167.0)(csstype@3.2.3)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)': dependencies: - '@tanstack/react-router': 1.163.3(react-dom@19.2.4(react@19.2.4))(react@19.2.4) - '@tanstack/router-devtools-core': 1.163.3(@tanstack/router-core@1.163.3)(csstype@3.2.3) + '@tanstack/react-router': 1.167.0(react-dom@19.2.4(react@19.2.4))(react@19.2.4) + '@tanstack/router-devtools-core': 1.163.3(@tanstack/router-core@1.167.0)(csstype@3.2.3) react: 19.2.4 react-dom: 19.2.4(react@19.2.4) optionalDependencies: - '@tanstack/router-core': 1.163.3 + '@tanstack/router-core': 1.167.0 transitivePeerDependencies: - csstype - '@tanstack/react-router@1.163.3(react-dom@19.2.4(react@19.2.4))(react@19.2.4)': + '@tanstack/react-router@1.167.0(react-dom@19.2.4(react@19.2.4))(react@19.2.4)': dependencies: '@tanstack/history': 1.161.4 - '@tanstack/react-store': 0.9.1(react-dom@19.2.4(react@19.2.4))(react@19.2.4) - '@tanstack/router-core': 1.163.3 - isbot: 5.1.35 + '@tanstack/react-store': 0.9.2(react-dom@19.2.4(react@19.2.4))(react@19.2.4) + '@tanstack/router-core': 1.167.0 + isbot: 5.1.36 react: 19.2.4 react-dom: 19.2.4(react@19.2.4) tiny-invariant: 1.3.3 tiny-warning: 1.0.3 - '@tanstack/react-store@0.9.1(react-dom@19.2.4(react@19.2.4))(react@19.2.4)': + '@tanstack/react-store@0.9.2(react-dom@19.2.4(react@19.2.4))(react@19.2.4)': dependencies: - '@tanstack/store': 0.9.1 + '@tanstack/store': 0.9.2 react: 19.2.4 react-dom: 19.2.4(react@19.2.4) use-sync-external-store: 1.6.0(react@19.2.4) @@ -5404,9 +5421,19 @@ snapshots: tiny-invariant: 1.3.3 tiny-warning: 1.0.3 - '@tanstack/router-devtools-core@1.163.3(@tanstack/router-core@1.163.3)(csstype@3.2.3)': + '@tanstack/router-core@1.167.0': dependencies: - '@tanstack/router-core': 1.163.3 + '@tanstack/history': 1.161.4 + '@tanstack/store': 0.9.2 + cookie-es: 2.0.0 + seroval: 1.5.1 + seroval-plugins: 1.5.1(seroval@1.5.1) + tiny-invariant: 1.3.3 + tiny-warning: 1.0.3 + + '@tanstack/router-devtools-core@1.163.3(@tanstack/router-core@1.167.0)(csstype@3.2.3)': + dependencies: + '@tanstack/router-core': 1.167.0 clsx: 2.1.1 goober: 2.1.18(csstype@3.2.3) tiny-invariant: 1.3.3 @@ -5426,7 +5453,7 @@ snapshots: transitivePeerDependencies: - supports-color - '@tanstack/router-plugin@1.164.0(@tanstack/react-router@1.163.3(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(vite@7.3.1(@types/node@24.11.0)(jiti@2.6.1)(lightningcss@1.31.1)(tsx@4.21.0))': + '@tanstack/router-plugin@1.164.0(@tanstack/react-router@1.167.0(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(vite@7.3.1(@types/node@24.11.0)(jiti@2.6.1)(lightningcss@1.31.1)(tsx@4.21.0))': dependencies: '@babel/core': 7.29.0 '@babel/plugin-syntax-jsx': 7.28.6(@babel/core@7.29.0) @@ -5442,7 +5469,7 @@ snapshots: unplugin: 2.3.11 zod: 3.25.76 optionalDependencies: - '@tanstack/react-router': 1.163.3(react-dom@19.2.4(react@19.2.4))(react@19.2.4) + '@tanstack/react-router': 1.167.0(react-dom@19.2.4(react@19.2.4))(react@19.2.4) vite: 7.3.1(@types/node@24.11.0)(jiti@2.6.1)(lightningcss@1.31.1)(tsx@4.21.0) transitivePeerDependencies: - supports-color @@ -5463,6 +5490,8 @@ snapshots: '@tanstack/store@0.9.1': {} + '@tanstack/store@0.9.2': {} + '@tanstack/virtual-file-routes@1.161.4': {} '@trivago/prettier-plugin-sort-imports@6.0.2(prettier@3.8.1)': @@ -6489,7 +6518,7 @@ snapshots: dependencies: is-inside-container: 1.0.0 - isbot@5.1.35: {} + isbot@5.1.36: {} isexe@2.0.0: {} @@ -7517,8 +7546,14 @@ snapshots: dependencies: seroval: 1.5.0 + seroval-plugins@1.5.1(seroval@1.5.1): + dependencies: + seroval: 1.5.1 + seroval@1.5.0: {} + seroval@1.5.1: {} + serve-static@2.2.1: dependencies: encodeurl: 2.0.0 From c8065989b0f04336d94ed8aa815a5280778c7462 Mon Sep 17 00:00:00 2001 From: wenjie <meetwenjie@gmail.com> Date: Mon, 16 Mar 2026 11:58:06 +0800 Subject: [PATCH 27/56] chore(web): upgrade eslint deps to resolve flatted vulnerability (#1629) --- web/frontend/package.json | 4 ++-- web/frontend/pnpm-lock.yaml | 28 ++++++++++++++-------------- 2 files changed, 16 insertions(+), 16 deletions(-) diff --git a/web/frontend/package.json b/web/frontend/package.json index f3bae6d6a..973586519 100644 --- a/web/frontend/package.json +++ b/web/frontend/package.json @@ -40,7 +40,7 @@ "wrap-ansi": "^10.0.0" }, "devDependencies": { - "@eslint/js": "^9.39.1", + "@eslint/js": "^9.39.3", "@tailwindcss/typography": "^0.5.19", "@tanstack/router-plugin": "^1.164.0", "@trivago/prettier-plugin-sort-imports": "^6.0.2", @@ -49,7 +49,7 @@ "@types/react-dom": "^19.2.3", "@typescript-eslint/eslint-plugin": "^8.56.1", "@vitejs/plugin-react": "^5.2.0", - "eslint": "^9.39.1", + "eslint": "^9.39.3", "eslint-config-prettier": "^10.1.8", "eslint-plugin-react-hooks": "^7.0.1", "eslint-plugin-react-refresh": "^0.4.24", diff --git a/web/frontend/pnpm-lock.yaml b/web/frontend/pnpm-lock.yaml index ac2168798..20f0a7342 100644 --- a/web/frontend/pnpm-lock.yaml +++ b/web/frontend/pnpm-lock.yaml @@ -85,7 +85,7 @@ importers: version: 10.0.0 devDependencies: '@eslint/js': - specifier: ^9.39.1 + specifier: ^9.39.3 version: 9.39.3 '@tailwindcss/typography': specifier: ^0.5.19 @@ -112,7 +112,7 @@ importers: specifier: ^5.2.0 version: 5.2.0(vite@7.3.1(@types/node@24.11.0)(jiti@2.6.1)(lightningcss@1.31.1)(tsx@4.21.0)) eslint: - specifier: ^9.39.1 + specifier: ^9.39.3 version: 9.39.3(jiti@2.6.1) eslint-config-prettier: specifier: ^10.1.8 @@ -469,8 +469,8 @@ packages: resolution: {integrity: sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==} engines: {node: ^12.0.0 || ^14.0.0 || >=16.0.0} - '@eslint/config-array@0.21.1': - resolution: {integrity: sha512-aw1gNayWpdI/jSYVgzN5pL0cfzU02GT3NBpeT/DXbx1/1x7ZKxFPd9bwrzygx/qiwIQiJ1sw/zD8qY/kRvlGHA==} + '@eslint/config-array@0.21.2': + resolution: {integrity: sha512-nJl2KGTlrf9GjLimgIru+V/mzgSK0ABCDQRvxw5BjURL7WfH5uoWmizbH7QB6MmnMBd8cIC9uceWnezL1VZWWw==} engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} '@eslint/config-helpers@0.4.2': @@ -481,8 +481,8 @@ packages: resolution: {integrity: sha512-yL/sLrpmtDaFEiUj1osRP4TI2MDz1AddJL+jZ7KSqvBuliN4xqYY54IfdN8qD8Toa6g1iloph1fxQNkjOxrrpQ==} engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - '@eslint/eslintrc@3.3.4': - resolution: {integrity: sha512-4h4MVF8pmBsncB60r0wSJiIeUKTSD4m7FmTFThG8RHlsg9ajqckLm9OraguFGZE4vVdpiI1Q4+hFnisopmG6gQ==} + '@eslint/eslintrc@3.3.5': + resolution: {integrity: sha512-4IlJx0X0qftVsN5E+/vGujTRIFtwuLbNsVUe7TO6zYPDR1O6nFwvwhIKEKSrl6dZchmYBITazxKoUYOjdtjlRg==} engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} '@eslint/js@9.39.3': @@ -2362,8 +2362,8 @@ packages: resolution: {integrity: sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw==} engines: {node: '>=16'} - flatted@3.3.3: - resolution: {integrity: sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==} + flatted@3.4.1: + resolution: {integrity: sha512-IxfVbRFVlV8V/yRaGzk0UVIcsKKHMSfYw66T/u4nTwlWteQePsxe//LjudR1AMX4tZW3WFCh3Zqa/sjlqpbURQ==} formdata-polyfill@4.0.10: resolution: {integrity: sha512-buewHzMvYL29jdeQTVILecSaZKnt/RJWjoZCF5OW60Z67/GmSLBkOFM7qh1PI3zFNtJbaZL5eQu1vLfazOwj4g==} @@ -4285,7 +4285,7 @@ snapshots: '@eslint-community/regexpp@4.12.2': {} - '@eslint/config-array@0.21.1': + '@eslint/config-array@0.21.2': dependencies: '@eslint/object-schema': 2.1.7 debug: 4.4.3 @@ -4301,7 +4301,7 @@ snapshots: dependencies: '@types/json-schema': 7.0.15 - '@eslint/eslintrc@3.3.4': + '@eslint/eslintrc@3.3.5': dependencies: ajv: 6.14.0 debug: 4.4.3 @@ -6077,10 +6077,10 @@ snapshots: dependencies: '@eslint-community/eslint-utils': 4.9.1(eslint@9.39.3(jiti@2.6.1)) '@eslint-community/regexpp': 4.12.2 - '@eslint/config-array': 0.21.1 + '@eslint/config-array': 0.21.2 '@eslint/config-helpers': 0.4.2 '@eslint/core': 0.17.0 - '@eslint/eslintrc': 3.3.4 + '@eslint/eslintrc': 3.3.5 '@eslint/js': 9.39.3 '@eslint/plugin-kit': 0.4.1 '@humanfs/node': 0.16.7 @@ -6270,10 +6270,10 @@ snapshots: flat-cache@4.0.1: dependencies: - flatted: 3.3.3 + flatted: 3.4.1 keyv: 4.5.4 - flatted@3.3.3: {} + flatted@3.4.1: {} formdata-polyfill@4.0.10: dependencies: From 2f10b47f59f01a34ef989fd919d84c6212b5f0ad Mon Sep 17 00:00:00 2001 From: sky5454 <sky5454@users.noreply.github.com> Date: Mon, 16 Mar 2026 14:06:32 +0800 Subject: [PATCH 28/56] =?UTF-8?q?feat(credential):=20part1=20add=20AES-GCM?= =?UTF-8?q?=20encryption,=20SecureStore,=20and=20onboard=20ke=E2=80=A6=20(?= =?UTF-8?q?#1521)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * feat(credential): add AES-GCM encryption, SecureStore, and onboard keygen - pkg/credential: new package with AES-256-GCM enc:// credential format, HKDF-SHA256 key derivation (passphrase + optional SSH key binding), ErrPassphraseRequired / ErrDecryptionFailed sentinel errors, and PassphraseProvider hook for runtime passphrase injection - pkg/credential/store: lock-free SecureStore via atomic.Pointer[string]; passphrase never written to disk or os.Environ - pkg/credential/keygen: ed25519 SSH key generation helper used by onboard - pkg/config: replace os.Getenv(PassphraseEnvVar) with credential.PassphraseProvider() at all three call sites so that LoadConfig and SaveConfig use whatever passphrase source is active - cmd/picoclaw/onboard: prompt for passphrase with echo-off, generate picoclaw-specific SSH key, re-encrypt existing config on re-onboard - docs/credential_encryption.md: design doc for the enc:// format * fix(credential): address Copilot review comments on PR #1521 - credential.go: decouple ErrPassphraseRequired from env var name; message is now 'enc:// passphrase required' since PassphraseProvider may come from any source, not just os.Environ - credential.go: Resolver resolves symlinks via EvalSymlinks before the isWithinDir containment check, preventing symlink-based path traversal for file:// credential references - store.go: tighten comment to describe only what SecureStore guarantees (in-memory only); remove claims about how callers transport the value - store_test.go: replace the meaningless GetReturnsCopy test (Go strings are immutable, equality across two calls proves nothing) with TestSecureStore_ConcurrentSetGet that exercises atomic.Pointer under 10-goroutine concurrent Set/Get load - config_test.go: update error-message assertion to match new sentinel text - docs/credential_encryption.md: remove reference to non-existent 'picoclaw encrypt' subcommand; describe the onboard flow instead * fix(config): encryptPlaintextAPIKeys: struct-based encryption, fail-fast, remove raw []byte * fix(credential): require SSH private key for encryption/decryption, remove passphrase-only mode * lint: fix credential keygen lint, fix test keygen * onboard: make encryption opt-in via --enc flag Encryption (passphrase prompt + SSH key generation) is now only triggered when the user passes --enc to 'picoclaw onboard'. Without the flag, onboard skips the credential-encryption setup and writes a plain config + workspace templates directly. - Add --enc BoolFlag in NewOnboardCommand() - Pass encrypt bool into onboard() - Guard passphrase prompt, SSH key generation, and related env-var setup behind the encrypt branch - Adjust 'Next steps' output so the passphrase reminder only appears when --enc was used --- cmd/picoclaw/internal/onboard/command.go | 7 +- cmd/picoclaw/internal/onboard/command_test.go | 5 +- cmd/picoclaw/internal/onboard/helpers.go | 133 ++++++- docs/credential_encryption.md | 168 ++++++++ pkg/config/config.go | 72 +++- pkg/config/config_test.go | 365 +++++++++++++++++- pkg/credential/credential.go | 335 ++++++++++++++++ pkg/credential/credential_test.go | 283 ++++++++++++++ pkg/credential/keygen.go | 62 +++ pkg/credential/keygen_test.go | 115 ++++++ pkg/credential/store.go | 44 +++ pkg/credential/store_test.go | 81 ++++ 12 files changed, 1649 insertions(+), 21 deletions(-) create mode 100644 docs/credential_encryption.md create mode 100644 pkg/credential/credential.go create mode 100644 pkg/credential/credential_test.go create mode 100644 pkg/credential/keygen.go create mode 100644 pkg/credential/keygen_test.go create mode 100644 pkg/credential/store.go create mode 100644 pkg/credential/store_test.go diff --git a/cmd/picoclaw/internal/onboard/command.go b/cmd/picoclaw/internal/onboard/command.go index ec1012959..9f8b288c6 100644 --- a/cmd/picoclaw/internal/onboard/command.go +++ b/cmd/picoclaw/internal/onboard/command.go @@ -11,14 +11,19 @@ import ( var embeddedFiles embed.FS func NewOnboardCommand() *cobra.Command { + var encrypt bool + cmd := &cobra.Command{ Use: "onboard", Aliases: []string{"o"}, Short: "Initialize picoclaw configuration and workspace", Run: func(cmd *cobra.Command, args []string) { - onboard() + onboard(encrypt) }, } + cmd.Flags().BoolVar(&encrypt, "enc", false, + "Enable credential encryption (generates SSH key and prompts for passphrase)") + return cmd } diff --git a/cmd/picoclaw/internal/onboard/command_test.go b/cmd/picoclaw/internal/onboard/command_test.go index bc799a079..56936190b 100644 --- a/cmd/picoclaw/internal/onboard/command_test.go +++ b/cmd/picoclaw/internal/onboard/command_test.go @@ -24,6 +24,9 @@ func TestNewOnboardCommand(t *testing.T) { assert.Nil(t, cmd.PersistentPreRun) assert.Nil(t, cmd.PersistentPostRun) - assert.False(t, cmd.HasFlags()) + assert.True(t, cmd.HasFlags()) + encFlag := cmd.Flags().Lookup("enc") + require.NotNil(t, encFlag, "expected --enc flag to be registered") + assert.Equal(t, "false", encFlag.DefValue, "--enc should default to false") assert.False(t, cmd.HasSubCommands()) } diff --git a/cmd/picoclaw/internal/onboard/helpers.go b/cmd/picoclaw/internal/onboard/helpers.go index 4db8bdc8b..6f1d4bdd7 100644 --- a/cmd/picoclaw/internal/onboard/helpers.go +++ b/cmd/picoclaw/internal/onboard/helpers.go @@ -6,25 +6,71 @@ import ( "os" "path/filepath" + "golang.org/x/term" + "github.com/sipeed/picoclaw/cmd/picoclaw/internal" "github.com/sipeed/picoclaw/pkg/config" + "github.com/sipeed/picoclaw/pkg/credential" ) -func onboard() { +func onboard(encrypt bool) { configPath := internal.GetConfigPath() + configExists := false if _, err := os.Stat(configPath); err == nil { - fmt.Printf("Config already exists at %s\n", configPath) - fmt.Print("Overwrite? (y/n): ") - var response string - fmt.Scanln(&response) - if response != "y" { - fmt.Println("Aborted.") - return + configExists = true + if encrypt { + // Only ask for confirmation when *both* config and SSH key already exist, + // indicating a full re-onboard that would reset the config to defaults. + sshKeyPath, _ := credential.DefaultSSHKeyPath() + if _, err := os.Stat(sshKeyPath); err == nil { + // Both exist — confirm a full reset. + fmt.Printf("Config already exists at %s\n", configPath) + fmt.Print("Overwrite config with defaults? (y/n): ") + var response string + fmt.Scanln(&response) + if response != "y" { + fmt.Println("Aborted.") + return + } + configExists = false // user agreed to reset; treat as fresh + } + // Config exists but SSH key is missing — keep existing config, only add SSH key. } } - cfg := config.DefaultConfig() + var err error + if encrypt { + fmt.Println("\nSet up credential encryption") + fmt.Println("-----------------------------") + passphrase, pErr := promptPassphrase() + if pErr != nil { + fmt.Printf("Error: %v\n", pErr) + os.Exit(1) + } + // Expose the passphrase to credential.PassphraseProvider (which calls + // os.Getenv by default) so that SaveConfig can encrypt api_keys. + // This process is a one-shot CLI tool; the env var is never exposed outside + // the current process and disappears when it exits. + os.Setenv(credential.PassphraseEnvVar, passphrase) + + if err = setupSSHKey(); err != nil { + fmt.Printf("Error generating SSH key: %v\n", err) + os.Exit(1) + } + } + + var cfg *config.Config + if configExists { + // Preserve the existing config; SaveConfig will re-encrypt api_keys with the new passphrase. + cfg, err = config.LoadConfig(configPath) + if err != nil { + fmt.Printf("Error loading existing config: %v\n", err) + os.Exit(1) + } + } else { + cfg = config.DefaultConfig() + } if err := config.SaveConfig(configPath, cfg); err != nil { fmt.Printf("Error saving config: %v\n", err) os.Exit(1) @@ -33,9 +79,17 @@ func onboard() { workspace := cfg.WorkspacePath() createWorkspaceTemplates(workspace) - fmt.Printf("%s picoclaw is ready!\n", internal.Logo) + fmt.Printf("\n%s picoclaw is ready!\n", internal.Logo) fmt.Println("\nNext steps:") - fmt.Println(" 1. Add your API key to", configPath) + if encrypt { + fmt.Println(" 1. Set your encryption passphrase before starting picoclaw:") + fmt.Println(" export PICOCLAW_KEY_PASSPHRASE=<your-passphrase> # Linux/macOS") + fmt.Println(" set PICOCLAW_KEY_PASSPHRASE=<your-passphrase> # Windows cmd") + fmt.Println("") + fmt.Println(" 2. Add your API key to", configPath) + } else { + fmt.Println(" 1. Add your API key to", configPath) + } fmt.Println("") fmt.Println(" Recommended:") fmt.Println(" - OpenRouter: https://openrouter.ai/keys (access 100+ models)") @@ -43,7 +97,62 @@ func onboard() { fmt.Println("") fmt.Println(" See README.md for 17+ supported providers.") fmt.Println("") - fmt.Println(" 2. Chat: picoclaw agent -m \"Hello!\"") + fmt.Println(" 3. Chat: picoclaw agent -m \"Hello!\"") +} + +// promptPassphrase reads the encryption passphrase twice from the terminal +// (with echo disabled) and returns it. Returns an error if the passphrase is +// empty or if the two inputs do not match. +func promptPassphrase() (string, error) { + fmt.Print("Enter passphrase for credential encryption: ") + p1, err := term.ReadPassword(int(os.Stdin.Fd())) + fmt.Println() + if err != nil { + return "", fmt.Errorf("reading passphrase: %w", err) + } + if len(p1) == 0 { + return "", fmt.Errorf("passphrase must not be empty") + } + + fmt.Print("Confirm passphrase: ") + p2, err := term.ReadPassword(int(os.Stdin.Fd())) + fmt.Println() + if err != nil { + return "", fmt.Errorf("reading passphrase confirmation: %w", err) + } + + if string(p1) != string(p2) { + return "", fmt.Errorf("passphrases do not match") + } + return string(p1), nil +} + +// setupSSHKey generates the picoclaw-specific SSH key at ~/.ssh/picoclaw_ed25519.key. +// If the key already exists the user is warned and asked to confirm overwrite. +// Answering anything other than "y" keeps the existing key (not an error). +func setupSSHKey() error { + keyPath, err := credential.DefaultSSHKeyPath() + if err != nil { + return fmt.Errorf("cannot determine SSH key path: %w", err) + } + + if _, err := os.Stat(keyPath); err == nil { + fmt.Printf("\n⚠️ WARNING: %s already exists.\n", keyPath) + fmt.Println(" Overwriting will invalidate any credentials previously encrypted with this key.") + fmt.Print(" Overwrite? (y/n): ") + var response string + fmt.Scanln(&response) + if response != "y" { + fmt.Println("Keeping existing SSH key.") + return nil + } + } + + if err := credential.GenerateSSHKey(keyPath); err != nil { + return err + } + fmt.Printf("SSH key generated: %s\n", keyPath) + return nil } func createWorkspaceTemplates(workspace string) { diff --git a/docs/credential_encryption.md b/docs/credential_encryption.md new file mode 100644 index 000000000..448eaaa10 --- /dev/null +++ b/docs/credential_encryption.md @@ -0,0 +1,168 @@ +# Credential Encryption + +PicoClaw supports encrypting `api_key` values in `model_list` configuration entries. +Encrypted keys are stored as `enc://<base64>` strings and decrypted automatically at startup. + +--- + +## Quick Start + +**1. Set your passphrase** + +```bash +export PICOCLAW_KEY_PASSPHRASE="your-passphrase" +``` + +**2. Encrypt an API key** + +Run `picoclaw onboard` — it prompts for your passphrase and generates the SSH key, +then automatically re-encrypts any plaintext `api_key` entries in your config on +the next `SaveConfig` call. The resulting `enc://` value will look like: + +``` +enc://AAAA...base64... +``` + +**3. Paste the output into your config** + +```json +{ + "model_list": [ + { + "model_name": "gpt-4o", + "api_key": "enc://AAAA...base64...", + "base_url": "https://api.openai.com/v1" + } + ] +} +``` + +--- + +## Supported `api_key` Formats + +| Format | Example | Behaviour | +|--------|---------|-----------| +| Plaintext | `sk-abc123` | Used as-is | +| File reference | `file://openai.key` | Content read from the same directory as the config file | +| Encrypted | `enc://<base64>` | Decrypted at startup using `PICOCLAW_KEY_PASSPHRASE` | +| Empty | `""` | Passed through unchanged (used with `auth_method: oauth`) | + +--- + +## Cryptographic Design + +### Key Derivation + +Encryption uses **HKDF-SHA256** with an optional SSH private key as a second factor. + +``` +Without SSH key (passphrase only): + + ikm = SHA256(passphrase) + aes_key = HKDF-SHA256(ikm, salt, info="picoclaw-credential-v1", 32 bytes) + + +With SSH key (recommended): + + sshHash = SHA256(ssh_private_key_file_bytes) + ikm = HMAC-SHA256(key=sshHash, message=passphrase) + aes_key = HKDF-SHA256(ikm, salt, info="picoclaw-credential-v1", 32 bytes) +``` + +### Encryption + +``` +AES-256-GCM(key=aes_key, nonce=random[12], plaintext=api_key) +``` + +### Wire Format + +``` +enc://<base64( salt[16] + nonce[12] + ciphertext )> +``` + +| Field | Size | Description | +|-------|------|-------------| +| `salt` | 16 bytes | Random per encryption; fed into HKDF | +| `nonce` | 12 bytes | Random per encryption; AES-GCM IV | +| `ciphertext` | variable | AES-256-GCM ciphertext + 16-byte authentication tag | + +The GCM authentication tag is appended to the ciphertext automatically. Any tampering causes decryption to fail with an error rather than returning corrupt plaintext. + +### Performance + +| Operation | Time (ARM Cortex-A) | +|-----------|---------------------| +| Key derivation (HKDF) | < 1 ms | +| AES-256-GCM decrypt | < 1 ms | +| **Total startup overhead** | **< 2 ms per key** | + +--- + +## Two-Factor Security with SSH Key + +When a SSH private key is provided, breaking the encryption requires **both**: + +1. The **passphrase** (`PICOCLAW_KEY_PASSPHRASE`) +2. The **SSH private key file** + +This means a leaked config file alone is not sufficient to recover the API key, even if the passphrase is weak. The SSH key contributes 256 bits of entropy (Ed25519) regardless of passphrase strength. + +### Threat Model + +| Attacker Has | Can Decrypt? | +|---|---| +| Config file only | No — needs passphrase + SSH key | +| SSH key only | No — needs passphrase | +| Passphrase only | No — needs SSH key | +| Config file + SSH key + passphrase | Yes — full compromise | + +--- + +## Environment Variables + +| Variable | Required | Description | +|----------|----------|-------------| +| `PICOCLAW_KEY_PASSPHRASE` | Yes (for `enc://`) | Passphrase used for key derivation | +| `PICOCLAW_SSH_KEY_PATH` | No | Path to SSH private key. Set to `""` to disable auto-detection and use passphrase-only mode | + +### SSH Key Auto-Detection + +If `PICOCLAW_SSH_KEY_PATH` is not set, PicoClaw looks for the picoclaw-specific key: + +``` +~/.ssh/picoclaw_ed25519.key +``` + +This dedicated file avoids conflicts with the user's existing SSH keys. +Run `picoclaw onboard` to generate it automatically. + +`os.UserHomeDir()` is used for cross-platform home directory resolution (reads `USERPROFILE` on Windows, `HOME` on Unix/macOS). + +To explicitly disable SSH key usage and use passphrase-only mode: + +```bash +export PICOCLAW_SSH_KEY_PATH="" +``` + +--- + +## Migration + +Because the only secret material is `PICOCLAW_KEY_PASSPHRASE` and the SSH private key file, migration is straightforward: + +1. Copy the config file to the new machine. +2. Set `PICOCLAW_KEY_PASSPHRASE` to the same value. +3. Copy the SSH private key file to the same path (or set `PICOCLAW_SSH_KEY_PATH` to its new location). + +No re-encryption is needed. + +--- + +## Security Considerations + +- **Passphrase strength matters in passphrase-only mode.** Without an SSH key, a weak passphrase can be brute-forced offline. Use `PICOCLAW_SSH_KEY_PATH=""` only in environments where no SSH key is available and the passphrase is sufficiently strong (≥ 32 random characters). +- **The SSH key is read-only at runtime.** PicoClaw never writes to or modifies the SSH key file. +- **Plaintext keys remain supported.** Existing configs without `enc://` are unaffected. +- **The `enc://` format is versioned** via the HKDF `info` field (`picoclaw-credential-v1`), allowing future algorithm upgrades without breaking existing encrypted values. diff --git a/pkg/config/config.go b/pkg/config/config.go index 190341224..2937c36e4 100644 --- a/pkg/config/config.go +++ b/pkg/config/config.go @@ -4,11 +4,13 @@ import ( "encoding/json" "fmt" "os" + "path/filepath" "strings" "sync/atomic" "github.com/caarlos0/env/v11" + "github.com/sipeed/picoclaw/pkg/credential" "github.com/sipeed/picoclaw/pkg/fileutil" ) @@ -837,10 +839,24 @@ func LoadConfig(path string) (*Config, error) { return nil, err } + if passphrase := credential.PassphraseProvider(); passphrase != "" { + for _, m := range cfg.ModelList { + if m.APIKey != "" && !strings.HasPrefix(m.APIKey, "enc://") && !strings.HasPrefix(m.APIKey, "file://") { + fmt.Fprintf(os.Stderr, + "picoclaw: warning: model %q has a plaintext api_key; call SaveConfig to encrypt it\n", + m.ModelName) + } + } + } + if err := env.Parse(cfg); err != nil { return nil, err } + if err := resolveAPIKeys(cfg.ModelList, filepath.Dir(path)); err != nil { + return nil, err + } + // Migrate legacy channel config fields to new unified structures cfg.migrateChannelConfigs() @@ -857,6 +873,48 @@ func LoadConfig(path string) (*Config, error) { return cfg, nil } +// encryptPlaintextAPIKeys returns a copy of models with plaintext api_key values +// encrypted. Returns (nil, nil) when nothing changed (all keys already sealed or +// empty). Returns (nil, error) if any key fails to encrypt — callers must treat +// this as a hard failure to prevent a mixed plaintext/ciphertext state on disk. +// Symmetric counterpart of resolveAPIKeys: both operate purely on []ModelConfig +// and leave JSON marshaling to the caller. +func encryptPlaintextAPIKeys(models []ModelConfig, passphrase string) ([]ModelConfig, error) { + sealed := make([]ModelConfig, len(models)) + copy(sealed, models) + changed := false + for i := range sealed { + m := &sealed[i] + if m.APIKey == "" || strings.HasPrefix(m.APIKey, "enc://") || strings.HasPrefix(m.APIKey, "file://") { + continue + } + encrypted, err := credential.Encrypt(passphrase, "", m.APIKey) + if err != nil { + return nil, fmt.Errorf("cannot seal api_key for model %q: %w", m.ModelName, err) + } + m.APIKey = encrypted + changed = true + } + if !changed { + return nil, nil + } + return sealed, nil +} + +// resolveAPIKeys decrypts or dereferences each api_key in models in-place. +// Supports plaintext (no-op), file:// (read from configDir), and enc:// (AES-GCM decrypt). +func resolveAPIKeys(models []ModelConfig, configDir string) error { + cr := credential.NewResolver(configDir) + for i := range models { + resolved, err := cr.Resolve(models[i].APIKey) + if err != nil { + return fmt.Errorf("model_list[%d] (%s): %w", i, models[i].ModelName, err) + } + models[i].APIKey = resolved + } + return nil +} + func (c *Config) migrateChannelConfigs() { // Discord: mention_only -> group_trigger.mention_only if c.Channels.Discord.MentionOnly && !c.Channels.Discord.GroupTrigger.MentionOnly { @@ -871,12 +929,22 @@ func (c *Config) migrateChannelConfigs() { } func SaveConfig(path string, cfg *Config) error { + if passphrase := credential.PassphraseProvider(); passphrase != "" { + sealed, err := encryptPlaintextAPIKeys(cfg.ModelList, passphrase) + if err != nil { + return err + } + if sealed != nil { + tmp := *cfg + tmp.ModelList = sealed + cfg = &tmp + } + } + data, err := json.MarshalIndent(cfg, "", " ") if err != nil { return err } - - // Use unified atomic write utility with explicit sync for flash storage reliability. return fileutil.WriteFileAtomic(path, data, 0o600) } diff --git a/pkg/config/config_test.go b/pkg/config/config_test.go index c5bdbf3c3..4c4dd9421 100644 --- a/pkg/config/config_test.go +++ b/pkg/config/config_test.go @@ -7,8 +7,22 @@ import ( "runtime" "strings" "testing" + + "github.com/sipeed/picoclaw/pkg/credential" ) +// mustSetupSSHKey generates a temporary Ed25519 SSH key in t.TempDir() and sets +// PICOCLAW_SSH_KEY_PATH to its path for the duration of the test. This is required +// whenever a test exercises encryption/decryption via credential.Encrypt or SaveConfig. +func mustSetupSSHKey(t *testing.T) { + t.Helper() + keyPath := filepath.Join(t.TempDir(), "picoclaw_ed25519.key") + if err := credential.GenerateSSHKey(keyPath); err != nil { + t.Fatalf("mustSetupSSHKey: %v", err) + } + t.Setenv("PICOCLAW_SSH_KEY_PATH", keyPath) +} + func TestAgentModelConfig_UnmarshalString(t *testing.T) { var m AgentModelConfig if err := json.Unmarshal([]byte(`"gpt-4"`), &m); err != nil { @@ -482,13 +496,19 @@ func TestDefaultConfig_DMScope(t *testing.T) { } func TestDefaultConfig_WorkspacePath_Default(t *testing.T) { - // Unset to ensure we test the default t.Setenv("PICOCLAW_HOME", "") - // Set a known home for consistent test results - t.Setenv("HOME", "/tmp/home") + + var fakeHome string + if runtime.GOOS == "windows" { + fakeHome = `C:\tmp\home` + t.Setenv("USERPROFILE", fakeHome) + } else { + fakeHome = "/tmp/home" + t.Setenv("HOME", fakeHome) + } cfg := DefaultConfig() - want := filepath.Join("/tmp/home", ".picoclaw", "workspace") + want := filepath.Join(fakeHome, ".picoclaw", "workspace") if cfg.Agents.Defaults.Workspace != want { t.Errorf("Default workspace path = %q, want %q", cfg.Agents.Defaults.Workspace, want) @@ -499,7 +519,7 @@ func TestDefaultConfig_WorkspacePath_WithPicoclawHome(t *testing.T) { t.Setenv("PICOCLAW_HOME", "/custom/picoclaw/home") cfg := DefaultConfig() - want := "/custom/picoclaw/home/workspace" + want := filepath.Join("/custom/picoclaw/home", "workspace") if cfg.Agents.Defaults.Workspace != want { t.Errorf("Workspace path with PICOCLAW_HOME = %q, want %q", cfg.Agents.Defaults.Workspace, want) @@ -621,3 +641,338 @@ func TestFlexibleStringSlice_UnmarshalText_EmptySliceConsistency(t *testing.T) { } }) } + +// TestLoadConfig_WarnsForPlaintextAPIKey verifies that LoadConfig resolves a plaintext +// api_key into memory but does NOT rewrite the config file. File writes are the sole +// responsibility of SaveConfig. +func TestLoadConfig_WarnsForPlaintextAPIKey(t *testing.T) { + dir := t.TempDir() + cfgPath := filepath.Join(dir, "config.json") + const original = `{"model_list":[{"model_name":"test","model":"openai/gpt-4","api_key":"sk-plaintext"}]}` + if err := os.WriteFile(cfgPath, []byte(original), 0o600); err != nil { + t.Fatalf("setup: %v", err) + } + + t.Setenv("PICOCLAW_KEY_PASSPHRASE", "test-passphrase") + t.Setenv("PICOCLAW_SSH_KEY_PATH", "") + + cfg, err := LoadConfig(cfgPath) + if err != nil { + t.Fatalf("LoadConfig: %v", err) + } + // In-memory value must be the resolved plaintext. + if cfg.ModelList[0].APIKey != "sk-plaintext" { + t.Errorf("in-memory api_key = %q, want %q", cfg.ModelList[0].APIKey, "sk-plaintext") + } + // The file on disk must remain unchanged — LoadConfig must not write anything. + raw, _ := os.ReadFile(cfgPath) + if string(raw) != original { + t.Errorf("LoadConfig must not modify the config file; got:\n%s", string(raw)) + } +} + +// TestSaveConfig_EncryptsPlaintextAPIKey verifies that SaveConfig writes enc:// ciphertext +// to disk and that a subsequent LoadConfig decrypts it back to the original plaintext. +func TestSaveConfig_EncryptsPlaintextAPIKey(t *testing.T) { + dir := t.TempDir() + cfgPath := filepath.Join(dir, "config.json") + + t.Setenv("PICOCLAW_KEY_PASSPHRASE", "test-passphrase") + mustSetupSSHKey(t) + + cfg := DefaultConfig() + cfg.ModelList = []ModelConfig{ + {ModelName: "test", Model: "openai/gpt-4", APIKey: "sk-plaintext"}, + } + if err := SaveConfig(cfgPath, cfg); err != nil { + t.Fatalf("SaveConfig: %v", err) + } + + // Disk must contain enc://, not the raw key. + raw, _ := os.ReadFile(cfgPath) + if !strings.Contains(string(raw), "enc://") { + t.Errorf("saved file should contain enc://, got:\n%s", string(raw)) + } + if strings.Contains(string(raw), "sk-plaintext") { + t.Errorf("saved file must not contain the plaintext key") + } + + // A fresh load must decrypt back to the original plaintext. + cfg2, err := LoadConfig(cfgPath) + if err != nil { + t.Fatalf("LoadConfig after SaveConfig: %v", err) + } + if cfg2.ModelList[0].APIKey != "sk-plaintext" { + t.Errorf("loaded api_key = %q, want %q", cfg2.ModelList[0].APIKey, "sk-plaintext") + } +} + +// TestLoadConfig_NoSealWithoutPassphrase verifies that api_key values are left +// unchanged when PICOCLAW_KEY_PASSPHRASE is not set. +func TestLoadConfig_NoSealWithoutPassphrase(t *testing.T) { + dir := t.TempDir() + cfgPath := filepath.Join(dir, "config.json") + data := `{"model_list":[{"model_name":"test","model":"openai/gpt-4","api_key":"sk-plaintext"}]}` + if err := os.WriteFile(cfgPath, []byte(data), 0o600); err != nil { + t.Fatalf("setup: %v", err) + } + + t.Setenv("PICOCLAW_KEY_PASSPHRASE", "") + t.Setenv("PICOCLAW_SSH_KEY_PATH", "") + + if _, err := LoadConfig(cfgPath); err != nil { + t.Fatalf("LoadConfig: %v", err) + } + + raw, _ := os.ReadFile(cfgPath) + if strings.Contains(string(raw), "enc://") { + t.Error("config file must not be modified when no passphrase is set") + } +} + +// TestLoadConfig_FileRefNotSealed verifies that file:// api_key references are not +// converted to enc:// values (they are resolved at runtime by the Resolver). +func TestLoadConfig_FileRefNotSealed(t *testing.T) { + dir := t.TempDir() + cfgPath := filepath.Join(dir, "config.json") + keyFile := filepath.Join(dir, "openai.key") + if err := os.WriteFile(keyFile, []byte("sk-from-file"), 0o600); err != nil { + t.Fatalf("setup: %v", err) + } + data := `{"model_list":[{"model_name":"test","model":"openai/gpt-4","api_key":"file://openai.key"}]}` + if err := os.WriteFile(cfgPath, []byte(data), 0o600); err != nil { + t.Fatalf("setup: %v", err) + } + + t.Setenv("PICOCLAW_KEY_PASSPHRASE", "test-passphrase") + t.Setenv("PICOCLAW_SSH_KEY_PATH", "") + + if _, err := LoadConfig(cfgPath); err != nil { + t.Fatalf("LoadConfig: %v", err) + } + + raw, _ := os.ReadFile(cfgPath) + if !strings.Contains(string(raw), "file://openai.key") { + t.Error("file:// reference should be preserved unchanged in the config file") + } + if strings.Contains(string(raw), "enc://") { + t.Error("file:// reference must not be converted to enc://") + } +} + +// TestSaveConfig_MixedKeys verifies that SaveConfig encrypts only plaintext api_keys +// and leaves already-encrypted (enc://) and file:// entries unchanged. +func TestSaveConfig_MixedKeys(t *testing.T) { + dir := t.TempDir() + cfgPath := filepath.Join(dir, "config.json") + + t.Setenv("PICOCLAW_KEY_PASSPHRASE", "test-passphrase") + mustSetupSSHKey(t) + + // Pre-encrypt one key so we have a genuine enc:// value to put in the config. + if err := SaveConfig(cfgPath, &Config{ + ModelList: []ModelConfig{ + {ModelName: "pre", Model: "openai/gpt-4", APIKey: "sk-already-plain"}, + }, + }); err != nil { + t.Fatalf("setup SaveConfig: %v", err) + } + raw, _ := os.ReadFile(cfgPath) + // Extract the enc:// value from the saved file. + var tmp struct { + ModelList []struct { + APIKey string `json:"api_key"` + } `json:"model_list"` + } + if err := json.Unmarshal(raw, &tmp); err != nil || len(tmp.ModelList) == 0 { + t.Fatalf("setup: could not parse saved config: %v", err) + } + alreadyEncrypted := tmp.ModelList[0].APIKey + if !strings.HasPrefix(alreadyEncrypted, "enc://") { + t.Fatalf("setup: expected enc:// key, got %q", alreadyEncrypted) + } + + // Build a config with three models: + // 1. plaintext → must be encrypted by SaveConfig + // 2. enc:// → must be left unchanged (already encrypted) + // 3. file:// → must be left unchanged (file reference) + keyFile := filepath.Join(dir, "api.key") + if err := os.WriteFile(keyFile, []byte("sk-from-file"), 0o600); err != nil { + t.Fatalf("setup: %v", err) + } + cfg := &Config{ + ModelList: []ModelConfig{ + {ModelName: "plain", Model: "openai/gpt-4", APIKey: "sk-new-plaintext"}, + {ModelName: "enc", Model: "openai/gpt-4", APIKey: alreadyEncrypted}, + {ModelName: "file", Model: "openai/gpt-4", APIKey: "file://api.key"}, + }, + } + if err := SaveConfig(cfgPath, cfg); err != nil { + t.Fatalf("SaveConfig: %v", err) + } + + raw, _ = os.ReadFile(cfgPath) + s := string(raw) + + // 1. Plaintext must be encrypted. + if strings.Contains(s, "sk-new-plaintext") { + t.Error("plaintext key must not appear in saved file") + } + // 2. The pre-existing enc:// value must still be present (byte-for-byte unchanged). + if !strings.Contains(s, alreadyEncrypted) { + t.Error("pre-existing enc:// entry must be preserved unchanged") + } + // 3. file:// must be preserved. + if !strings.Contains(s, "file://api.key") { + t.Error("file:// reference must be preserved unchanged") + } + + // Now load and verify all three decrypt/resolve correctly. + cfg2, err := LoadConfig(cfgPath) + if err != nil { + t.Fatalf("LoadConfig after SaveConfig: %v", err) + } + byName := make(map[string]string) + for _, m := range cfg2.ModelList { + byName[m.ModelName] = m.APIKey + } + if byName["plain"] != "sk-new-plaintext" { + t.Errorf("plain model api_key = %q, want %q", byName["plain"], "sk-new-plaintext") + } + if byName["enc"] != "sk-already-plain" { + t.Errorf("enc model api_key = %q, want %q", byName["enc"], "sk-already-plain") + } + if byName["file"] != "sk-from-file" { + t.Errorf("file model api_key = %q, want %q", byName["file"], "sk-from-file") + } +} + +// TestLoadConfig_MixedKeys_NoPassphrase verifies that when PICOCLAW_KEY_PASSPHRASE +// is not set, enc:// entries cause LoadConfig to return an error, while plaintext +// and file:// entries in the same config are not affected. +func TestLoadConfig_MixedKeys_NoPassphrase(t *testing.T) { + dir := t.TempDir() + cfgPath := filepath.Join(dir, "config.json") + + // First encrypt a key so we have a real enc:// value. + t.Setenv("PICOCLAW_KEY_PASSPHRASE", "test-passphrase") + mustSetupSSHKey(t) + if err := SaveConfig(cfgPath, &Config{ + ModelList: []ModelConfig{ + {ModelName: "m", Model: "openai/gpt-4", APIKey: "sk-secret"}, + }, + }); err != nil { + t.Fatalf("setup SaveConfig: %v", err) + } + raw, _ := os.ReadFile(cfgPath) + var tmp struct { + ModelList []struct { + APIKey string `json:"api_key"` + } `json:"model_list"` + } + if err := json.Unmarshal(raw, &tmp); err != nil { + t.Fatalf("setup parse: %v", err) + } + encValue := tmp.ModelList[0].APIKey + + // Write a mixed config: enc:// + plaintext + file:// + keyFile := filepath.Join(dir, "api.key") + if err := os.WriteFile(keyFile, []byte("sk-from-file"), 0o600); err != nil { + t.Fatalf("setup: %v", err) + } + mixed, _ := json.Marshal(map[string]any{ + "model_list": []map[string]any{ + {"model_name": "enc", "model": "openai/gpt-4", "api_key": encValue}, + {"model_name": "plain", "model": "openai/gpt-4", "api_key": "sk-plain"}, + {"model_name": "file", "model": "openai/gpt-4", "api_key": "file://api.key"}, + }, + }) + if err := os.WriteFile(cfgPath, mixed, 0o600); err != nil { + t.Fatalf("setup write: %v", err) + } + + // Now clear the passphrase — LoadConfig must fail because enc:// cannot be decrypted. + t.Setenv("PICOCLAW_KEY_PASSPHRASE", "") + + _, err := LoadConfig(cfgPath) + if err == nil { + t.Fatal("LoadConfig should fail when enc:// key is present and no passphrase is set") + } + if !strings.Contains(err.Error(), "passphrase required") { + t.Errorf("error should mention passphrase required, got: %v", err) + } +} + +// TestSaveConfig_UsesPassphraseProvider verifies that SaveConfig encrypts plaintext +// api_keys using credential.PassphraseProvider() rather than os.Getenv directly. +// This matters for the launcher, which clears the environment variable and redirects +// PassphraseProvider to an in-memory SecureStore. +func TestSaveConfig_UsesPassphraseProvider(t *testing.T) { + dir := t.TempDir() + cfgPath := filepath.Join(dir, "config.json") + + // Ensure the env var is empty — passphrase must come from PassphraseProvider only. + t.Setenv("PICOCLAW_KEY_PASSPHRASE", "") + mustSetupSSHKey(t) + + // Replace PassphraseProvider with an in-memory function (simulating SecureStore). + const testPassphrase = "provider-passphrase" + orig := credential.PassphraseProvider + credential.PassphraseProvider = func() string { return testPassphrase } + t.Cleanup(func() { credential.PassphraseProvider = orig }) + + cfg := DefaultConfig() + cfg.ModelList = []ModelConfig{ + {ModelName: "test", Model: "openai/gpt-4", APIKey: "sk-plaintext"}, + } + if err := SaveConfig(cfgPath, cfg); err != nil { + t.Fatalf("SaveConfig: %v", err) + } + + raw, _ := os.ReadFile(cfgPath) + if !strings.Contains(string(raw), "enc://") { + t.Errorf("SaveConfig should have encrypted plaintext key via PassphraseProvider; got:\n%s", raw) + } +} + +// TestLoadConfig_UsesPassphraseProvider verifies that LoadConfig decrypts enc:// keys +// using credential.PassphraseProvider() rather than os.Getenv directly. +func TestLoadConfig_UsesPassphraseProvider(t *testing.T) { + dir := t.TempDir() + cfgPath := filepath.Join(dir, "config.json") + + // Ensure the env var is empty throughout. + t.Setenv("PICOCLAW_KEY_PASSPHRASE", "") + mustSetupSSHKey(t) + + const testPassphrase = "provider-passphrase" + const plainKey = "sk-secret" + + // First, encrypt the key using the same passphrase. + encrypted, err := credential.Encrypt(testPassphrase, "", plainKey) + if err != nil { + t.Fatalf("Encrypt: %v", err) + } + + raw, _ := json.Marshal(map[string]any{ + "model_list": []map[string]any{ + {"model_name": "test", "model": "openai/gpt-4", "api_key": encrypted}, + }, + }) + if err = os.WriteFile(cfgPath, raw, 0o600); err != nil { + t.Fatalf("setup: %v", err) + } + + // Redirect PassphraseProvider — env var is empty, so without this the load would fail. + orig := credential.PassphraseProvider + credential.PassphraseProvider = func() string { return testPassphrase } + t.Cleanup(func() { credential.PassphraseProvider = orig }) + + cfg, err := LoadConfig(cfgPath) + if err != nil { + t.Fatalf("LoadConfig: %v", err) + } + if cfg.ModelList[0].APIKey != plainKey { + t.Errorf("api_key = %q, want %q", cfg.ModelList[0].APIKey, plainKey) + } +} diff --git a/pkg/credential/credential.go b/pkg/credential/credential.go new file mode 100644 index 000000000..83af3fc9f --- /dev/null +++ b/pkg/credential/credential.go @@ -0,0 +1,335 @@ +// Package credential resolves API credential values for model_list entries. +// +// An API key is a form of authorization credential. This package centralizes +// how raw credential strings—plaintext or file references—are resolved into +// their actual values, keeping that logic out of the config loader. +// +// Supported formats for the api_key field: +// +// - Plaintext: "sk-abc123" → returned as-is +// - File ref: "file://filename.key" → content read from configDir/filename.key +// - Encrypted: "enc://<base64>" → AES-256-GCM decrypt via PICOCLAW_KEY_PASSPHRASE +// - Empty: "" → returned as-is (auth_method=oauth etc.) +// +// Encryption uses AES-256-GCM with HKDF-SHA256 key derivation (< 1ms, safe for embedded Linux). +// An SSH private key is required for both encryption and decryption. +// Key derivation: +// +// HKDF-SHA256(ikm=HMAC-SHA256(SHA256(sshKeyBytes), passphrase), salt, info) +// +// SSH key path resolution priority: +// +// 1. sshKeyPath argument to Encrypt (explicit) +// 2. PICOCLAW_SSH_KEY_PATH env var +// 3. ~/.ssh/picoclaw_ed25519.key (os.UserHomeDir is cross-platform) +package credential + +import ( + "crypto/aes" + "crypto/cipher" + "crypto/hkdf" + "crypto/hmac" + "crypto/rand" + "crypto/sha256" + "encoding/base64" + "errors" + "fmt" + "io" + "os" + "path/filepath" + "strings" +) + +// PassphraseEnvVar is the environment variable that holds the encryption passphrase. +// Other packages (e.g. config) reference this constant to avoid duplicating the string. +const PassphraseEnvVar = "PICOCLAW_KEY_PASSPHRASE" + +// PassphraseProvider is the function used to retrieve the passphrase for enc:// +// credential decryption. It defaults to reading PICOCLAW_KEY_PASSPHRASE from the +// process environment. Replace it at startup to use a different source, such as +// an in-memory SecureStore, so that all LoadConfig() calls everywhere share the +// same passphrase source without needing os.Environ. +// +// Example (launcher main.go): +// +// credential.PassphraseProvider = apiHandler.passphraseStore.Get +var PassphraseProvider func() string = func() string { + return os.Getenv(PassphraseEnvVar) +} + +// ErrPassphraseRequired is returned when an enc:// credential is encountered but +// no passphrase is available from PassphraseProvider. Callers can detect this +// with errors.Is to distinguish a missing-passphrase condition from other errors. +var ErrPassphraseRequired = errors.New("credential: enc:// passphrase required") + +// ErrDecryptionFailed is returned when an enc:// credential cannot be decrypted, +// indicating a wrong passphrase or SSH key. Callers can detect this with errors.Is. +var ErrDecryptionFailed = errors.New("credential: enc:// decryption failed (wrong passphrase or SSH key?)") + +const ( + fileScheme = "file://" + encScheme = "enc://" + hkdfInfo = "picoclaw-credential-v1" + saltLen = 16 + nonceLen = 12 + keyLen = 32 + sshKeyEnv = "PICOCLAW_SSH_KEY_PATH" +) + +// Resolver resolves raw credential strings for model_list api_key fields. +// File references are resolved relative to the directory of the config file. +type Resolver struct { + configDir string + resolvedConfigDir string // symlink-resolved form of configDir +} + +// NewResolver returns a Resolver that resolves file:// references relative to +// configDir (typically filepath.Dir of the config file path). +func NewResolver(configDir string) *Resolver { + resolved := configDir + if configDir != "" { + if linkedPath, err := filepath.EvalSymlinks(configDir); err == nil { + resolved = linkedPath + } + } + return &Resolver{configDir: configDir, resolvedConfigDir: resolved} +} + +// Resolve returns the actual credential value for raw: +// +// - "" → "" (no error; auth_method=oauth needs no key) +// - "file://name.key" → trimmed content of configDir/name.key +// - anything else → raw unchanged (plaintext credential) +func (r *Resolver) Resolve(raw string) (string, error) { + if raw == "" { + return "", nil + } + + if strings.HasPrefix(raw, fileScheme) { + fileName := strings.TrimSpace(strings.TrimPrefix(raw, fileScheme)) + if fileName == "" { + return "", fmt.Errorf("credential: file:// reference has no filename") + } + + baseDir := r.resolvedConfigDir + if baseDir == "" { + baseDir = r.configDir + } + keyPath := filepath.Join(baseDir, fileName) + // Resolve symlinks before enforcing containment to prevent escaping via symlinks. + realKeyPath, err := filepath.EvalSymlinks(keyPath) + if err != nil { + return "", fmt.Errorf("credential: failed to resolve credential file path %q: %w", keyPath, err) + } + if !isWithinDir(realKeyPath, baseDir) { + return "", fmt.Errorf("credential: file:// path escapes config directory") + } + data, err := os.ReadFile(realKeyPath) + if err != nil { + return "", fmt.Errorf("credential: failed to read credential file %q: %w", realKeyPath, err) + } + + value := strings.TrimSpace(string(data)) + if value == "" { + return "", fmt.Errorf("credential: credential file %q is empty", realKeyPath) + } + + return value, nil + } + + if strings.HasPrefix(raw, encScheme) { + return resolveEncrypted(raw) + } + + // Plaintext credential — return unchanged. + return raw, nil +} + +// resolveEncrypted decrypts an enc:// credential using PassphraseProvider. +func resolveEncrypted(raw string) (string, error) { + passphrase := PassphraseProvider() + if passphrase == "" { + return "", ErrPassphraseRequired + } + + sshKeyPath := pickSSHKeyPath("") // override="": consult env then auto-detect + + b64 := strings.TrimPrefix(raw, encScheme) + blob, err := base64.StdEncoding.DecodeString(b64) + if err != nil { + return "", fmt.Errorf("credential: enc:// invalid base64: %w", err) + } + if len(blob) < saltLen+nonceLen+1 { + return "", fmt.Errorf("credential: enc:// payload too short") + } + + salt := blob[:saltLen] + nonce := blob[saltLen : saltLen+nonceLen] + ciphertext := blob[saltLen+nonceLen:] + + key, err := deriveKey(passphrase, sshKeyPath, salt) + if err != nil { + return "", err + } + block, err := aes.NewCipher(key) + if err != nil { + return "", fmt.Errorf("credential: enc:// cipher init: %w", err) + } + gcm, err := cipher.NewGCM(block) + if err != nil { + return "", fmt.Errorf("credential: enc:// gcm init: %w", err) + } + + plaintext, err := gcm.Open(nil, nonce, ciphertext, nil) + if err != nil { + return "", fmt.Errorf("%w: %w", ErrDecryptionFailed, err) + } + return string(plaintext), nil +} + +// Encrypt encrypts plaintext and returns an enc:// credential string. +// +// passphrase is required (PICOCLAW_KEY_PASSPHRASE value). +// sshKeyPath is the SSH private key file to use; pass "" to auto-detect via +// PICOCLAW_SSH_KEY_PATH env var or ~/.ssh/picoclaw_ed25519.key. +// An SSH private key must be resolvable or Encrypt returns an error. +func Encrypt(passphrase, sshKeyPath, plaintext string) (string, error) { + if passphrase == "" { + return "", fmt.Errorf("credential: passphrase must not be empty") + } + sshKeyPath = pickSSHKeyPath(sshKeyPath) + + salt := make([]byte, saltLen) + if _, err := io.ReadFull(rand.Reader, salt); err != nil { + return "", fmt.Errorf("credential: failed to generate salt: %w", err) + } + + key, err := deriveKey(passphrase, sshKeyPath, salt) + if err != nil { + return "", err + } + block, err := aes.NewCipher(key) + if err != nil { + return "", fmt.Errorf("credential: cipher init: %w", err) + } + gcm, err := cipher.NewGCM(block) + if err != nil { + return "", fmt.Errorf("credential: gcm init: %w", err) + } + + nonce := make([]byte, nonceLen) + if _, err := io.ReadFull(rand.Reader, nonce); err != nil { + return "", fmt.Errorf("credential: failed to generate nonce: %w", err) + } + + ciphertext := gcm.Seal(nil, nonce, []byte(plaintext), nil) + blob := make([]byte, 0, saltLen+nonceLen+len(ciphertext)) + blob = append(blob, salt...) + blob = append(blob, nonce...) + blob = append(blob, ciphertext...) + return encScheme + base64.StdEncoding.EncodeToString(blob), nil +} + +// isWithinDir reports whether path is contained within (or equal to) dir. +// Uses filepath.IsLocal on the relative path for robust cross-platform traversal detection. +func isWithinDir(path, dir string) bool { + rel, err := filepath.Rel(filepath.Clean(dir), filepath.Clean(path)) + return err == nil && filepath.IsLocal(rel) +} + +// allowedSSHKeyPath reports whether path is in a permitted location for SSH key files: +// - exact match with PICOCLAW_SSH_KEY_PATH env var +// - within the PICOCLAW_HOME env var directory +// - within ~/.ssh/ +func allowedSSHKeyPath(path string) bool { + if path == "" { + return true // passphrase-only mode; no file will be read + } + clean := filepath.Clean(path) + + // Exact match with PICOCLAW_SSH_KEY_PATH. + if envPath, ok := os.LookupEnv(sshKeyEnv); ok && envPath != "" { + if clean == filepath.Clean(envPath) { + return true + } + } + + // Within PICOCLAW_HOME. + if picoHome := os.Getenv("PICOCLAW_HOME"); picoHome != "" { + if isWithinDir(clean, picoHome) { + return true + } + } + + // Within ~/.ssh/. + if userHome, err := os.UserHomeDir(); err == nil { + if isWithinDir(clean, filepath.Join(userHome, ".ssh")) { + return true + } + } + + return false +} + +// deriveKey derives a 32-byte AES-256 key from passphrase and SSH private key. +// +// ikm = HMAC-SHA256(key=SHA256(sshKeyBytes), msg=passphrase) +// Final key: HKDF-SHA256(ikm, salt, info="picoclaw-credential-v1", 32 bytes) +// sshKeyPath must be non-empty; returns an error otherwise. +func deriveKey(passphrase, sshKeyPath string, salt []byte) ([]byte, error) { + if sshKeyPath == "" { + return nil, fmt.Errorf( + "credential: SSH private key is required but not found" + + " (set PICOCLAW_SSH_KEY_PATH or place key at ~/.ssh/picoclaw_ed25519.key)") + } + if !allowedSSHKeyPath(sshKeyPath) { + return nil, fmt.Errorf( + "credential: SSH key path %q is not in an allowed location (PICOCLAW_SSH_KEY_PATH, PICOCLAW_HOME, or ~/.ssh/)", + sshKeyPath, + ) + } + sshBytes, err := os.ReadFile(sshKeyPath) + if err != nil { + return nil, fmt.Errorf("credential: cannot read SSH key %q: %w", sshKeyPath, err) + } + sshHash := sha256.Sum256(sshBytes) + mac := hmac.New(sha256.New, sshHash[:]) + mac.Write([]byte(passphrase)) + ikm := mac.Sum(nil) + + key, err := hkdf.Key(sha256.New, ikm, salt, hkdfInfo, keyLen) + if err != nil { + return nil, fmt.Errorf("credential: HKDF expand failed: %w", err) + } + return key, nil +} + +// pickSSHKeyPath returns the SSH private key path to use for encryption/decryption. +// +// Priority: +// 1. override (non-empty explicit argument) +// 2. PICOCLAW_SSH_KEY_PATH env var +// 3. ~/.ssh/picoclaw_ed25519.key (auto-detection) +// +// Returns "" when no key is found; deriveKey will return an error in that case. +func pickSSHKeyPath(override string) string { + if override != "" { + return override + } + if p, ok := os.LookupEnv(sshKeyEnv); ok { + return p // respect explicit setting, even if "" + } + return findDefaultSSHKey() +} + +// findDefaultSSHKey returns the picoclaw-specific SSH key path if it exists. +func findDefaultSSHKey() string { + p, err := DefaultSSHKeyPath() + if err != nil { + return "" + } + if _, err := os.Stat(p); err == nil { + return p + } + return "" +} diff --git a/pkg/credential/credential_test.go b/pkg/credential/credential_test.go new file mode 100644 index 000000000..138af3134 --- /dev/null +++ b/pkg/credential/credential_test.go @@ -0,0 +1,283 @@ +package credential_test + +import ( + "os" + "path/filepath" + "testing" + + "github.com/sipeed/picoclaw/pkg/credential" +) + +func TestResolve_PlainKey(t *testing.T) { + r := credential.NewResolver(t.TempDir()) + got, err := r.Resolve("sk-plaintext-key") + if err != nil { + t.Fatalf("unexpected error: %v", err) + } + if got != "sk-plaintext-key" { + t.Fatalf("got %q, want %q", got, "sk-plaintext-key") + } +} + +func TestResolve_FileKey_Success(t *testing.T) { + dir := t.TempDir() + keyFile := "openai_plain.key" + if err := os.WriteFile(filepath.Join(dir, keyFile), []byte("sk-from-file\n"), 0o600); err != nil { + t.Fatalf("setup: %v", err) + } + + r := credential.NewResolver(dir) + got, err := r.Resolve("file://" + keyFile) + if err != nil { + t.Fatalf("unexpected error: %v", err) + } + if got != "sk-from-file" { + t.Fatalf("got %q, want %q", got, "sk-from-file") + } +} + +func TestResolve_FileKey_NotFound(t *testing.T) { + r := credential.NewResolver(t.TempDir()) + _, err := r.Resolve("file://missing.key") + if err == nil { + t.Fatal("expected error for missing file, got nil") + } +} + +func TestResolve_FileKey_Empty(t *testing.T) { + dir := t.TempDir() + keyFile := "empty.key" + if err := os.WriteFile(filepath.Join(dir, keyFile), []byte(" \n"), 0o600); err != nil { + t.Fatalf("setup: %v", err) + } + + r := credential.NewResolver(dir) + _, err := r.Resolve("file://" + keyFile) + if err == nil { + t.Fatal("expected error for empty credential file, got nil") + } +} + +// TestResolve_EncKey_RoundTrip tests basic encryption/decryption round-trip with an SSH key. +func TestResolve_EncKey_RoundTrip(t *testing.T) { + dir := t.TempDir() + sshKeyPath := filepath.Join(dir, "picoclaw_ed25519.key") + if err := os.WriteFile(sshKeyPath, []byte("fake-ssh-key-material\n"), 0o600); err != nil { + t.Fatalf("setup: %v", err) + } + + const passphrase = "test-passphrase-32bytes-long-ok!" + const plaintext = "sk-encrypted-secret" + + t.Setenv("PICOCLAW_SSH_KEY_PATH", sshKeyPath) + + enc, err := credential.Encrypt(passphrase, "", plaintext) + if err != nil { + t.Fatalf("Encrypt: %v", err) + } + + t.Setenv("PICOCLAW_KEY_PASSPHRASE", passphrase) + + r := credential.NewResolver(t.TempDir()) + got, err := r.Resolve(enc) + if err != nil { + t.Fatalf("Resolve: %v", err) + } + if got != plaintext { + t.Fatalf("got %q, want %q", got, plaintext) + } +} + +// TestResolve_EncKey_WithSSHKey tests that the SSH key file is incorporated into key derivation. +func TestResolve_EncKey_WithSSHKey(t *testing.T) { + dir := t.TempDir() + sshKeyPath := filepath.Join(dir, "picoclaw_ed25519.key") + if err := os.WriteFile(sshKeyPath, []byte("fake-ssh-private-key-material\n"), 0o600); err != nil { + t.Fatalf("setup: %v", err) + } + + const passphrase = "test-passphrase" + const plaintext = "sk-ssh-protected-secret" + + // Set PICOCLAW_SSH_KEY_PATH before Encrypt so the path passes allowedSSHKeyPath validation. + t.Setenv("PICOCLAW_KEY_PASSPHRASE", passphrase) + t.Setenv("PICOCLAW_SSH_KEY_PATH", sshKeyPath) + + enc, err := credential.Encrypt(passphrase, sshKeyPath, plaintext) + if err != nil { + t.Fatalf("Encrypt: %v", err) + } + + r := credential.NewResolver(t.TempDir()) + got, err := r.Resolve(enc) + if err != nil { + t.Fatalf("Resolve: %v", err) + } + if got != plaintext { + t.Fatalf("got %q, want %q", got, plaintext) + } +} + +func TestResolve_EncKey_NoPassphrase(t *testing.T) { + dir := t.TempDir() + sshKeyPath := filepath.Join(dir, "picoclaw_ed25519.key") + if err := os.WriteFile(sshKeyPath, []byte("fake-ssh-key\n"), 0o600); err != nil { + t.Fatalf("setup: %v", err) + } + t.Setenv("PICOCLAW_SSH_KEY_PATH", sshKeyPath) + + enc, err := credential.Encrypt("some-passphrase", "", "sk-secret") + if err != nil { + t.Fatalf("Encrypt: %v", err) + } + + t.Setenv("PICOCLAW_KEY_PASSPHRASE", "") + + r := credential.NewResolver(t.TempDir()) + _, err = r.Resolve(enc) + if err == nil { + t.Fatal("expected error when PICOCLAW_KEY_PASSPHRASE is unset, got nil") + } +} + +func TestResolve_EncKey_BadCiphertext(t *testing.T) { + t.Setenv("PICOCLAW_KEY_PASSPHRASE", "some-passphrase") + t.Setenv("PICOCLAW_SSH_KEY_PATH", "") + + r := credential.NewResolver(t.TempDir()) + _, err := r.Resolve("enc://!!not-valid-base64!!") + if err == nil { + t.Fatal("expected error for invalid enc:// payload, got nil") + } +} + +func TestResolve_EncKey_PayloadTooShort(t *testing.T) { + t.Setenv("PICOCLAW_KEY_PASSPHRASE", "some-passphrase") + t.Setenv("PICOCLAW_SSH_KEY_PATH", "") + + // Valid base64 but fewer bytes than salt(16)+nonce(12)+1 minimum. + import64 := "dG9vc2hvcnQ=" // "tooshort" = 8 bytes + r := credential.NewResolver(t.TempDir()) + _, err := r.Resolve("enc://" + import64) + if err == nil { + t.Fatal("expected error for too-short enc:// payload, got nil") + } +} + +func TestResolve_EncKey_WrongPassphrase(t *testing.T) { + dir := t.TempDir() + sshKeyPath := filepath.Join(dir, "picoclaw_ed25519.key") + if err := os.WriteFile(sshKeyPath, []byte("fake-ssh-key\n"), 0o600); err != nil { + t.Fatalf("setup: %v", err) + } + t.Setenv("PICOCLAW_SSH_KEY_PATH", sshKeyPath) + + enc, err := credential.Encrypt("correct-passphrase", "", "sk-secret") + if err != nil { + t.Fatalf("Encrypt: %v", err) + } + + t.Setenv("PICOCLAW_KEY_PASSPHRASE", "wrong-passphrase") + + r := credential.NewResolver(t.TempDir()) + _, err = r.Resolve(enc) + if err == nil { + t.Fatal("expected decryption error for wrong passphrase, got nil") + } +} + +func TestEncrypt_EmptyPassphrase(t *testing.T) { + _, err := credential.Encrypt("", "", "sk-secret") + if err == nil { + t.Fatal("expected error for empty passphrase, got nil") + } +} + +func TestDeriveKey_SSHKeyNotFound(t *testing.T) { + // Encrypt with a real SSH key path, then try to decrypt with a missing path. + dir := t.TempDir() + sshKeyPath := filepath.Join(dir, "picoclaw_ed25519.key") + if err := os.WriteFile(sshKeyPath, []byte("fake-key\n"), 0o600); err != nil { + t.Fatalf("setup: %v", err) + } + + // Register the real key path so allowedSSHKeyPath validation passes for Encrypt. + t.Setenv("PICOCLAW_SSH_KEY_PATH", sshKeyPath) + + enc, err := credential.Encrypt("passphrase", sshKeyPath, "sk-secret") + if err != nil { + t.Fatalf("Encrypt: %v", err) + } + + // Point to a non-existent SSH key so deriveKey's ReadFile fails. + // The path is still under the same dir, so allowedSSHKeyPath passes (exact env match). + t.Setenv("PICOCLAW_KEY_PASSPHRASE", "passphrase") + t.Setenv("PICOCLAW_SSH_KEY_PATH", filepath.Join(dir, "nonexistent_key")) + + r := credential.NewResolver(t.TempDir()) + _, err = r.Resolve(enc) + if err == nil { + t.Fatal("expected error when SSH key file is missing, got nil") + } +} + +// TestResolve_FileRef_PathTraversal verifies that file:// references cannot escape configDir +// via relative traversal ("../../etc/passwd") or absolute paths ("/abs/path"). +func TestResolve_FileRef_PathTraversal(t *testing.T) { + dir := t.TempDir() + cfgPath := filepath.Join(dir, "config.json") + // Create a file outside configDir that the traversal would point to. + outsideFile := filepath.Join(t.TempDir(), "secret.key") + if err := os.WriteFile(outsideFile, []byte("stolen"), 0o600); err != nil { + t.Fatalf("setup: %v", err) + } + + r := credential.NewResolver(filepath.Dir(cfgPath)) + + cases := []string{ + "file://../../secret.key", + "file://../secret.key", + "file://" + outsideFile, // absolute path + } + for _, raw := range cases { + _, err := r.Resolve(raw) + if err == nil { + t.Errorf("Resolve(%q): expected path traversal error, got nil", raw) + } + } +} + +// TestResolve_FileRef_withinConfigDir verifies that a legitimate relative file:// ref works. +func TestResolve_FileRef_withinConfigDir(t *testing.T) { + dir := t.TempDir() + if err := os.WriteFile(filepath.Join(dir, "my.key"), []byte("sk-valid\n"), 0o600); err != nil { + t.Fatalf("setup: %v", err) + } + r := credential.NewResolver(dir) + got, err := r.Resolve("file://my.key") + if err != nil { + t.Fatalf("unexpected error: %v", err) + } + if got != "sk-valid" { + t.Fatalf("got %q, want %q", got, "sk-valid") + } +} + +// TestEncrypt_SSHKeyOutsideAllowedDirs verifies that Encrypt rejects SSH key paths +// that are not under PICOCLAW_SSH_KEY_PATH, PICOCLAW_HOME, or ~/.ssh/. +func TestEncrypt_SSHKeyOutsideAllowedDirs(t *testing.T) { + dir := t.TempDir() + sshKeyPath := filepath.Join(dir, "picoclaw_ed25519.key") + if err := os.WriteFile(sshKeyPath, []byte("fake-key\n"), 0o600); err != nil { + t.Fatalf("setup: %v", err) + } + + // Make sure none of the allowed env vars point here. + t.Setenv("PICOCLAW_SSH_KEY_PATH", "") + t.Setenv("PICOCLAW_HOME", "") + + _, err := credential.Encrypt("passphrase", sshKeyPath, "sk-secret") + if err == nil { + t.Fatal("expected error for SSH key outside allowed directories, got nil") + } +} diff --git a/pkg/credential/keygen.go b/pkg/credential/keygen.go new file mode 100644 index 000000000..c57564a76 --- /dev/null +++ b/pkg/credential/keygen.go @@ -0,0 +1,62 @@ +package credential + +import ( + "crypto/ed25519" + "crypto/rand" + "encoding/pem" + "fmt" + "os" + "path/filepath" + + "golang.org/x/crypto/ssh" +) + +// DefaultSSHKeyPath returns the canonical path for the picoclaw-specific SSH key. +// The path is always ~/.ssh/picoclaw_ed25519.key (os.UserHomeDir is cross-platform). +func DefaultSSHKeyPath() (string, error) { + home, err := os.UserHomeDir() + if err != nil { + return "", fmt.Errorf("credential: cannot determine home directory: %w", err) + } + return filepath.Join(home, ".ssh", "picoclaw_ed25519.key"), nil +} + +// GenerateSSHKey generates an Ed25519 SSH key pair and writes the private key +// to path (permissions 0600) and the public key to path+".pub" (permissions 0644). +// The ~/.ssh/ directory is created with 0700 if it does not exist. +// If the files already exist they are overwritten. +func GenerateSSHKey(path string) error { + if err := os.MkdirAll(filepath.Dir(path), 0o700); err != nil { + return fmt.Errorf("credential: keygen: cannot create directory %q: %w", filepath.Dir(path), err) + } + + pubRaw, privRaw, err := ed25519.GenerateKey(rand.Reader) + if err != nil { + return fmt.Errorf("credential: keygen: ed25519 key generation failed: %w", err) + } + + // Marshal private key as OpenSSH PEM. + block, err := ssh.MarshalPrivateKey(privRaw, "") + if err != nil { + return fmt.Errorf("credential: keygen: marshal private key: %w", err) + } + privPEM := pem.EncodeToMemory(block) + + if err = os.WriteFile(path, privPEM, 0o600); err != nil { + return fmt.Errorf("credential: keygen: write private key %q: %w", path, err) + } + + // Marshal public key as authorized_keys line. + sshPub, err := ssh.NewPublicKey(pubRaw) + if err != nil { + return fmt.Errorf("credential: keygen: marshal public key: %w", err) + } + pubLine := ssh.MarshalAuthorizedKey(sshPub) + + pubPath := path + ".pub" + if err := os.WriteFile(pubPath, pubLine, 0o644); err != nil { + return fmt.Errorf("credential: keygen: write public key %q: %w", pubPath, err) + } + + return nil +} diff --git a/pkg/credential/keygen_test.go b/pkg/credential/keygen_test.go new file mode 100644 index 000000000..1e21ea0b9 --- /dev/null +++ b/pkg/credential/keygen_test.go @@ -0,0 +1,115 @@ +package credential + +import ( + "crypto/ed25519" + "os" + "path/filepath" + "runtime" + "testing" + + "golang.org/x/crypto/ssh" +) + +func TestGenerateSSHKey_CreatesFiles(t *testing.T) { + dir := t.TempDir() + keyPath := filepath.Join(dir, "test_ed25519.key") + + if err := GenerateSSHKey(keyPath); err != nil { + t.Fatalf("GenerateSSHKey() error = %v", err) + } + + // Private key must exist. + privInfo, err := os.Stat(keyPath) + if err != nil { + t.Fatalf("private key file missing: %v", err) + } + + // Check permissions on non-Windows (Windows does not support Unix permission bits). + if runtime.GOOS != "windows" { + if got := privInfo.Mode().Perm(); got != 0o600 { + t.Errorf("private key permissions = %04o, want 0600", got) + } + } + + // Public key must exist. + pubPath := keyPath + ".pub" + pubInfo, err := os.Stat(pubPath) + if err != nil { + t.Fatalf("public key file missing: %v", err) + } + if runtime.GOOS != "windows" { + if got := pubInfo.Mode().Perm(); got != 0o644 { + t.Errorf("public key permissions = %04o, want 0644", got) + } + } + + // Private key must be parseable as an OpenSSH ed25519 key. + privPEM, err := os.ReadFile(keyPath) + if err != nil { + t.Fatalf("read private key: %v", err) + } + privKey, err := ssh.ParseRawPrivateKey(privPEM) + if err != nil { + t.Fatalf("parse private key: %v", err) + } + if _, ok := privKey.(*ed25519.PrivateKey); !ok { + t.Errorf("private key type = %T, want *ed25519.PrivateKey", privKey) + } + + // Public key must be parseable as authorized_keys line. + pubBytes, err := os.ReadFile(pubPath) + if err != nil { + t.Fatalf("read public key: %v", err) + } + pubKey, _, _, rest, err := ssh.ParseAuthorizedKey(pubBytes) + if err != nil { + t.Fatalf("parse public key: %v", err) + } + if pubKey == nil { + t.Fatal("expected non-nil public key") + } + if len(rest) > 0 { + t.Errorf("unexpected trailing bytes after public key: %d bytes", len(rest)) + } +} + +func TestGenerateSSHKey_OverwritesExisting(t *testing.T) { + dir := t.TempDir() + keyPath := filepath.Join(dir, "test_ed25519.key") + + // Generate twice; second call must not error and must produce a different key. + if err := GenerateSSHKey(keyPath); err != nil { + t.Fatalf("first GenerateSSHKey() error = %v", err) + } + first, err := os.ReadFile(keyPath) + if err != nil { + t.Fatalf("read first key: %v", err) + } + + if err = GenerateSSHKey(keyPath); err != nil { + t.Fatalf("second GenerateSSHKey() error = %v", err) + } + second, err := os.ReadFile(keyPath) + if err != nil { + t.Fatalf("read second key: %v", err) + } + + // Two independently generated Ed25519 keys must differ. + if string(first) == string(second) { + t.Error("expected overwritten key to differ from original") + } +} + +func TestGenerateSSHKey_CreatesDirectory(t *testing.T) { + dir := t.TempDir() + // Nested directory that does not yet exist. + keyPath := filepath.Join(dir, "subdir", ".ssh", "picoclaw_ed25519.key") + + if err := GenerateSSHKey(keyPath); err != nil { + t.Fatalf("GenerateSSHKey() error = %v", err) + } + + if _, err := os.Stat(keyPath); err != nil { + t.Fatalf("private key not created: %v", err) + } +} diff --git a/pkg/credential/store.go b/pkg/credential/store.go new file mode 100644 index 000000000..9c72974b0 --- /dev/null +++ b/pkg/credential/store.go @@ -0,0 +1,44 @@ +package credential + +import "sync/atomic" + +// SecureStore holds a passphrase in memory. +// +// Uses atomic.Pointer so reads and writes are lock-free. +// The passphrase is never written to disk; callers decide how to +// transport it outside this store (e.g., via cmd.Env or os.Environ). +type SecureStore struct { + val atomic.Pointer[string] +} + +// NewSecureStore creates an empty SecureStore. +func NewSecureStore() *SecureStore { + return &SecureStore{} +} + +// SetString stores the passphrase. An empty string clears the store. +func (s *SecureStore) SetString(passphrase string) { + if passphrase == "" { + s.val.Store(nil) + return + } + s.val.Store(&passphrase) +} + +// Get returns the stored passphrase, or "" if not set. +func (s *SecureStore) Get() string { + if p := s.val.Load(); p != nil { + return *p + } + return "" +} + +// IsSet reports whether a passphrase is currently stored. +func (s *SecureStore) IsSet() bool { + return s.val.Load() != nil +} + +// Clear removes the stored passphrase. +func (s *SecureStore) Clear() { + s.val.Store(nil) +} diff --git a/pkg/credential/store_test.go b/pkg/credential/store_test.go new file mode 100644 index 000000000..63299743a --- /dev/null +++ b/pkg/credential/store_test.go @@ -0,0 +1,81 @@ +package credential + +import ( + "sync" + "testing" +) + +func TestSecureStore_SetGet(t *testing.T) { + s := NewSecureStore() + if s.IsSet() { + t.Error("expected empty store") + } + + s.SetString("hunter2") + if !s.IsSet() { + t.Error("expected store to be set") + } + if got := s.Get(); got != "hunter2" { + t.Errorf("Get() = %q, want %q", got, "hunter2") + } +} + +func TestSecureStore_Clear(t *testing.T) { + s := NewSecureStore() + s.SetString("secret") + s.Clear() + + if s.IsSet() { + t.Error("expected store to be empty after Clear()") + } + if got := s.Get(); got != "" { + t.Errorf("Get() after Clear() = %q, want empty", got) + } +} + +func TestSecureStore_SetOverwrites(t *testing.T) { + s := NewSecureStore() + s.SetString("first") + s.SetString("second") + + if got := s.Get(); got != "second" { + t.Errorf("Get() = %q, want %q", got, "second") + } +} + +func TestSecureStore_EmptyPassphrase(t *testing.T) { + s := NewSecureStore() + s.SetString("") // empty → should not mark as set + + if s.IsSet() { + t.Error("empty passphrase should not mark store as set") + } +} + +func TestSecureStore_ConcurrentSetGet(t *testing.T) { + s := NewSecureStore() + const goroutines = 10 + const iterations = 1000 + + var wg sync.WaitGroup + wg.Add(goroutines) + for i := 0; i < goroutines; i++ { + go func(id int) { + defer wg.Done() + for j := 0; j < iterations; j++ { + if id%2 == 0 { + s.SetString("even") + } else { + s.SetString("odd") + } + _ = s.Get() + } + }(i) + } + wg.Wait() + + final := s.Get() + if final != "" && final != "even" && final != "odd" { + t.Errorf("Get() returned unexpected value %q after concurrent Set/Get", final) + } +} From 4d4243b919accb4969f2cfe71011e4a9989b80d5 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 16 Mar 2026 14:08:29 +0800 Subject: [PATCH 29/56] chore(deps): bump docker/setup-buildx-action from 3 to 4 (#1595) Bumps [docker/setup-buildx-action](https://github.com/docker/setup-buildx-action) from 3 to 4. - [Release notes](https://github.com/docker/setup-buildx-action/releases) - [Commits](https://github.com/docker/setup-buildx-action/compare/v3...v4) --- updated-dependencies: - dependency-name: docker/setup-buildx-action dependency-version: '4' dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- .github/workflows/docker-build.yml | 2 +- .github/workflows/nightly.yml | 2 +- .github/workflows/release.yml | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/workflows/docker-build.yml b/.github/workflows/docker-build.yml index dadbed212..c03c6346f 100644 --- a/.github/workflows/docker-build.yml +++ b/.github/workflows/docker-build.yml @@ -31,7 +31,7 @@ jobs: # ── Docker Buildx ───────────────────────── - name: 🔧 Set up Docker Buildx - uses: docker/setup-buildx-action@v3 + uses: docker/setup-buildx-action@v4 # ── Login to GHCR ───────────────────────── - name: 🔑 Login to GitHub Container Registry diff --git a/.github/workflows/nightly.yml b/.github/workflows/nightly.yml index 0103fcff1..375e2e211 100644 --- a/.github/workflows/nightly.yml +++ b/.github/workflows/nightly.yml @@ -59,7 +59,7 @@ jobs: uses: docker/setup-qemu-action@v3 - name: Set up Docker Buildx - uses: docker/setup-buildx-action@v3 + uses: docker/setup-buildx-action@v4 - name: Login to GitHub Container Registry uses: docker/login-action@v3 diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 4a584773d..56d2f2b23 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -77,7 +77,7 @@ jobs: uses: docker/setup-qemu-action@v3 - name: Set up Docker Buildx - uses: docker/setup-buildx-action@v3 + uses: docker/setup-buildx-action@v4 - name: Login to GitHub Container Registry uses: docker/login-action@v3 From 44ac304e5b122bac7fbc9c9b6699ff335f0da0e2 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 16 Mar 2026 14:09:01 +0800 Subject: [PATCH 30/56] chore(deps): bump actions/setup-node from 4 to 6 (#1597) Bumps [actions/setup-node](https://github.com/actions/setup-node) from 4 to 6. - [Release notes](https://github.com/actions/setup-node/releases) - [Commits](https://github.com/actions/setup-node/compare/v4...v6) --- updated-dependencies: - dependency-name: actions/setup-node dependency-version: '6' dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- .github/workflows/nightly.yml | 2 +- .github/workflows/release.yml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/nightly.yml b/.github/workflows/nightly.yml index 375e2e211..b29881d6c 100644 --- a/.github/workflows/nightly.yml +++ b/.github/workflows/nightly.yml @@ -48,7 +48,7 @@ jobs: go-version-file: go.mod - name: Setup Node.js - uses: actions/setup-node@v4 + uses: actions/setup-node@v6 with: node-version: 22 diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 56d2f2b23..84aade578 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -66,7 +66,7 @@ jobs: go-version-file: go.mod - name: Setup Node.js - uses: actions/setup-node@v4 + uses: actions/setup-node@v6 with: node-version: 22 From f247c3bc00cb8bba874712535ce07de8c6b1b613 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 16 Mar 2026 14:09:36 +0800 Subject: [PATCH 31/56] chore(deps): bump actions/setup-go from 5 to 6 (#1600) Bumps [actions/setup-go](https://github.com/actions/setup-go) from 5 to 6. - [Release notes](https://github.com/actions/setup-go/releases) - [Commits](https://github.com/actions/setup-go/compare/v5...v6) --- updated-dependencies: - dependency-name: actions/setup-go dependency-version: '6' dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- .github/workflows/pr.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/pr.yml b/.github/workflows/pr.yml index 1e9a7919a..902d4d4eb 100644 --- a/.github/workflows/pr.yml +++ b/.github/workflows/pr.yml @@ -34,7 +34,7 @@ jobs: persist-credentials: false - name: Setup Go - uses: actions/setup-go@v5 + uses: actions/setup-go@v6 with: go-version-file: go.mod From b7b8d1eeca7a750f3c42820727135dca8f080ced Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 16 Mar 2026 14:10:19 +0800 Subject: [PATCH 32/56] chore(deps): bump docker/build-push-action from 6 to 7 (#1602) Bumps [docker/build-push-action](https://github.com/docker/build-push-action) from 6 to 7. - [Release notes](https://github.com/docker/build-push-action/releases) - [Commits](https://github.com/docker/build-push-action/compare/v6...v7) --- updated-dependencies: - dependency-name: docker/build-push-action dependency-version: '7' dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- .github/workflows/docker-build.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/docker-build.yml b/.github/workflows/docker-build.yml index c03c6346f..8b4c033c2 100644 --- a/.github/workflows/docker-build.yml +++ b/.github/workflows/docker-build.yml @@ -62,7 +62,7 @@ jobs: # ── Build & Push ────────────────────────── - name: 🚀 Build and push Docker image - uses: docker/build-push-action@v6 + uses: docker/build-push-action@v7 with: context: . push: true From 0c94e6f7b3d2a19d4e0f85bb1b5647dda14355e0 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 16 Mar 2026 14:11:22 +0800 Subject: [PATCH 33/56] chore(deps): bump docker/login-action from 3 to 4 (#1604) Bumps [docker/login-action](https://github.com/docker/login-action) from 3 to 4. - [Release notes](https://github.com/docker/login-action/releases) - [Commits](https://github.com/docker/login-action/compare/v3...v4) --- updated-dependencies: - dependency-name: docker/login-action dependency-version: '4' dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- .github/workflows/docker-build.yml | 4 ++-- .github/workflows/nightly.yml | 4 ++-- .github/workflows/release.yml | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/.github/workflows/docker-build.yml b/.github/workflows/docker-build.yml index 8b4c033c2..784c404a6 100644 --- a/.github/workflows/docker-build.yml +++ b/.github/workflows/docker-build.yml @@ -35,7 +35,7 @@ jobs: # ── Login to GHCR ───────────────────────── - name: 🔑 Login to GitHub Container Registry - uses: docker/login-action@v3 + uses: docker/login-action@v4 with: registry: ${{ env.GHCR_REGISTRY }} username: ${{ github.actor }} @@ -43,7 +43,7 @@ jobs: # ── Login to Docker Hub ──────────────────── - name: 🔑 Login to Docker Hub - uses: docker/login-action@v3 + uses: docker/login-action@v4 with: registry: ${{ env.DOCKERHUB_REGISTRY }} username: ${{ secrets.DOCKERHUB_USERNAME }} diff --git a/.github/workflows/nightly.yml b/.github/workflows/nightly.yml index b29881d6c..e001dc3e9 100644 --- a/.github/workflows/nightly.yml +++ b/.github/workflows/nightly.yml @@ -62,14 +62,14 @@ jobs: uses: docker/setup-buildx-action@v4 - name: Login to GitHub Container Registry - uses: docker/login-action@v3 + uses: docker/login-action@v4 with: registry: ghcr.io username: ${{ github.actor }} password: ${{ secrets.GITHUB_TOKEN }} - name: Login to Docker Hub - uses: docker/login-action@v3 + uses: docker/login-action@v4 with: registry: docker.io username: ${{ secrets.DOCKERHUB_USERNAME }} diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 84aade578..19c8e5404 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -80,14 +80,14 @@ jobs: uses: docker/setup-buildx-action@v4 - name: Login to GitHub Container Registry - uses: docker/login-action@v3 + uses: docker/login-action@v4 with: registry: ghcr.io username: ${{ github.actor }} password: ${{ secrets.GITHUB_TOKEN }} - name: Login to Docker Hub - uses: docker/login-action@v3 + uses: docker/login-action@v4 with: registry: docker.io username: ${{ secrets.DOCKERHUB_USERNAME }} From c513ad22d73a579bb3fb30efc5b012b07c71a32c Mon Sep 17 00:00:00 2001 From: wenjie <meetwenjie@gmail.com> Date: Mon, 16 Mar 2026 16:25:16 +0800 Subject: [PATCH 34/56] fix(web): refactor pico chat flow and fix proxied websocket URLs (#1639) - move chat controller, state, protocol, history, and websocket logic into a dedicated chat feature module - improve chat reconnection, session hydration, and send gating based on actual websocket state - preserve gateway status during transient SSE disconnects and update stop state immediately - generate wss websocket URLs behind HTTPS proxies and add backend tests for forwarded proto handling --- web/backend/api/gateway_host.go | 20 +- web/backend/api/gateway_host_test.go | 53 +++ .../src/components/chat/chat-composer.tsx | 4 +- .../src/components/chat/chat-empty-state.tsx | 2 +- .../src/components/chat/chat-page.tsx | 23 +- .../chat/controller.ts} | 337 ++++++++++-------- web/frontend/src/features/chat/history.ts | 68 ++++ web/frontend/src/features/chat/protocol.ts | 81 +++++ .../chat/state.ts} | 0 web/frontend/src/features/chat/websocket.ts | 57 +++ web/frontend/src/hooks/use-gateway.ts | 12 +- web/frontend/src/hooks/use-pico-chat.ts | 4 +- web/frontend/src/hooks/use-websocket.ts | 47 --- web/frontend/src/routes/__root.tsx | 2 +- web/frontend/src/store/chat.ts | 2 +- web/frontend/src/store/gateway.ts | 12 +- 16 files changed, 509 insertions(+), 215 deletions(-) rename web/frontend/src/{lib/pico-chat-controller.ts => features/chat/controller.ts} (53%) create mode 100644 web/frontend/src/features/chat/history.ts create mode 100644 web/frontend/src/features/chat/protocol.ts rename web/frontend/src/{lib/pico-chat-state.ts => features/chat/state.ts} (100%) create mode 100644 web/frontend/src/features/chat/websocket.ts delete mode 100644 web/frontend/src/hooks/use-websocket.ts diff --git a/web/backend/api/gateway_host.go b/web/backend/api/gateway_host.go index a499c1ea2..5ef3ba2c5 100644 --- a/web/backend/api/gateway_host.go +++ b/web/backend/api/gateway_host.go @@ -57,10 +57,28 @@ func requestHostName(r *http.Request) string { return "127.0.0.1" } +func requestWSScheme(r *http.Request) string { + if forwarded := strings.TrimSpace(r.Header.Get("X-Forwarded-Proto")); forwarded != "" { + proto := strings.ToLower(strings.TrimSpace(strings.Split(forwarded, ",")[0])) + if proto == "https" || proto == "wss" { + return "wss" + } + if proto == "http" || proto == "ws" { + return "ws" + } + } + + if r.TLS != nil { + return "wss" + } + + return "ws" +} + func (h *Handler) buildWsURL(r *http.Request, cfg *config.Config) string { host := h.effectiveGatewayBindHost(cfg) if host == "" || host == "0.0.0.0" { host = requestHostName(r) } - return "ws://" + net.JoinHostPort(host, strconv.Itoa(cfg.Gateway.Port)) + "/pico/ws" + return requestWSScheme(r) + "://" + net.JoinHostPort(host, strconv.Itoa(cfg.Gateway.Port)) + "/pico/ws" } diff --git a/web/backend/api/gateway_host_test.go b/web/backend/api/gateway_host_test.go index afd600359..43e84ff0e 100644 --- a/web/backend/api/gateway_host_test.go +++ b/web/backend/api/gateway_host_test.go @@ -1,6 +1,7 @@ package api import ( + "crypto/tls" "net/http/httptest" "path/filepath" "testing" @@ -57,3 +58,55 @@ func TestGatewayProbeHostUsesLoopbackForWildcardBind(t *testing.T) { t.Fatalf("gatewayProbeHost() = %q, want %q", got, "127.0.0.1") } } + +func TestBuildWsURLUsesWSSWhenForwardedProtoIsHTTPS(t *testing.T) { + configPath := filepath.Join(t.TempDir(), "config.json") + h := NewHandler(configPath) + + cfg := config.DefaultConfig() + cfg.Gateway.Host = "0.0.0.0" + cfg.Gateway.Port = 18790 + + req := httptest.NewRequest("GET", "http://launcher.local/api/pico/token", nil) + req.Host = "chat.example.com" + req.Header.Set("X-Forwarded-Proto", "https") + + if got := h.buildWsURL(req, cfg); got != "wss://chat.example.com:18790/pico/ws" { + t.Fatalf("buildWsURL() = %q, want %q", got, "wss://chat.example.com:18790/pico/ws") + } +} + +func TestBuildWsURLUsesWSSWhenRequestIsTLS(t *testing.T) { + configPath := filepath.Join(t.TempDir(), "config.json") + h := NewHandler(configPath) + + cfg := config.DefaultConfig() + cfg.Gateway.Host = "0.0.0.0" + cfg.Gateway.Port = 18790 + + req := httptest.NewRequest("GET", "https://launcher.local/api/pico/token", nil) + req.Host = "secure.example.com" + req.TLS = &tls.ConnectionState{} + + if got := h.buildWsURL(req, cfg); got != "wss://secure.example.com:18790/pico/ws" { + t.Fatalf("buildWsURL() = %q, want %q", got, "wss://secure.example.com:18790/pico/ws") + } +} + +func TestBuildWsURLPrefersForwardedHTTPOverTLS(t *testing.T) { + configPath := filepath.Join(t.TempDir(), "config.json") + h := NewHandler(configPath) + + cfg := config.DefaultConfig() + cfg.Gateway.Host = "0.0.0.0" + cfg.Gateway.Port = 18790 + + req := httptest.NewRequest("GET", "https://launcher.local/api/pico/token", nil) + req.Host = "chat.example.com" + req.TLS = &tls.ConnectionState{} + req.Header.Set("X-Forwarded-Proto", "http") + + if got := h.buildWsURL(req, cfg); got != "ws://chat.example.com:18790/pico/ws" { + t.Fatalf("buildWsURL() = %q, want %q", got, "ws://chat.example.com:18790/pico/ws") + } +} diff --git a/web/frontend/src/components/chat/chat-composer.tsx b/web/frontend/src/components/chat/chat-composer.tsx index e8bae89b8..7d696b898 100644 --- a/web/frontend/src/components/chat/chat-composer.tsx +++ b/web/frontend/src/components/chat/chat-composer.tsx @@ -42,7 +42,7 @@ export function ChatComposer({ placeholder={t("chat.placeholder")} disabled={!canInput} className={cn( - "max-h-[200px] min-h-[60px] resize-none border-0 bg-transparent px-2 py-1 text-[15px] shadow-none transition-colors focus-visible:ring-0 focus-visible:outline-none dark:bg-transparent", + "placeholder:text-muted-foreground max-h-[200px] min-h-[60px] resize-none border-0 bg-transparent px-2 py-1 text-[15px] shadow-none transition-colors focus-visible:ring-0 focus-visible:outline-none dark:bg-transparent", !canInput && "cursor-not-allowed", )} minRows={1} @@ -56,7 +56,7 @@ export function ChatComposer({ size="icon" className="size-8 rounded-full bg-violet-500 text-white transition-transform hover:bg-violet-600 active:scale-95" onClick={onSend} - disabled={!input.trim() || !isConnected} + disabled={!input.trim() || !canInput} > <IconArrowUp className="size-4" /> </Button> diff --git a/web/frontend/src/components/chat/chat-empty-state.tsx b/web/frontend/src/components/chat/chat-empty-state.tsx index 624ff9c59..0574c44d1 100644 --- a/web/frontend/src/components/chat/chat-empty-state.tsx +++ b/web/frontend/src/components/chat/chat-empty-state.tsx @@ -34,7 +34,7 @@ export function ChatEmptyState({ <p className="text-muted-foreground mb-4 text-center text-sm"> {t("chat.empty.noConfiguredModelDescription")} </p> - <Button asChild variant="secondary" size="sm" className="px-4"> + <Button asChild variant="outline" size="sm" className="px-4"> <Link to="/models">{t("chat.empty.goToModels")}</Link> </Button> </div> diff --git a/web/frontend/src/components/chat/chat-page.tsx b/web/frontend/src/components/chat/chat-page.tsx index 1906a0367..ebcde8981 100644 --- a/web/frontend/src/components/chat/chat-page.tsx +++ b/web/frontend/src/components/chat/chat-page.tsx @@ -15,7 +15,6 @@ import { useChatModels } from "@/hooks/use-chat-models" import { useGateway } from "@/hooks/use-gateway" import { usePicoChat } from "@/hooks/use-pico-chat" import { useSessionHistory } from "@/hooks/use-session-history" -import { hydrateActiveSession } from "@/lib/pico-chat-controller" export function ChatPage() { const { t } = useTranslation() @@ -26,6 +25,7 @@ export function ChatPage() { const { messages, + connectionState, isTyping, activeSessionId, sendMessage, @@ -34,7 +34,8 @@ export function ChatPage() { } = usePicoChat() const { state: gwState } = useGateway() - const isConnected = gwState === "running" + const isGatewayRunning = gwState === "running" + const isChatConnected = connectionState === "connected" const { defaultModelName, @@ -43,7 +44,8 @@ export function ChatPage() { oauthModels, localModels, handleSetDefault, - } = useChatModels({ isConnected }) + } = useChatModels({ isConnected: isGatewayRunning }) + const canSend = isChatConnected && Boolean(defaultModelName) const { sessions, @@ -68,10 +70,6 @@ export function ChatPage() { syncScrollState(e.currentTarget) } - useEffect(() => { - void hydrateActiveSession() - }, []) - useEffect(() => { if (scrollRef.current) { if (isAtBottom) { @@ -82,9 +80,10 @@ export function ChatPage() { }, [messages, isTyping, isAtBottom]) const handleSend = () => { - if (!input.trim() || !isConnected) return - sendMessage(input.trim()) - setInput("") + if (!input.trim() || !canSend) return + if (sendMessage(input.trim())) { + setInput("") + } } return ( @@ -143,7 +142,7 @@ export function ChatPage() { <ChatEmptyState hasConfiguredModels={hasConfiguredModels} defaultModelName={defaultModelName} - isConnected={isConnected} + isConnected={isGatewayRunning} /> )} @@ -168,7 +167,7 @@ export function ChatPage() { input={input} onInputChange={setInput} onSend={handleSend} - isConnected={isConnected} + isConnected={isChatConnected} hasDefaultModel={Boolean(defaultModelName)} /> </div> diff --git a/web/frontend/src/lib/pico-chat-controller.ts b/web/frontend/src/features/chat/controller.ts similarity index 53% rename from web/frontend/src/lib/pico-chat-controller.ts rename to web/frontend/src/features/chat/controller.ts index 0e77d1ad0..5e6eb2229 100644 --- a/web/frontend/src/lib/pico-chat-controller.ts +++ b/web/frontend/src/features/chat/controller.ts @@ -2,24 +2,24 @@ import { getDefaultStore } from "jotai" import { toast } from "sonner" import { getPicoToken } from "@/api/pico" -import { getSessionHistory } from "@/api/sessions" -import i18n from "@/i18n" +import { + loadSessionMessages, + mergeHistoryMessages, +} from "@/features/chat/history" +import { type PicoMessage, handlePicoMessage } from "@/features/chat/protocol" import { clearStoredSessionId, generateSessionId, - normalizeUnixTimestamp, readStoredSessionId, -} from "@/lib/pico-chat-state" -import { type ChatMessage, getChatState, updateChatStore } from "@/store/chat" -import { gatewayAtom } from "@/store/gateway" - -interface PicoMessage { - type: string - id?: string - session_id?: string - timestamp?: number | string - payload?: Record<string, unknown> -} +} from "@/features/chat/state" +import { + invalidateSocket, + isCurrentSocket, + normalizeWsUrlForBrowser, +} from "@/features/chat/websocket" +import i18n from "@/i18n" +import { getChatState, updateChatStore } from "@/store/chat" +import { type GatewayState, gatewayAtom } from "@/store/gateway" const store = getDefaultStore() @@ -31,81 +31,51 @@ let initialized = false let unsubscribeGateway: (() => void) | null = null let hydratePromise: Promise<void> | null = null let connectionGeneration = 0 +let reconnectTimer: number | null = null +let reconnectAttempts = 0 +let shouldMaintainConnection = false -async function loadSessionMessages(sessionId: string): Promise<ChatMessage[]> { - const detail = await getSessionHistory(sessionId) - const fallbackTime = detail.updated - - return detail.messages.map((message, index) => ({ - id: `hist-${index}-${Date.now()}`, - role: message.role, - content: message.content, - timestamp: fallbackTime, - })) +function clearReconnectTimer() { + if (reconnectTimer !== null) { + window.clearTimeout(reconnectTimer) + reconnectTimer = null + } } -function handlePicoMessage(message: PicoMessage) { - const payload = message.payload || {} +function shouldReconnectFor(generation: number, sessionId: string): boolean { + return ( + shouldMaintainConnection && + generation === connectionGeneration && + sessionId === activeSessionIdRef && + store.get(gatewayAtom).status === "running" + ) +} - switch (message.type) { - case "message.create": { - const content = (payload.content as string) || "" - const messageId = (payload.message_id as string) || `pico-${Date.now()}` - const timestamp = - message.timestamp !== undefined && - Number.isFinite(Number(message.timestamp)) - ? normalizeUnixTimestamp(Number(message.timestamp)) - : Date.now() - - updateChatStore((prev) => ({ - messages: [ - ...prev.messages, - { - id: messageId, - role: "assistant", - content, - timestamp, - }, - ], - isTyping: false, - })) - break - } - - case "message.update": { - const content = (payload.content as string) || "" - const messageId = payload.message_id as string - if (!messageId) { - break - } - - updateChatStore((prev) => ({ - messages: prev.messages.map((msg) => - msg.id === messageId ? { ...msg, content } : msg, - ), - })) - break - } - - case "typing.start": - updateChatStore({ isTyping: true }) - break - - case "typing.stop": - updateChatStore({ isTyping: false }) - break - - case "error": - console.error("Pico error:", payload) - updateChatStore({ isTyping: false }) - break - - case "pong": - break - - default: - console.log("Unknown pico message type:", message.type) +function scheduleReconnect(generation: number, sessionId: string) { + if (!shouldReconnectFor(generation, sessionId) || reconnectTimer !== null) { + return } + + const delay = Math.min(1000 * 2 ** reconnectAttempts, 5000) + reconnectAttempts += 1 + reconnectTimer = window.setTimeout(() => { + reconnectTimer = null + if (!shouldReconnectFor(generation, sessionId)) { + return + } + void connectChat() + }, delay) +} + +function needsActiveSessionHydration(): boolean { + const state = getChatState() + const storedSessionId = readStoredSessionId() + + return Boolean( + storedSessionId && + storedSessionId === state.activeSessionId && + !state.hasHydratedActiveSession, + ) } function setActiveSessionId(sessionId: string) { @@ -113,8 +83,35 @@ function setActiveSessionId(sessionId: string) { updateChatStore({ activeSessionId: sessionId }) } +function disconnectChatInternal({ + clearDesiredConnection, +}: { + clearDesiredConnection: boolean +}) { + connectionGeneration += 1 + clearReconnectTimer() + + if (clearDesiredConnection) { + shouldMaintainConnection = false + } + + const socket = wsRef + wsRef = null + isConnecting = false + + invalidateSocket(socket) + + updateChatStore({ + connectionState: "disconnected", + isTyping: false, + }) +} + export async function connectChat() { - if (store.get(gatewayAtom).status !== "running") { + if ( + store.get(gatewayAtom).status !== "running" || + needsActiveSessionHydration() + ) { return } @@ -130,12 +127,15 @@ export async function connectChat() { const generation = connectionGeneration + 1 connectionGeneration = generation isConnecting = true + clearReconnectTimer() updateChatStore({ connectionState: "connecting" }) try { const { token, ws_url } = await getPicoToken() + const sessionId = activeSessionIdRef if (generation !== connectionGeneration) { + isConnecting = false return } @@ -143,56 +143,71 @@ export async function connectChat() { console.error("No pico token available") updateChatStore({ connectionState: "error" }) isConnecting = false + scheduleReconnect(generation, sessionId) return } - let finalWsUrl = ws_url - try { - const parsedUrl = new URL(ws_url) - const isLocalHost = - parsedUrl.hostname === "localhost" || - parsedUrl.hostname === "127.0.0.1" || - parsedUrl.hostname === "0.0.0.0" - const isBrowserLocal = - window.location.hostname === "localhost" || - window.location.hostname === "127.0.0.1" - - if (isLocalHost && !isBrowserLocal) { - parsedUrl.hostname = window.location.hostname - finalWsUrl = parsedUrl.toString() - } - } catch (error) { - console.warn("Could not parse ws_url:", error) - } - - const url = `${finalWsUrl}?session_id=${encodeURIComponent(activeSessionIdRef)}` - // Send token as a subprotocol so it doesn't end up in the URL. + const finalWsUrl = normalizeWsUrlForBrowser(ws_url) + const url = `${finalWsUrl}?session_id=${encodeURIComponent(sessionId)}` const socket = new WebSocket(url, [`token.${token}`]) if (generation !== connectionGeneration) { - socket.close() + isConnecting = false + invalidateSocket(socket) return } socket.onopen = () => { - if (wsRef !== socket) { + if ( + !isCurrentSocket({ + socket, + currentSocket: wsRef, + generation, + currentGeneration: connectionGeneration, + sessionId, + currentSessionId: activeSessionIdRef, + }) + ) { return } updateChatStore({ connectionState: "connected" }) isConnecting = false + reconnectAttempts = 0 } socket.onmessage = (event) => { + if ( + !isCurrentSocket({ + socket, + currentSocket: wsRef, + generation, + currentGeneration: connectionGeneration, + sessionId, + currentSessionId: activeSessionIdRef, + }) + ) { + return + } + try { - const message: PicoMessage = JSON.parse(event.data) - handlePicoMessage(message) + const message = JSON.parse(event.data) as PicoMessage + handlePicoMessage(message, sessionId) } catch { console.warn("Non-JSON message from pico:", event.data) } } socket.onclose = () => { - if (wsRef !== socket) { + if ( + !isCurrentSocket({ + socket, + currentSocket: wsRef, + generation, + currentGeneration: connectionGeneration, + sessionId, + currentSessionId: activeSessionIdRef, + }) + ) { return } wsRef = null @@ -201,42 +216,42 @@ export async function connectChat() { connectionState: "disconnected", isTyping: false, }) + scheduleReconnect(generation, sessionId) } socket.onerror = () => { - if (wsRef !== socket) { + if ( + !isCurrentSocket({ + socket, + currentSocket: wsRef, + generation, + currentGeneration: connectionGeneration, + sessionId, + currentSessionId: activeSessionIdRef, + }) + ) { return } isConnecting = false updateChatStore({ connectionState: "error" }) + scheduleReconnect(generation, sessionId) } wsRef = socket } catch (error) { if (generation !== connectionGeneration) { + isConnecting = false return } console.error("Failed to connect to pico:", error) updateChatStore({ connectionState: "error" }) isConnecting = false + scheduleReconnect(generation, activeSessionIdRef) } } export function disconnectChat() { - connectionGeneration += 1 - - const socket = wsRef - wsRef = null - isConnecting = false - - if (socket) { - socket.close() - } - - updateChatStore({ - connectionState: "disconnected", - isTyping: false, - }) + disconnectChatInternal({ clearDesiredConnection: true }) } export async function hydrateActiveSession() { @@ -250,7 +265,6 @@ export async function hydrateActiveSession() { if ( !storedSessionId || state.hasHydratedActiveSession || - state.messages.length > 0 || storedSessionId !== state.activeSessionId ) { if (!state.hasHydratedActiveSession) { @@ -267,7 +281,13 @@ export async function hydrateActiveSession() { } if (currentState.messages.length > 0) { - updateChatStore({ hasHydratedActiveSession: true }) + updateChatStore({ + messages: mergeHistoryMessages( + historyMessages, + currentState.messages, + ), + hasHydratedActiveSession: true, + }) return } @@ -307,9 +327,10 @@ export async function hydrateActiveSession() { export function sendChatMessage(content: string) { if (!wsRef || wsRef.readyState !== WebSocket.OPEN) { console.warn("WebSocket not connected") - return + return false } + const socket = wsRef const id = `msg-${++msgIdCounter}-${Date.now()}` updateChatStore((prev) => ({ @@ -320,13 +341,23 @@ export function sendChatMessage(content: string) { isTyping: true, })) - wsRef.send( - JSON.stringify({ - type: "message.send", - id, - payload: { content }, - }), - ) + try { + socket.send( + JSON.stringify({ + type: "message.send", + id, + payload: { content }, + }), + ) + return true + } catch (error) { + console.error("Failed to send pico message:", error) + updateChatStore((prev) => ({ + messages: prev.messages.filter((message) => message.id !== id), + isTyping: false, + })) + return false + } } export async function switchChatSession(sessionId: string) { @@ -337,7 +368,7 @@ export async function switchChatSession(sessionId: string) { try { const historyMessages = await loadSessionMessages(sessionId) - disconnectChat() + disconnectChatInternal({ clearDesiredConnection: false }) setActiveSessionId(sessionId) updateChatStore({ messages: historyMessages, @@ -346,6 +377,7 @@ export async function switchChatSession(sessionId: string) { }) if (store.get(gatewayAtom).status === "running") { + shouldMaintainConnection = true await connectChat() } } catch (error) { @@ -359,7 +391,7 @@ export async function newChatSession() { return } - disconnectChat() + disconnectChatInternal({ clearDesiredConnection: false }) setActiveSessionId(generateSessionId()) updateChatStore({ messages: [], @@ -368,6 +400,7 @@ export async function newChatSession() { }) if (store.get(gatewayAtom).status === "running") { + shouldMaintainConnection = true await connectChat() } } @@ -379,23 +412,43 @@ export function initializeChatStore() { initialized = true activeSessionIdRef = getChatState().activeSessionId + let lastGatewayStatus: GatewayState | null = null - const syncConnectionWithGateway = () => { - if (store.get(gatewayAtom).status === "running") { + const syncConnectionWithGateway = (force: boolean = false) => { + const gatewayStatus = store.get(gatewayAtom).status + if (!force && gatewayStatus === lastGatewayStatus) { + return + } + lastGatewayStatus = gatewayStatus + + if (gatewayStatus === "running") { + shouldMaintainConnection = true + if (needsActiveSessionHydration()) { + return + } void connectChat() return } - disconnectChat() + if (gatewayStatus === "stopped" || gatewayStatus === "error") { + disconnectChatInternal({ clearDesiredConnection: true }) + } } unsubscribeGateway = store.sub(gatewayAtom, syncConnectionWithGateway) if (!readStoredSessionId()) { updateChatStore({ hasHydratedActiveSession: true }) + syncConnectionWithGateway(true) + return } - syncConnectionWithGateway() + void hydrateActiveSession().finally(() => { + if (!initialized) { + return + } + syncConnectionWithGateway(true) + }) } export function teardownChatStore() { diff --git a/web/frontend/src/features/chat/history.ts b/web/frontend/src/features/chat/history.ts new file mode 100644 index 000000000..886148184 --- /dev/null +++ b/web/frontend/src/features/chat/history.ts @@ -0,0 +1,68 @@ +import { getSessionHistory } from "@/api/sessions" +import { normalizeUnixTimestamp } from "@/features/chat/state" +import type { ChatMessage } from "@/store/chat" + +export async function loadSessionMessages( + sessionId: string, +): Promise<ChatMessage[]> { + const detail = await getSessionHistory(sessionId) + const fallbackTime = detail.updated + + return detail.messages.map((message, index) => ({ + id: `hist-${index}-${Date.now()}`, + role: message.role, + content: message.content, + timestamp: fallbackTime, + })) +} + +function normalizeMessageTimestamp(timestamp: number | string): string { + if (typeof timestamp === "number") { + return String(normalizeUnixTimestamp(timestamp)) + } + + const trimmed = timestamp.trim() + if (/^-?\d+(\.\d+)?$/.test(trimmed)) { + return String(normalizeUnixTimestamp(Number(trimmed))) + } + + const parsed = Date.parse(trimmed) + return Number.isNaN(parsed) ? trimmed : String(parsed) +} + +function messageSignature(message: ChatMessage): string { + return `${message.role}\u0000${message.content}\u0000${normalizeMessageTimestamp( + message.timestamp, + )}` +} + +function comparableTimestamp(timestamp: number | string): number { + const normalized = normalizeMessageTimestamp(timestamp) + const numeric = Number(normalized) + return Number.isFinite(numeric) ? numeric : 0 +} + +export function mergeHistoryMessages( + historyMessages: ChatMessage[], + currentMessages: ChatMessage[], +): ChatMessage[] { + const currentIds = new Set(currentMessages.map((message) => message.id)) + const currentSignatures = new Set( + currentMessages.map((message) => messageSignature(message)), + ) + + const merged = [ + ...historyMessages.filter( + (message) => + !currentIds.has(message.id) && + !currentSignatures.has(messageSignature(message)), + ), + ...currentMessages, + ] + + return merged.sort( + (left, right) => + comparableTimestamp(left.timestamp) - + comparableTimestamp(right.timestamp), + ) +} diff --git a/web/frontend/src/features/chat/protocol.ts b/web/frontend/src/features/chat/protocol.ts new file mode 100644 index 000000000..5e5220c77 --- /dev/null +++ b/web/frontend/src/features/chat/protocol.ts @@ -0,0 +1,81 @@ +import { normalizeUnixTimestamp } from "@/features/chat/state" +import { updateChatStore } from "@/store/chat" + +export interface PicoMessage { + type: string + id?: string + session_id?: string + timestamp?: number | string + payload?: Record<string, unknown> +} + +export function handlePicoMessage( + message: PicoMessage, + expectedSessionId: string, +) { + if (message.session_id && message.session_id !== expectedSessionId) { + return + } + + const payload = message.payload || {} + + switch (message.type) { + case "message.create": { + const content = (payload.content as string) || "" + const messageId = (payload.message_id as string) || `pico-${Date.now()}` + const timestamp = + message.timestamp !== undefined && + Number.isFinite(Number(message.timestamp)) + ? normalizeUnixTimestamp(Number(message.timestamp)) + : Date.now() + + updateChatStore((prev) => ({ + messages: [ + ...prev.messages, + { + id: messageId, + role: "assistant", + content, + timestamp, + }, + ], + isTyping: false, + })) + break + } + + case "message.update": { + const content = (payload.content as string) || "" + const messageId = payload.message_id as string + if (!messageId) { + break + } + + updateChatStore((prev) => ({ + messages: prev.messages.map((msg) => + msg.id === messageId ? { ...msg, content } : msg, + ), + })) + break + } + + case "typing.start": + updateChatStore({ isTyping: true }) + break + + case "typing.stop": + updateChatStore({ isTyping: false }) + break + + case "error": + console.error("Pico error:", payload) + updateChatStore({ isTyping: false }) + break + + case "pong": + break + + default: + console.log("Unknown pico message type:", message.type) + } +} diff --git a/web/frontend/src/lib/pico-chat-state.ts b/web/frontend/src/features/chat/state.ts similarity index 100% rename from web/frontend/src/lib/pico-chat-state.ts rename to web/frontend/src/features/chat/state.ts diff --git a/web/frontend/src/features/chat/websocket.ts b/web/frontend/src/features/chat/websocket.ts new file mode 100644 index 000000000..6b132e9a6 --- /dev/null +++ b/web/frontend/src/features/chat/websocket.ts @@ -0,0 +1,57 @@ +export function normalizeWsUrlForBrowser(wsUrl: string): string { + let finalWsUrl = wsUrl + + try { + const parsedUrl = new URL(wsUrl) + const isLocalHost = + parsedUrl.hostname === "localhost" || + parsedUrl.hostname === "127.0.0.1" || + parsedUrl.hostname === "0.0.0.0" + const isBrowserLocal = + window.location.hostname === "localhost" || + window.location.hostname === "127.0.0.1" + + if (isLocalHost && !isBrowserLocal) { + parsedUrl.hostname = window.location.hostname + finalWsUrl = parsedUrl.toString() + } + } catch (error) { + console.warn("Could not parse ws_url:", error) + } + + return finalWsUrl +} + +export function invalidateSocket(socket: WebSocket | null) { + if (!socket) { + return + } + + socket.onopen = null + socket.onmessage = null + socket.onclose = null + socket.onerror = null + socket.close() +} + +export function isCurrentSocket({ + socket, + currentSocket, + generation, + currentGeneration, + sessionId, + currentSessionId, +}: { + socket: WebSocket + currentSocket: WebSocket | null + generation: number + currentGeneration: number + sessionId: string + currentSessionId: string +}): boolean { + return ( + currentSocket === socket && + generation === currentGeneration && + sessionId === currentSessionId + ) +} diff --git a/web/frontend/src/hooks/use-gateway.ts b/web/frontend/src/hooks/use-gateway.ts index 848f4d59c..65ec2b776 100644 --- a/web/frontend/src/hooks/use-gateway.ts +++ b/web/frontend/src/hooks/use-gateway.ts @@ -67,10 +67,9 @@ export function useGateway() { } es.onerror = () => { - // EventSource will auto-reconnect - updateGatewayStore((prev) => - prev.status === "restarting" ? {} : { status: "unknown" }, - ) + // EventSource will auto-reconnect. Preserve the last known gateway + // status so transient SSE disconnects do not suppress chat websocket + // reconnects while polling catches up. } return () => { @@ -105,6 +104,11 @@ export function useGateway() { setLoading(true) try { await stopGateway() + updateGatewayStore({ + status: "stopped", + canStart: true, + restartRequired: false, + }) } catch (err) { console.error("Failed to stop gateway:", err) } finally { diff --git a/web/frontend/src/hooks/use-pico-chat.ts b/web/frontend/src/hooks/use-pico-chat.ts index 1b97a2a9c..3ac2e1613 100644 --- a/web/frontend/src/hooks/use-pico-chat.ts +++ b/web/frontend/src/hooks/use-pico-chat.ts @@ -5,7 +5,7 @@ import { newChatSession, sendChatMessage, switchChatSession, -} from "@/lib/pico-chat-controller" +} from "@/features/chat/controller" import { chatAtom } from "@/store/chat" const UNIX_MS_THRESHOLD = 1e12 @@ -33,7 +33,6 @@ function parseTimestamp(dateRaw: number | string | Date) { return dayjs(dateRaw) } -// Helper to format message timestamps export function formatMessageTime(dateRaw: number | string | Date): string { const date = parseTimestamp(dateRaw) if (!date.isValid()) { @@ -48,7 +47,6 @@ export function formatMessageTime(dateRaw: number | string | Date): string { return date.format("LT") } - // Cross-day formatting if (isThisYear) { return date.format("MMM D LT") } diff --git a/web/frontend/src/hooks/use-websocket.ts b/web/frontend/src/hooks/use-websocket.ts deleted file mode 100644 index c41b5ed34..000000000 --- a/web/frontend/src/hooks/use-websocket.ts +++ /dev/null @@ -1,47 +0,0 @@ -import { useCallback, useEffect, useRef, useState } from "react" - -export function useWebSocket(path: string) { - const [message, setMessage] = useState<string>("No messages yet") - const [connected, setConnected] = useState(false) - const wsRef = useRef<WebSocket | null>(null) - - const connect = useCallback(() => { - if (wsRef.current) { - wsRef.current.close() - } - - const protocol = window.location.protocol === "https:" ? "wss:" : "ws:" - const url = `${protocol}//${window.location.host}${path}` - const socket = new WebSocket(url) - - socket.onopen = () => { - setConnected(true) - setMessage("Connected to WebSocket server.") - } - - socket.onmessage = (event) => { - setMessage(event.data) - } - - socket.onclose = () => { - setConnected(false) - setMessage("WebSocket connection closed.") - } - - socket.onerror = (error) => { - setConnected(false) - setMessage("WebSocket error occurred.") - console.error("WebSocket Error:", error) - } - - wsRef.current = socket - }, [path]) - - useEffect(() => { - return () => { - wsRef.current?.close() - } - }, []) - - return { message, connected, connect } -} diff --git a/web/frontend/src/routes/__root.tsx b/web/frontend/src/routes/__root.tsx index 6431d9490..31fdb7804 100644 --- a/web/frontend/src/routes/__root.tsx +++ b/web/frontend/src/routes/__root.tsx @@ -3,7 +3,7 @@ import { TanStackRouterDevtools } from "@tanstack/react-router-devtools" import { useEffect } from "react" import { AppLayout } from "@/components/app-layout" -import { initializeChatStore } from "@/lib/pico-chat-controller" +import { initializeChatStore } from "@/features/chat/controller" const RootLayout = () => { useEffect(() => { diff --git a/web/frontend/src/store/chat.ts b/web/frontend/src/store/chat.ts index d79a1a93b..da5fa6670 100644 --- a/web/frontend/src/store/chat.ts +++ b/web/frontend/src/store/chat.ts @@ -3,7 +3,7 @@ import { atom, getDefaultStore } from "jotai" import { getInitialActiveSessionId, writeStoredSessionId, -} from "@/lib/pico-chat-state" +} from "@/features/chat/state" export interface ChatMessage { id: string diff --git a/web/frontend/src/store/gateway.ts b/web/frontend/src/store/gateway.ts index b7655839c..c5eee8451 100644 --- a/web/frontend/src/store/gateway.ts +++ b/web/frontend/src/store/gateway.ts @@ -31,7 +31,17 @@ function normalizeGatewayStoreState( prev: GatewayStoreState, patch: GatewayStorePatch, ) { - return { ...prev, ...patch } + const next = { ...prev, ...patch } + + if ( + next.status === prev.status && + next.canStart === prev.canStart && + next.restartRequired === prev.restartRequired + ) { + return prev + } + + return next } export function updateGatewayStore( From 8fc36a4f9bdd4ea1c9784d2570102a5a1d16dd57 Mon Sep 17 00:00:00 2001 From: Dmitrii Balabanov <dimonb@gmail.com> Date: Fri, 13 Mar 2026 12:06:48 +0200 Subject: [PATCH 35/56] fix(logger): mask bot tokens in 3rd-party logger output --- pkg/logger/logger_3rd_party.go | 36 ++++++++++++++++++++++------------ 1 file changed, 24 insertions(+), 12 deletions(-) diff --git a/pkg/logger/logger_3rd_party.go b/pkg/logger/logger_3rd_party.go index da50d686a..3c311520c 100644 --- a/pkg/logger/logger_3rd_party.go +++ b/pkg/logger/logger_3rd_party.go @@ -2,7 +2,19 @@ package logger -import "fmt" +import ( + "fmt" + "regexp" +) + +// botTokenRe matches the secret part of a Telegram bot token embedded in a URL +// or log message: /bot<id>:<secret>/ → /bot<id>:****/ +var botTokenRe = regexp.MustCompile(`(bot\d+:)[A-Za-z0-9_-]{20,}`) + +// maskSecrets replaces any embedded bot tokens in s with a redacted placeholder. +func maskSecrets(s string) string { + return botTokenRe.ReplaceAllString(s, "${1}****") +} // Logger implements common Logger interface type Logger struct { @@ -12,52 +24,52 @@ type Logger struct { // Debug logs debug messages func (b *Logger) Debug(v ...any) { - logMessage(DEBUG, b.component, fmt.Sprint(v...), nil) + logMessage(DEBUG, b.component, maskSecrets(fmt.Sprint(v...)), nil) } // Info logs info messages func (b *Logger) Info(v ...any) { - logMessage(INFO, b.component, fmt.Sprint(v...), nil) + logMessage(INFO, b.component, maskSecrets(fmt.Sprint(v...)), nil) } // Warn logs warning messages func (b *Logger) Warn(v ...any) { - logMessage(WARN, b.component, fmt.Sprint(v...), nil) + logMessage(WARN, b.component, maskSecrets(fmt.Sprint(v...)), nil) } // Error logs error messages func (b *Logger) Error(v ...any) { - logMessage(ERROR, b.component, fmt.Sprint(v...), nil) + logMessage(ERROR, b.component, maskSecrets(fmt.Sprint(v...)), nil) } // Debugf logs formatted debug messages func (b *Logger) Debugf(format string, v ...any) { - logMessage(DEBUG, b.component, fmt.Sprintf(format, v...), nil) + logMessage(DEBUG, b.component, maskSecrets(fmt.Sprintf(format, v...)), nil) } // Infof logs formatted info messages func (b *Logger) Infof(format string, v ...any) { - logMessage(INFO, b.component, fmt.Sprintf(format, v...), nil) + logMessage(INFO, b.component, maskSecrets(fmt.Sprintf(format, v...)), nil) } // Warnf logs formatted warning messages func (b *Logger) Warnf(format string, v ...any) { - logMessage(WARN, b.component, fmt.Sprintf(format, v...), nil) + logMessage(WARN, b.component, maskSecrets(fmt.Sprintf(format, v...)), nil) } // Warningf logs formatted warning messages func (b *Logger) Warningf(format string, v ...any) { - logMessage(WARN, b.component, fmt.Sprintf(format, v...), nil) + logMessage(WARN, b.component, maskSecrets(fmt.Sprintf(format, v...)), nil) } // Errorf logs formatted error messages func (b *Logger) Errorf(format string, v ...any) { - logMessage(ERROR, b.component, fmt.Sprintf(format, v...), nil) + logMessage(ERROR, b.component, maskSecrets(fmt.Sprintf(format, v...)), nil) } // Fatalf logs formatted fatal messages and exits func (b *Logger) Fatalf(format string, v ...any) { - logMessage(FATAL, b.component, fmt.Sprintf(format, v...), nil) + logMessage(FATAL, b.component, maskSecrets(fmt.Sprintf(format, v...)), nil) } // Log logs a message at a given level with caller information @@ -75,7 +87,7 @@ func (b *Logger) Log(msgL, caller int, format string, a ...any) { level = lvl } } - logMessage(level, b.component, fmt.Sprintf(format, a...), nil) + logMessage(level, b.component, maskSecrets(fmt.Sprintf(format, a...)), nil) } // Sync flushes log buffer (no-op for this implementation) From 64ceb5ab760703b0b27e933f1a022f7b64de64aa Mon Sep 17 00:00:00 2001 From: Dmitrii Balabanov <dimonb@gmail.com> Date: Fri, 13 Mar 2026 12:09:03 +0200 Subject: [PATCH 36/56] fix(logger): show first/last 4 chars of bot token for identification --- pkg/logger/logger_3rd_party.go | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/pkg/logger/logger_3rd_party.go b/pkg/logger/logger_3rd_party.go index 3c311520c..d0cb178c5 100644 --- a/pkg/logger/logger_3rd_party.go +++ b/pkg/logger/logger_3rd_party.go @@ -7,13 +7,14 @@ import ( "regexp" ) -// botTokenRe matches the secret part of a Telegram bot token embedded in a URL -// or log message: /bot<id>:<secret>/ → /bot<id>:****/ -var botTokenRe = regexp.MustCompile(`(bot\d+:)[A-Za-z0-9_-]{20,}`) +// botTokenRe matches the bot ID prefix and the secret part of a Telegram bot token. +// Groups: 1 = "bot<id>:", 2 = first 4 chars of secret, 3 = middle, 4 = last 4 chars. +var botTokenRe = regexp.MustCompile(`(bot\d+:)([A-Za-z0-9_-]{4})[A-Za-z0-9_-]{12,}([A-Za-z0-9_-]{4})`) -// maskSecrets replaces any embedded bot tokens in s with a redacted placeholder. +// maskSecrets replaces any embedded bot tokens in s with a redacted placeholder +// that keeps the first and last 4 characters of the secret for identification. func maskSecrets(s string) string { - return botTokenRe.ReplaceAllString(s, "${1}****") + return botTokenRe.ReplaceAllString(s, "${1}${2}****${3}") } // Logger implements common Logger interface From be4a33cc150c6ea0f41b3bd939b15dc526f84603 Mon Sep 17 00:00:00 2001 From: Cytown <cytown@gmail.com> Date: Tue, 17 Mar 2026 09:35:52 +0800 Subject: [PATCH 37/56] refactor gateway/helpers and add server.pid to health (#1646) --- cmd/picoclaw/internal/gateway/helpers.go | 121 ++++++++++------------- pkg/health/server.go | 3 + 2 files changed, 55 insertions(+), 69 deletions(-) diff --git a/cmd/picoclaw/internal/gateway/helpers.go b/cmd/picoclaw/internal/gateway/helpers.go index 3562f03ef..85e93bcf9 100644 --- a/cmd/picoclaw/internal/gateway/helpers.go +++ b/cmd/picoclaw/internal/gateway/helpers.go @@ -7,6 +7,7 @@ import ( "os/signal" "path/filepath" "sync" + "syscall" "time" "github.com/sipeed/picoclaw/cmd/picoclaw/internal" @@ -43,7 +44,6 @@ import ( // Timeout constants for service operations const ( - serviceRestartTimeout = 30 * time.Second serviceShutdownTimeout = 30 * time.Second providerReloadTimeout = 30 * time.Second gracefulShutdownTimeout = 15 * time.Second @@ -121,7 +121,7 @@ func gatewayCmd(debug bool) error { defer stopWatch() sigChan := make(chan os.Signal, 1) - signal.Notify(sigChan, os.Interrupt) + signal.Notify(sigChan, os.Interrupt, syscall.SIGTERM) // Main event loop - wait for signals or config changes for { @@ -150,7 +150,8 @@ func setupAndStartServices( // Setup cron tool and service execTimeout := time.Duration(cfg.Tools.Cron.ExecTimeoutMinutes) * time.Minute - services.CronService = setupCronTool( + var err error + services.CronService, err = setupCronTool( agentLoop, msgBus, cfg.WorkspacePath(), @@ -158,7 +159,10 @@ func setupAndStartServices( execTimeout, cfg, ) - if err := services.CronService.Start(); err != nil { + if err != nil { + return nil, fmt.Errorf("error setting up cron service: %w", err) + } + if err = services.CronService.Start(); err != nil { return nil, fmt.Errorf("error starting cron service: %w", err) } fmt.Println("✓ Cron service started") @@ -170,26 +174,8 @@ func setupAndStartServices( cfg.Heartbeat.Enabled, ) services.HeartbeatService.SetBus(msgBus) - services.HeartbeatService.SetHandler(func(prompt, channel, chatID string) *tools.ToolResult { - // Use cli:direct as fallback if no valid channel - if channel == "" || chatID == "" { - channel, chatID = "cli", "direct" - } - // Use ProcessHeartbeat - no session history, each heartbeat is independent - var response string - var err error - response, err = agentLoop.ProcessHeartbeat(context.Background(), prompt, channel, chatID) - if err != nil { - return tools.ErrorResult(fmt.Sprintf("Heartbeat error: %v", err)) - } - if response == "HEARTBEAT_OK" { - return tools.SilentResult("Heartbeat OK") - } - // For heartbeat, always return silent - the subagent result will be - // sent to user via processSystemMessage when the async task completes - return tools.SilentResult(response) - }) - if err := services.HeartbeatService.Start(); err != nil { + services.HeartbeatService.SetHandler(createHeartbeatHandler(agentLoop)) + if err = services.HeartbeatService.Start(); err != nil { return nil, fmt.Errorf("error starting heartbeat service: %w", err) } fmt.Println("✓ Heartbeat service started") @@ -206,7 +192,6 @@ func setupAndStartServices( } // Create channel manager - var err error services.ChannelManager, err = channels.NewManager(cfg, msgBus, services.MediaStore) if err != nil { // Stop the media store if it's a FileMediaStore with cleanup @@ -238,7 +223,7 @@ func setupAndStartServices( services.HealthServer = health.NewServer(cfg.Gateway.Host, cfg.Gateway.Port) services.ChannelManager.SetupHTTPServer(addr, services.HealthServer) - if err := services.ChannelManager.StartAll(context.Background()); err != nil { + if err = services.ChannelManager.StartAll(context.Background()); err != nil { return nil, fmt.Errorf("error starting channels: %w", err) } @@ -251,7 +236,7 @@ func setupAndStartServices( MonitorUSB: cfg.Devices.MonitorUSB, }, stateManager) services.DeviceService.SetBus(msgBus) - if err := services.DeviceService.Start(context.Background()); err != nil { + if err = services.DeviceService.Start(context.Background()); err != nil { logger.ErrorCF("device", "Error starting device service", map[string]any{"error": err.Error()}) } else if cfg.Devices.Enabled { fmt.Println("✓ Device event service started") @@ -386,17 +371,13 @@ func restartServices( services *gatewayServices, msgBus *bus.MessageBus, ) error { - // Create an independent context with timeout for service restart - // This prevents cancellation from the main loop context during reload - ctx, cancel := context.WithTimeout(context.Background(), serviceRestartTimeout) - defer cancel() - // Get current config from agent loop (which has been updated if this is a reload) cfg := al.GetConfig() // Re-create and start cron service with new config execTimeout := time.Duration(cfg.Tools.Cron.ExecTimeoutMinutes) * time.Minute - services.CronService = setupCronTool( + var err error + services.CronService, err = setupCronTool( al, msgBus, cfg.WorkspacePath(), @@ -404,7 +385,10 @@ func restartServices( execTimeout, cfg, ) - if err := services.CronService.Start(); err != nil { + if err != nil { + return fmt.Errorf("error restarting cron service: %w", err) + } + if err = services.CronService.Start(); err != nil { return fmt.Errorf("error restarting cron service: %w", err) } fmt.Println(" ✓ Cron service restarted") @@ -416,31 +400,12 @@ func restartServices( cfg.Heartbeat.Enabled, ) services.HeartbeatService.SetBus(msgBus) - services.HeartbeatService.SetHandler(func(prompt, channel, chatID string) *tools.ToolResult { - if channel == "" || chatID == "" { - channel, chatID = "cli", "direct" - } - var response string - var err error - response, err = al.ProcessHeartbeat(context.Background(), prompt, channel, chatID) - if err != nil { - return tools.ErrorResult(fmt.Sprintf("Heartbeat error: %v", err)) - } - if response == "HEARTBEAT_OK" { - return tools.SilentResult("Heartbeat OK") - } - return tools.SilentResult(response) - }) - if err := services.HeartbeatService.Start(); err != nil { + services.HeartbeatService.SetHandler(createHeartbeatHandler(al)) + if err = services.HeartbeatService.Start(); err != nil { return fmt.Errorf("error restarting heartbeat service: %w", err) } fmt.Println(" ✓ Heartbeat service restarted") - // Stop the old media store before creating a new one - if fms, ok := services.MediaStore.(*media.FileMediaStore); ok { - fms.Stop() - } - // Re-create media store with new config services.MediaStore = media.NewFileMediaStoreWithCleanup(media.MediaCleanerConfig{ Enabled: cfg.Tools.MediaCleanup.Enabled, @@ -454,13 +419,8 @@ func restartServices( al.SetMediaStore(services.MediaStore) // Re-create channel manager with new config - var err error services.ChannelManager, err = channels.NewManager(cfg, msgBus, services.MediaStore) if err != nil { - // Stop the media store if it's a FileMediaStore with cleanup - if fms, ok := services.MediaStore.(*media.FileMediaStore); ok { - fms.Stop() - } return fmt.Errorf("error recreating channel manager: %w", err) } al.SetChannelManager(services.ChannelManager) @@ -477,7 +437,8 @@ func restartServices( services.HealthServer = health.NewServer(cfg.Gateway.Host, cfg.Gateway.Port) services.ChannelManager.SetupHTTPServer(addr, services.HealthServer) - if err := services.ChannelManager.StartAll(ctx); err != nil { + // Use background context for lifecycle to ensure services persist after restartServices returns + if err = services.ChannelManager.StartAll(context.Background()); err != nil { return fmt.Errorf("error restarting channels: %w", err) } fmt.Printf( @@ -493,7 +454,7 @@ func restartServices( MonitorUSB: cfg.Devices.MonitorUSB, }, stateManager) services.DeviceService.SetBus(msgBus) - if err := services.DeviceService.Start(ctx); err != nil { + if err := services.DeviceService.Start(context.Background()); err != nil { logger.WarnCF("device", "Failed to restart device service", map[string]any{"error": err.Error()}) } else if cfg.Devices.Enabled { fmt.Println(" ✓ Device event service restarted") @@ -544,6 +505,10 @@ func setupConfigWatcherPolling(configPath string, debug bool) (chan *config.Conf // Debounce - wait a bit to ensure file write is complete time.Sleep(500 * time.Millisecond) + // Update last known state to prevent repeated reload attempts on failure + lastModTime = currentModTime + lastSize = currentSize + // Validate and load new config newCfg, err := config.LoadConfig(configPath) if err != nil { @@ -561,10 +526,6 @@ func setupConfigWatcherPolling(configPath string, debug bool) (chan *config.Conf logger.Info("✓ Config file validated and loaded") - // Update last known state - lastModTime = currentModTime - lastSize = currentSize - // Send new config to main loop (non-blocking) select { case configChan <- newCfg: @@ -613,7 +574,7 @@ func setupCronTool( restrict bool, execTimeout time.Duration, cfg *config.Config, -) *cron.CronService { +) (*cron.CronService, error) { cronStorePath := filepath.Join(workspace, "cron", "jobs.json") // Create cron service @@ -625,7 +586,7 @@ func setupCronTool( var err error cronTool, err = tools.NewCronTool(cronService, agentLoop, msgBus, workspace, restrict, execTimeout, cfg) if err != nil { - logger.Fatalf("Critical error during CronTool initialization: %v", err) + return nil, fmt.Errorf("critical error during CronTool initialization: %w", err) } agentLoop.RegisterTool(cronTool) @@ -639,5 +600,27 @@ func setupCronTool( }) } - return cronService + return cronService, nil +} + +func createHeartbeatHandler(agentLoop *agent.AgentLoop) func(prompt, channel, chatID string) *tools.ToolResult { + return func(prompt, channel, chatID string) *tools.ToolResult { + // Use cli:direct as fallback if no valid channel + if channel == "" || chatID == "" { + channel, chatID = "cli", "direct" + } + // Use ProcessHeartbeat - no session history, each heartbeat is independent + var response string + var err error + response, err = agentLoop.ProcessHeartbeat(context.Background(), prompt, channel, chatID) + if err != nil { + return tools.ErrorResult(fmt.Sprintf("Heartbeat error: %v", err)) + } + if response == "HEARTBEAT_OK" { + return tools.SilentResult("Heartbeat OK") + } + // For heartbeat, always return silent - the subagent result will be + // sent to user via processSystemMessage when the async task completes + return tools.SilentResult(response) + } } diff --git a/pkg/health/server.go b/pkg/health/server.go index 5609ebdf6..b9ee9f496 100644 --- a/pkg/health/server.go +++ b/pkg/health/server.go @@ -6,6 +6,7 @@ import ( "fmt" "maps" "net/http" + "os" "sync" "time" ) @@ -29,6 +30,7 @@ type StatusResponse struct { Status string `json:"status"` Uptime string `json:"uptime"` Checks map[string]Check `json:"checks,omitempty"` + Pid int `json:"pid"` } func NewServer(host string, port int) *Server { @@ -112,6 +114,7 @@ func (s *Server) healthHandler(w http.ResponseWriter, r *http.Request) { resp := StatusResponse{ Status: "ok", Uptime: uptime.String(), + Pid: os.Getpid(), } json.NewEncoder(w).Encode(resp) From fcb69860c4807bbe1da4ef9144fc38fbcaf49fd9 Mon Sep 17 00:00:00 2001 From: wenjie <meetwenjie@gmail.com> Date: Tue, 17 Mar 2026 09:44:32 +0800 Subject: [PATCH 38/56] feat(web): add configurable cron command execution settings (#1647) - add tools.cron.allow_command config with a default value of true - require command_confirm only when cron command execution is disabled - expose cron command permission and timeout settings in the config UI - add backend tests and update i18n strings --- pkg/config/config.go | 5 +- pkg/config/config_test.go | 23 +++++++ pkg/config/defaults.go | 1 + pkg/tools/cron.go | 34 +++++++---- pkg/tools/cron_test.go | 61 +++++++++++++++++-- .../src/components/config/config-page.tsx | 12 ++++ .../src/components/config/config-sections.tsx | 36 +++++++++++ .../src/components/config/form-model.ts | 13 ++++ web/frontend/src/i18n/locales/en.json | 5 ++ web/frontend/src/i18n/locales/zh.json | 5 ++ 10 files changed, 174 insertions(+), 21 deletions(-) diff --git a/pkg/config/config.go b/pkg/config/config.go index 2937c36e4..ad5618907 100644 --- a/pkg/config/config.go +++ b/pkg/config/config.go @@ -699,8 +699,9 @@ type WebToolsConfig struct { } type CronToolsConfig struct { - ToolConfig ` envPrefix:"PICOCLAW_TOOLS_CRON_"` - ExecTimeoutMinutes int ` env:"PICOCLAW_TOOLS_CRON_EXEC_TIMEOUT_MINUTES" json:"exec_timeout_minutes"` // 0 means no timeout + ToolConfig ` envPrefix:"PICOCLAW_TOOLS_CRON_"` + ExecTimeoutMinutes int ` env:"PICOCLAW_TOOLS_CRON_EXEC_TIMEOUT_MINUTES" json:"exec_timeout_minutes"` // 0 means no timeout + AllowCommand bool ` env:"PICOCLAW_TOOLS_CRON_ALLOW_COMMAND" json:"allow_command"` } type ExecConfig struct { diff --git a/pkg/config/config_test.go b/pkg/config/config_test.go index 4c4dd9421..fc835f78f 100644 --- a/pkg/config/config_test.go +++ b/pkg/config/config_test.go @@ -405,6 +405,13 @@ func TestDefaultConfig_ExecAllowRemoteEnabled(t *testing.T) { } } +func TestDefaultConfig_CronAllowCommandEnabled(t *testing.T) { + cfg := DefaultConfig() + if !cfg.Tools.Cron.AllowCommand { + t.Fatal("DefaultConfig().Tools.Cron.AllowCommand should be true") + } +} + func TestLoadConfig_OpenAIWebSearchDefaultsTrueWhenUnset(t *testing.T) { dir := t.TempDir() configPath := filepath.Join(dir, "config.json") @@ -437,6 +444,22 @@ func TestLoadConfig_ExecAllowRemoteDefaultsTrueWhenUnset(t *testing.T) { } } +func TestLoadConfig_CronAllowCommandDefaultsTrueWhenUnset(t *testing.T) { + dir := t.TempDir() + configPath := filepath.Join(dir, "config.json") + if err := os.WriteFile(configPath, []byte(`{"tools":{"cron":{"exec_timeout_minutes":5}}}`), 0o600); err != nil { + t.Fatalf("WriteFile() error: %v", err) + } + + cfg, err := LoadConfig(configPath) + if err != nil { + t.Fatalf("LoadConfig() error: %v", err) + } + if !cfg.Tools.Cron.AllowCommand { + t.Fatal("tools.cron.allow_command should remain true when unset in config file") + } +} + func TestLoadConfig_OpenAIWebSearchCanBeDisabled(t *testing.T) { dir := t.TempDir() configPath := filepath.Join(dir, "config.json") diff --git a/pkg/config/defaults.go b/pkg/config/defaults.go index dc534d852..a029eeb59 100644 --- a/pkg/config/defaults.go +++ b/pkg/config/defaults.go @@ -452,6 +452,7 @@ func DefaultConfig() *Config { Enabled: true, }, ExecTimeoutMinutes: 5, + AllowCommand: true, }, Exec: ExecConfig{ ToolConfig: ToolConfig{ diff --git a/pkg/tools/cron.go b/pkg/tools/cron.go index 25608a54c..aa22f9aa6 100644 --- a/pkg/tools/cron.go +++ b/pkg/tools/cron.go @@ -20,10 +20,11 @@ type JobExecutor interface { // CronTool provides scheduling capabilities for the agent type CronTool struct { - cronService *cron.CronService - executor JobExecutor - msgBus *bus.MessageBus - execTool *ExecTool + cronService *cron.CronService + executor JobExecutor + msgBus *bus.MessageBus + execTool *ExecTool + allowCommand bool } // NewCronTool creates a new CronTool @@ -37,12 +38,18 @@ func NewCronTool( return nil, fmt.Errorf("unable to configure exec tool: %w", err) } + allowCommand := true + if config != nil { + allowCommand = config.Tools.Cron.AllowCommand + } + execTool.SetTimeout(execTimeout) return &CronTool{ - cronService: cronService, - executor: executor, - msgBus: msgBus, - execTool: execTool, + cronService: cronService, + executor: executor, + msgBus: msgBus, + execTool: execTool, + allowCommand: allowCommand, }, nil } @@ -76,7 +83,7 @@ func (t *CronTool) Parameters() map[string]any { }, "command_confirm": map[string]any{ "type": "boolean", - "description": "Required when using command=true. Must be true to explicitly confirm scheduling a shell command.", + "description": "Optional explicit confirmation flag for scheduling a shell command. Command execution must also be enabled via tools.cron.allow_command.", }, "at_seconds": map[string]any{ "type": "integer", @@ -180,16 +187,17 @@ func (t *CronTool) addJob(ctx context.Context, args map[string]any) *ToolResult deliver = d } - // GHSA-pv8c-p6jf-3fpp: command scheduling requires internal channel + explicit confirm. - // Non-command reminders (plain messages) remain open to all channels. + // GHSA-pv8c-p6jf-3fpp: command scheduling requires internal channel. When + // allow_command is disabled, explicit confirmation is required as an override. + // Non-command reminders remain open to all channels. command, _ := args["command"].(string) commandConfirm, _ := args["command_confirm"].(bool) if command != "" { if !constants.IsInternalChannel(channel) { return ErrorResult("scheduling command execution is restricted to internal channels") } - if !commandConfirm { - return ErrorResult("command_confirm=true is required to schedule command execution") + if !t.allowCommand && !commandConfirm { + return ErrorResult("command_confirm=true is required when allow_command is disabled") } deliver = false } diff --git a/pkg/tools/cron_test.go b/pkg/tools/cron_test.go index f1e857949..e46b13b13 100644 --- a/pkg/tools/cron_test.go +++ b/pkg/tools/cron_test.go @@ -11,12 +11,11 @@ import ( "github.com/sipeed/picoclaw/pkg/cron" ) -func newTestCronTool(t *testing.T) *CronTool { +func newTestCronToolWithConfig(t *testing.T, cfg *config.Config) *CronTool { t.Helper() storePath := filepath.Join(t.TempDir(), "cron.json") cronService := cron.NewCronService(storePath, nil) msgBus := bus.NewMessageBus() - cfg := config.DefaultConfig() tool, err := NewCronTool(cronService, nil, msgBus, t.TempDir(), true, 0, cfg) if err != nil { t.Fatalf("NewCronTool() error: %v", err) @@ -24,6 +23,11 @@ func newTestCronTool(t *testing.T) *CronTool { return tool } +func newTestCronTool(t *testing.T) *CronTool { + t.Helper() + return newTestCronToolWithConfig(t, config.DefaultConfig()) +} + // TestCronTool_CommandBlockedFromRemoteChannel verifies command scheduling is restricted to internal channels func TestCronTool_CommandBlockedFromRemoteChannel(t *testing.T) { tool := newTestCronTool(t) @@ -44,8 +48,7 @@ func TestCronTool_CommandBlockedFromRemoteChannel(t *testing.T) { } } -// TestCronTool_CommandRequiresConfirm verifies command_confirm=true is required -func TestCronTool_CommandRequiresConfirm(t *testing.T) { +func TestCronTool_CommandDoesNotRequireConfirmByDefault(t *testing.T) { tool := newTestCronTool(t) ctx := WithToolContext(context.Background(), "cli", "direct") result := tool.Execute(ctx, map[string]any{ @@ -55,11 +58,57 @@ func TestCronTool_CommandRequiresConfirm(t *testing.T) { "at_seconds": float64(60), }) + if result.IsError { + t.Fatalf("expected command scheduling without confirm to succeed by default, got: %s", result.ForLLM) + } + if !strings.Contains(result.ForLLM, "Cron job added") { + t.Errorf("expected 'Cron job added', got: %s", result.ForLLM) + } +} + +func TestCronTool_CommandRequiresConfirmWhenAllowCommandDisabled(t *testing.T) { + cfg := config.DefaultConfig() + cfg.Tools.Cron.AllowCommand = false + + tool := newTestCronToolWithConfig(t, cfg) + ctx := WithToolContext(context.Background(), "cli", "direct") + result := tool.Execute(ctx, map[string]any{ + "action": "add", + "message": "check disk", + "command": "df -h", + "at_seconds": float64(60), + }) + if !result.IsError { - t.Fatal("expected error when command_confirm is missing") + t.Fatal("expected command scheduling to require confirm when allow_command is disabled") } if !strings.Contains(result.ForLLM, "command_confirm=true") { - t.Errorf("expected 'command_confirm=true' message, got: %s", result.ForLLM) + t.Errorf("expected command_confirm requirement message, got: %s", result.ForLLM) + } +} + +func TestCronTool_CommandAllowedWithConfirmWhenAllowCommandDisabled(t *testing.T) { + cfg := config.DefaultConfig() + cfg.Tools.Cron.AllowCommand = false + + tool := newTestCronToolWithConfig(t, cfg) + ctx := WithToolContext(context.Background(), "cli", "direct") + result := tool.Execute(ctx, map[string]any{ + "action": "add", + "message": "check disk", + "command": "df -h", + "command_confirm": true, + "at_seconds": float64(60), + }) + + if result.IsError { + t.Fatalf( + "expected command scheduling with confirm to succeed when allow_command is disabled, got: %s", + result.ForLLM, + ) + } + if !strings.Contains(result.ForLLM, "Cron job added") { + t.Errorf("expected 'Cron job added', got: %s", result.ForLLM) } } diff --git a/web/frontend/src/components/config/config-page.tsx b/web/frontend/src/components/config/config-page.tsx index cbce7d27e..130498ba4 100644 --- a/web/frontend/src/components/config/config-page.tsx +++ b/web/frontend/src/components/config/config-page.tsx @@ -14,6 +14,7 @@ import { } from "@/api/system" import { AgentDefaultsSection, + CronSection, DevicesSection, LauncherSection, RuntimeSection, @@ -164,6 +165,11 @@ export function ConfigPage() { "Heartbeat interval", { min: 1 }, ) + const cronExecTimeoutMinutes = parseIntField( + form.cronExecTimeoutMinutes, + "Cron exec timeout", + { min: 0 }, + ) await patchAppConfig({ agents: { @@ -180,6 +186,10 @@ export function ConfigPage() { dm_scope: dmScope, }, tools: { + cron: { + allow_command: form.allowCommand, + exec_timeout_minutes: cronExecTimeoutMinutes, + }, exec: { allow_remote: form.allowRemote, }, @@ -279,6 +289,8 @@ export function ConfigPage() { <RuntimeSection form={form} onFieldChange={updateField} /> + <CronSection form={form} onFieldChange={updateField} /> + <LauncherSection launcherForm={launcherForm} onFieldChange={updateLauncherField} diff --git a/web/frontend/src/components/config/config-sections.tsx b/web/frontend/src/components/config/config-sections.tsx index dfbe22fc3..04b9e528b 100644 --- a/web/frontend/src/components/config/config-sections.tsx +++ b/web/frontend/src/components/config/config-sections.tsx @@ -236,6 +236,42 @@ export function RuntimeSection({ form, onFieldChange }: RuntimeSectionProps) { ) } +interface CronSectionProps { + form: CoreConfigForm + onFieldChange: UpdateCoreField +} + +export function CronSection({ form, onFieldChange }: CronSectionProps) { + const { t } = useTranslation() + + return ( + <ConfigSectionCard title={t("pages.config.sections.cron")}> + <SwitchCardField + label={t("pages.config.allow_shell_execution")} + hint={t("pages.config.allow_shell_execution_hint")} + layout="setting-row" + checked={form.allowCommand} + onCheckedChange={(checked) => onFieldChange("allowCommand", checked)} + /> + + <Field + label={t("pages.config.cron_exec_timeout")} + hint={t("pages.config.cron_exec_timeout_hint")} + layout="setting-row" + > + <Input + type="number" + min={0} + value={form.cronExecTimeoutMinutes} + onChange={(e) => + onFieldChange("cronExecTimeoutMinutes", e.target.value) + } + /> + </Field> + </ConfigSectionCard> + ) +} + interface LauncherSectionProps { launcherForm: LauncherForm onFieldChange: UpdateLauncherField diff --git a/web/frontend/src/components/config/form-model.ts b/web/frontend/src/components/config/form-model.ts index d868c4bb4..8c850b2c4 100644 --- a/web/frontend/src/components/config/form-model.ts +++ b/web/frontend/src/components/config/form-model.ts @@ -4,6 +4,8 @@ export interface CoreConfigForm { workspace: string restrictToWorkspace: boolean allowRemote: boolean + allowCommand: boolean + cronExecTimeoutMinutes: string maxTokens: string maxToolIterations: string summarizeMessageThreshold: string @@ -56,6 +58,8 @@ export const EMPTY_FORM: CoreConfigForm = { workspace: "", restrictToWorkspace: true, allowRemote: true, + allowCommand: true, + cronExecTimeoutMinutes: "5", maxTokens: "32768", maxToolIterations: "50", summarizeMessageThreshold: "20", @@ -106,6 +110,7 @@ export function buildFormFromConfig(config: unknown): CoreConfigForm { const heartbeat = asRecord(root.heartbeat) const devices = asRecord(root.devices) const tools = asRecord(root.tools) + const cron = asRecord(tools.cron) const exec = asRecord(tools.exec) return { @@ -118,6 +123,14 @@ export function buildFormFromConfig(config: unknown): CoreConfigForm { exec.allow_remote === undefined ? EMPTY_FORM.allowRemote : asBool(exec.allow_remote), + allowCommand: + cron.allow_command === undefined + ? EMPTY_FORM.allowCommand + : asBool(cron.allow_command), + cronExecTimeoutMinutes: asNumberString( + cron.exec_timeout_minutes, + EMPTY_FORM.cronExecTimeoutMinutes, + ), maxTokens: asNumberString(defaults.max_tokens, EMPTY_FORM.maxTokens), maxToolIterations: asNumberString( defaults.max_tool_iterations, diff --git a/web/frontend/src/i18n/locales/en.json b/web/frontend/src/i18n/locales/en.json index b099dec13..2fa32ebb5 100644 --- a/web/frontend/src/i18n/locales/en.json +++ b/web/frontend/src/i18n/locales/en.json @@ -394,6 +394,10 @@ "restrict_workspace_hint": "Only allow file operations inside workspace.", "allow_remote": "Allow Remote Shell Execution", "allow_remote_hint": "When enabled, shell commands can also run for remote sessions or non-local contexts. When disabled, shell execution stays limited to local safe contexts.", + "allow_shell_execution": "Allow Shell Execution", + "allow_shell_execution_hint": "Enable scheduled shell commands for cron jobs by default. When disabled, users must pass command_confirm=true to schedule a cron command.", + "cron_exec_timeout": "Cron Command Timeout (minutes)", + "cron_exec_timeout_hint": "Maximum runtime for scheduled shell commands. Set to 0 to disable the timeout.", "max_tokens": "Max Tokens", "max_tokens_hint": "Upper token limit per model response.", "max_tool_iterations": "Max Tool Iterations", @@ -434,6 +438,7 @@ "sections": { "agent": "Agent", "runtime": "Runtime", + "cron": "Cron Tasks", "launcher": "Service", "devices": "Devices" }, diff --git a/web/frontend/src/i18n/locales/zh.json b/web/frontend/src/i18n/locales/zh.json index 78093e5c7..badf5bb3d 100644 --- a/web/frontend/src/i18n/locales/zh.json +++ b/web/frontend/src/i18n/locales/zh.json @@ -394,6 +394,10 @@ "restrict_workspace_hint": "仅允许在工作目录内执行文件操作。", "allow_remote": "允许远程执行 Shell 命令", "allow_remote_hint": "开启后,来自远程会话或非本地上下文的请求也可以执行 shell 命令;关闭后,仅允许本地安全上下文执行。", + "allow_shell_execution": "允许 Shell 执行", + "allow_shell_execution_hint": "开启后,cron 定时任务默认允许执行 shell 命令。关闭后,必须显式传入 command_confirm=true 才能创建 cron 命令任务。", + "cron_exec_timeout": "定时命令超时(分钟)", + "cron_exec_timeout_hint": "定时 shell 命令的最长执行时间。设置为 0 表示不限制超时。", "max_tokens": "最大 Token 数", "max_tokens_hint": "单次模型响应允许的最大 Token 数。", "max_tool_iterations": "最大工具迭代次数", @@ -434,6 +438,7 @@ "sections": { "agent": "智能体", "runtime": "运行时", + "cron": "定时任务", "launcher": "服务参数", "devices": "设备" }, From 8d97896a0dfc485b6a8400d80b2859f852421aa3 Mon Sep 17 00:00:00 2001 From: Zane Tung <zanetung13@gmail.com> Date: Tue, 17 Mar 2026 11:52:58 +0800 Subject: [PATCH 39/56] fix(providers): handle nil input in GLM series tool_use blocks - add defensive nil check for tool call Arguments field - replace nil input with empty object to comply with Anthropic spec - prevent API errors when GLM models return null input in tool_use blocks Zhipu AI's GLM series models may return tool_use blocks with null input field, which causes their API to reject subsequent requests with error: "ClaudeContentBlockToolResult object has no attribute id" This fix ensures compatibility by converting nil inputs to empty objects {}, matching the Anthropic Messages API specification while maintaining backward compatibility with other providers. --- pkg/providers/anthropic_messages/provider.go | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/pkg/providers/anthropic_messages/provider.go b/pkg/providers/anthropic_messages/provider.go index 8a83a7058..c201dfe00 100644 --- a/pkg/providers/anthropic_messages/provider.go +++ b/pkg/providers/anthropic_messages/provider.go @@ -221,11 +221,17 @@ func buildRequestBody( // Add tool_use blocks for _, tc := range msg.ToolCalls { + // Handle nil Arguments (GLM-4 may return null input) + input := tc.Arguments + if input == nil { + input = map[string]any{} + } + toolUse := map[string]any{ "type": "tool_use", "id": tc.ID, "name": tc.Name, - "input": tc.Arguments, + "input": input, } content = append(content, toolUse) } From cef0f28881169fa52d9eadd8414e0cc3f2f18607 Mon Sep 17 00:00:00 2001 From: wenjie <meetwenjie@gmail.com> Date: Tue, 17 Mar 2026 14:10:11 +0800 Subject: [PATCH 40/56] fix(tools): normalize whitelist path checks for symlinked allowed roots (#1660) - keep regex whitelist matching for existing configs - add normalized directory-prefix checks for literal allow-path patterns - support allowed roots that resolve through symlinks - add regression coverage for symlink-backed whitelist paths --- pkg/tools/filesystem.go | 105 ++++++++++++++++++++++++++++++++++- pkg/tools/filesystem_test.go | 35 ++++++++++++ 2 files changed, 138 insertions(+), 2 deletions(-) diff --git a/pkg/tools/filesystem.go b/pkg/tools/filesystem.go index 92946ef98..ae356f248 100644 --- a/pkg/tools/filesystem.go +++ b/pkg/tools/filesystem.go @@ -98,14 +98,115 @@ func isAllowedPath(path string, patterns []*regexp.Regexp) bool { } func matchesAllowedPath(path string, patterns []*regexp.Regexp) bool { + cleaned := filepath.Clean(path) for _, pattern := range patterns { - if pattern.MatchString(path) { + if pattern.MatchString(cleaned) { + return true + } + if root, ok := extractAllowedPathRoot(pattern); ok && isWithinAllowedRoot(cleaned, root) { return true } } return false } +func extractAllowedPathRoot(pattern *regexp.Regexp) (string, bool) { + raw := pattern.String() + if !strings.HasPrefix(raw, "^") { + return "", false + } + + literal := strings.TrimPrefix(raw, "^") + + // Recognize the common "directory prefix" form: ^<literal>(?:/|$) + literal = strings.TrimSuffix(literal, "(?:/|$)") + literal = strings.TrimSuffix(literal, `(?:\\|$)`) + + // Reject patterns that still contain regex operators after removing the + // optional anchored-directory suffix. That keeps arbitrary regex behavior + // unchanged and only enables normalized prefix matching for literal paths. + if containsUnescapedRegexMeta(literal) { + return "", false + } + + unescaped, ok := unescapeRegexLiteral(literal) + if !ok || unescaped == "" { + return "", false + } + + return filepath.Clean(unescaped), filepath.IsAbs(unescaped) +} + +func appendUniquePath(paths []string, path string) []string { + for _, existing := range paths { + if existing == path { + return paths + } + } + return append(paths, path) +} + +func containsUnescapedRegexMeta(s string) bool { + escaped := false + for _, r := range s { + if escaped { + escaped = false + continue + } + if r == '\\' { + escaped = true + continue + } + switch r { + case '.', '+', '*', '?', '(', ')', '[', ']', '{', '}', '|': + return true + } + } + return escaped +} + +func unescapeRegexLiteral(s string) (string, bool) { + var b strings.Builder + b.Grow(len(s)) + + escaped := false + for _, r := range s { + if escaped { + b.WriteRune(r) + escaped = false + continue + } + if r == '\\' { + escaped = true + continue + } + b.WriteRune(r) + } + + if escaped { + return "", false + } + + return b.String(), true +} + +func isWithinAllowedRoot(path, root string) bool { + candidate := filepath.Clean(path) + allowedVariants := []string{filepath.Clean(root)} + + if resolvedRoot, err := resolvePathAgainstExistingAncestor(root); err == nil { + allowedVariants = appendUniquePath(allowedVariants, filepath.Clean(resolvedRoot)) + } + + for _, allowedRoot := range allowedVariants { + if isWithinWorkspace(candidate, allowedRoot) { + return true + } + } + + return false +} + func resolveExistingAncestor(path string) (string, error) { for current := filepath.Clean(path); ; current = filepath.Dir(current) { if resolved, err := filepath.EvalSymlinks(current); err == nil { @@ -144,7 +245,7 @@ func resolvePathAgainstExistingAncestor(path string) (string, error) { func isWithinWorkspace(candidate, workspace string) bool { rel, err := filepath.Rel(filepath.Clean(workspace), filepath.Clean(candidate)) - return err == nil && filepath.IsLocal(rel) + return err == nil && (rel == "." || filepath.IsLocal(rel)) } type ReadFileTool struct { diff --git a/pkg/tools/filesystem_test.go b/pkg/tools/filesystem_test.go index 78d69273f..5ebf38df2 100644 --- a/pkg/tools/filesystem_test.go +++ b/pkg/tools/filesystem_test.go @@ -570,6 +570,41 @@ func TestWhitelistFs_WriteAllowsNewFileUnderAllowedDir(t *testing.T) { } } +func TestWhitelistFs_AllowsResolvedAllowedRootAlias(t *testing.T) { + workspace := t.TempDir() + realDir := t.TempDir() + linkParent := t.TempDir() + allowedAlias := filepath.Join(linkParent, "allowed-link") + + if err := os.Symlink(realDir, allowedAlias); err != nil { + t.Skipf("symlink not supported in this environment: %v", err) + } + + targetFile := filepath.Join(allowedAlias, "nested", "alias.txt") + if err := os.MkdirAll(filepath.Dir(targetFile), 0o755); err != nil { + t.Fatalf("MkdirAll(targetFile dir) error = %v", err) + } + if err := os.WriteFile(targetFile, []byte("through alias"), 0o644); err != nil { + t.Fatalf("WriteFile(targetFile) error = %v", err) + } + + patterns := []*regexp.Regexp{ + regexp.MustCompile( + "^" + regexp.QuoteMeta(filepath.Clean(allowedAlias)) + + "(?:" + regexp.QuoteMeta(string(os.PathSeparator)) + "|$)", + ), + } + tool := NewReadFileTool(workspace, true, MaxReadFileSize, patterns) + + result := tool.Execute(context.Background(), map[string]any{"path": targetFile}) + if result.IsError { + t.Fatalf("expected symlink-backed allowed root to be readable, got: %s", result.ForLLM) + } + if !strings.Contains(result.ForLLM, "through alias") { + t.Fatalf("expected file content, got: %s", result.ForLLM) + } +} + // TestReadFileTool_ChunkedReading verifies the pagination logic of the tool // by reading a file in multiple chunks using 'offset' and 'length'. func TestReadFileTool_ChunkedReading(t *testing.T) { From e41423483e46aa8fb506bbe1c9b4bf735ff39c4d Mon Sep 17 00:00:00 2001 From: Cytown <cytown@gmail.com> Date: Tue, 17 Mar 2026 14:12:32 +0800 Subject: [PATCH 41/56] add systray ui for all platform (#1649) * add systray ui for all platform * update from getlantern/systray to fyne.io/systray for fix test --- Makefile | 53 ++--- go.mod | 6 +- go.sum | 4 + pkg/agent/instance_test.go | 2 +- web/Makefile | 62 +++++- web/backend/api/events.go | 21 +- web/backend/api/gateway.go | 373 +++++++++++++++++++++----------- web/backend/api/gateway_test.go | 54 ----- web/backend/api/router.go | 5 + web/backend/i18n.go | 120 ++++++++++ web/backend/icon.png | Bin 0 -> 104580 bytes web/backend/main.go | 56 +++-- web/backend/systray.go | 133 ++++++++++++ web/backend/systray_unix.go | 8 + web/backend/systray_windows.go | 8 + 15 files changed, 674 insertions(+), 231 deletions(-) create mode 100644 web/backend/i18n.go create mode 100644 web/backend/icon.png create mode 100644 web/backend/systray.go create mode 100644 web/backend/systray_unix.go create mode 100644 web/backend/systray_windows.go diff --git a/Makefile b/Makefile index 2f673d3b9..4f4a7a6cb 100644 --- a/Makefile +++ b/Makefile @@ -12,7 +12,7 @@ GIT_COMMIT=$(shell git rev-parse --short=8 HEAD 2>/dev/null || echo "dev") BUILD_TIME=$(shell date +%FT%T%z) GO_VERSION=$(shell $(GO) version | awk '{print $$3}') CONFIG_PKG=github.com/sipeed/picoclaw/pkg/config -LDFLAGS=-ldflags "-X $(CONFIG_PKG).Version=$(VERSION) -X $(CONFIG_PKG).GitCommit=$(GIT_COMMIT) -X $(CONFIG_PKG).BuildTime=$(BUILD_TIME) -X $(CONFIG_PKG).GoVersion=$(GO_VERSION) -s -w" +LDFLAGS=-X $(CONFIG_PKG).Version=$(VERSION) -X $(CONFIG_PKG).GitCommit=$(GIT_COMMIT) -X $(CONFIG_PKG).BuildTime=$(BUILD_TIME) -X $(CONFIG_PKG).GoVersion=$(GO_VERSION) -s -w # Go variables GO?=CGO_ENABLED=0 go @@ -107,7 +107,7 @@ generate: build: generate @echo "Building $(BINARY_NAME) for $(PLATFORM)/$(ARCH)..." @mkdir -p $(BUILD_DIR) - @$(GO) build $(GOFLAGS) $(LDFLAGS) -o $(BINARY_PATH) ./$(CMD_DIR) + @$(GO) build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o $(BINARY_PATH) ./$(CMD_DIR) @echo "Build complete: $(BINARY_PATH)" @ln -sf $(BINARY_NAME)-$(PLATFORM)-$(ARCH) $(BUILD_DIR)/$(BINARY_NAME) @@ -128,16 +128,16 @@ build-whatsapp-native: generate ## @echo "Building $(BINARY_NAME) with WhatsApp native for $(PLATFORM)/$(ARCH)..." @echo "Building for multiple platforms..." @mkdir -p $(BUILD_DIR) - GOOS=linux GOARCH=amd64 $(GO) build -tags whatsapp_native $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-linux-amd64 ./$(CMD_DIR) - GOOS=linux GOARCH=arm GOARM=7 $(GO) build -tags whatsapp_native $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-linux-arm ./$(CMD_DIR) - GOOS=linux GOARCH=arm64 $(GO) build -tags whatsapp_native $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-linux-arm64 ./$(CMD_DIR) - GOOS=linux GOARCH=loong64 $(GO) build -tags whatsapp_native $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-linux-loong64 ./$(CMD_DIR) - GOOS=linux GOARCH=riscv64 $(GO) build -tags whatsapp_native $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-linux-riscv64 ./$(CMD_DIR) - GOOS=linux GOARCH=mipsle GOMIPS=softfloat $(GO) build -tags whatsapp_native $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-linux-mipsle ./$(CMD_DIR) + GOOS=linux GOARCH=amd64 $(GO) build -tags whatsapp_native -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-linux-amd64 ./$(CMD_DIR) + GOOS=linux GOARCH=arm GOARM=7 $(GO) build -tags whatsapp_native -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-linux-arm ./$(CMD_DIR) + GOOS=linux GOARCH=arm64 $(GO) build -tags whatsapp_native -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-linux-arm64 ./$(CMD_DIR) + GOOS=linux GOARCH=loong64 $(GO) build -tags whatsapp_native -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-linux-loong64 ./$(CMD_DIR) + GOOS=linux GOARCH=riscv64 $(GO) build -tags whatsapp_native -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-linux-riscv64 ./$(CMD_DIR) + GOOS=linux GOARCH=mipsle GOMIPS=softfloat $(GO) build -tags whatsapp_native -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-linux-mipsle ./$(CMD_DIR) $(call PATCH_MIPS_FLAGS,$(BUILD_DIR)/$(BINARY_NAME)-linux-mipsle) - GOOS=darwin GOARCH=arm64 $(GO) build -tags whatsapp_native $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-darwin-arm64 ./$(CMD_DIR) - GOOS=windows GOARCH=amd64 $(GO) build -tags whatsapp_native $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-windows-amd64.exe ./$(CMD_DIR) -## @$(GO) build $(GOFLAGS) -tags whatsapp_native $(LDFLAGS) -o $(BINARY_PATH) ./$(CMD_DIR) + GOOS=darwin GOARCH=arm64 $(GO) build -tags whatsapp_native -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-darwin-arm64 ./$(CMD_DIR) + GOOS=windows GOARCH=amd64 $(GO) build -tags whatsapp_native -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-windows-amd64.exe ./$(CMD_DIR) +## @$(GO) build $(GOFLAGS) -tags whatsapp_native -ldflags "$(LDFLAGS)" -o $(BINARY_PATH) ./$(CMD_DIR) @echo "Build complete" ## @ln -sf $(BINARY_NAME)-$(PLATFORM)-$(ARCH) $(BUILD_DIR)/$(BINARY_NAME) @@ -145,21 +145,21 @@ build-whatsapp-native: generate build-linux-arm: generate @echo "Building for linux/arm (GOARM=7)..." @mkdir -p $(BUILD_DIR) - GOOS=linux GOARCH=arm GOARM=7 $(GO) build $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-linux-arm ./$(CMD_DIR) + GOOS=linux GOARCH=arm GOARM=7 $(GO) build -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-linux-arm ./$(CMD_DIR) @echo "Build complete: $(BUILD_DIR)/$(BINARY_NAME)-linux-arm" ## build-linux-arm64: Build for Linux ARM64 (e.g. Raspberry Pi Zero 2 W 64-bit) build-linux-arm64: generate @echo "Building for linux/arm64..." @mkdir -p $(BUILD_DIR) - GOOS=linux GOARCH=arm64 $(GO) build $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-linux-arm64 ./$(CMD_DIR) + GOOS=linux GOARCH=arm64 $(GO) build -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-linux-arm64 ./$(CMD_DIR) @echo "Build complete: $(BUILD_DIR)/$(BINARY_NAME)-linux-arm64" ## build-linux-mipsle: Build for Linux MIPS32 LE build-linux-mipsle: generate @echo "Building for linux/mipsle (softfloat)..." @mkdir -p $(BUILD_DIR) - GOOS=linux GOARCH=mipsle GOMIPS=softfloat $(GO) build $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-linux-mipsle ./$(CMD_DIR) + GOOS=linux GOARCH=mipsle GOMIPS=softfloat $(GO) build -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-linux-mipsle ./$(CMD_DIR) $(call PATCH_MIPS_FLAGS,$(BUILD_DIR)/$(BINARY_NAME)-linux-mipsle) @echo "Build complete: $(BUILD_DIR)/$(BINARY_NAME)-linux-mipsle" @@ -171,18 +171,18 @@ build-pi-zero: build-linux-arm build-linux-arm64 build-all: generate @echo "Building for multiple platforms..." @mkdir -p $(BUILD_DIR) - GOOS=linux GOARCH=amd64 $(GO) build $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-linux-amd64 ./$(CMD_DIR) - GOOS=linux GOARCH=arm GOARM=7 $(GO) build $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-linux-arm ./$(CMD_DIR) - GOOS=linux GOARCH=arm64 $(GO) build $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-linux-arm64 ./$(CMD_DIR) - GOOS=linux GOARCH=loong64 $(GO) build $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-linux-loong64 ./$(CMD_DIR) - GOOS=linux GOARCH=riscv64 $(GO) build $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-linux-riscv64 ./$(CMD_DIR) - GOOS=linux GOARCH=mipsle GOMIPS=softfloat $(GO) build $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-linux-mipsle ./$(CMD_DIR) + GOOS=linux GOARCH=amd64 $(GO) build -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-linux-amd64 ./$(CMD_DIR) + GOOS=linux GOARCH=arm GOARM=7 $(GO) build -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-linux-arm ./$(CMD_DIR) + GOOS=linux GOARCH=arm64 $(GO) build -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-linux-arm64 ./$(CMD_DIR) + GOOS=linux GOARCH=loong64 $(GO) build -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-linux-loong64 ./$(CMD_DIR) + GOOS=linux GOARCH=riscv64 $(GO) build -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-linux-riscv64 ./$(CMD_DIR) + GOOS=linux GOARCH=mipsle GOMIPS=softfloat $(GO) build -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-linux-mipsle ./$(CMD_DIR) $(call PATCH_MIPS_FLAGS,$(BUILD_DIR)/$(BINARY_NAME)-linux-mipsle) - GOOS=linux GOARCH=arm GOARM=7 $(GO) build $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-linux-armv7 ./$(CMD_DIR) - GOOS=darwin GOARCH=arm64 $(GO) build $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-darwin-arm64 ./$(CMD_DIR) - GOOS=windows GOARCH=amd64 $(GO) build $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-windows-amd64.exe ./$(CMD_DIR) - GOOS=netbsd GOARCH=amd64 $(GO) build $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-netbsd-amd64 ./$(CMD_DIR) - GOOS=netbsd GOARCH=arm64 $(GO) build $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-netbsd-arm64 ./$(CMD_DIR) + GOOS=linux GOARCH=arm GOARM=7 $(GO) build -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-linux-armv7 ./$(CMD_DIR) + GOOS=darwin GOARCH=arm64 $(GO) build -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-darwin-arm64 ./$(CMD_DIR) + GOOS=windows GOARCH=amd64 $(GO) build -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-windows-amd64.exe ./$(CMD_DIR) + GOOS=netbsd GOARCH=amd64 $(GO) build -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-netbsd-amd64 ./$(CMD_DIR) + GOOS=netbsd GOARCH=arm64 $(GO) build -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-netbsd-arm64 ./$(CMD_DIR) @echo "All builds complete" ## install: Install picoclaw to system and copy builtin skills @@ -223,7 +223,8 @@ vet: generate ## test: Test Go code test: generate - @$(GO) test ./... + @$(GO) test $$(go list ./... | grep -v github.com/sipeed/picoclaw/web/) + @cd web && make test ## fmt: Format Go code fmt: diff --git a/go.mod b/go.mod index 130db73ff..4442b28fe 100644 --- a/go.mod +++ b/go.mod @@ -3,6 +3,7 @@ module github.com/sipeed/picoclaw go 1.25.7 require ( + fyne.io/systray v1.12.0 github.com/adhocore/gronx v1.19.6 github.com/anthropics/anthropic-sdk-go v1.26.0 github.com/bwmarrin/discordgo v0.29.0 @@ -28,6 +29,7 @@ require ( github.com/tencent-connect/botgo v0.2.1 go.mau.fi/whatsmeow v0.0.0-20260219150138-7ae702b1eed4 golang.org/x/oauth2 v0.36.0 + golang.org/x/term v0.40.0 golang.org/x/time v0.14.0 google.golang.org/protobuf v1.36.11 gopkg.in/yaml.v3 v3.0.1 @@ -43,6 +45,7 @@ require ( github.com/dustin/go-humanize v1.0.1 // indirect github.com/elliotchance/orderedmap/v3 v3.1.0 // indirect github.com/gdamore/encoding v1.0.1 // indirect + github.com/godbus/dbus/v5 v5.1.0 // indirect github.com/inconshreveable/mousetrap v1.1.0 // indirect github.com/lucasb-eyer/go-colorful v1.3.0 // indirect github.com/mattn/go-colorable v0.1.14 // indirect @@ -59,7 +62,6 @@ require ( go.mau.fi/libsignal v0.2.1 // indirect go.mau.fi/util v0.9.6 // indirect golang.org/x/exp v0.0.0-20260212183809-81e46e3db34a // indirect - golang.org/x/term v0.40.0 // indirect golang.org/x/text v0.34.0 // indirect modernc.org/libc v1.67.6 // indirect modernc.org/mathutil v1.7.1 // indirect @@ -90,7 +92,7 @@ require ( github.com/valyala/fastjson v1.6.10 // indirect github.com/yosida95/uritemplate/v3 v3.0.2 // indirect golang.org/x/arch v0.24.0 // indirect - golang.org/x/crypto v0.48.0 // indirect + golang.org/x/crypto v0.48.0 golang.org/x/net v0.51.0 // indirect golang.org/x/sync v0.19.0 // indirect golang.org/x/sys v0.41.0 // indirect diff --git a/go.sum b/go.sum index a4d8ed3d0..f0e3fc132 100644 --- a/go.sum +++ b/go.sum @@ -1,6 +1,8 @@ cloud.google.com/go/compute/metadata v0.3.0/go.mod h1:zFmK7XCadkQkj6TtorcaGlCW1hT1fIilQDwofLpJ20k= filippo.io/edwards25519 v1.1.1 h1:YpjwWWlNmGIDyXOn8zLzqiD+9TyIlPhGFG96P39uBpw= filippo.io/edwards25519 v1.1.1/go.mod h1:BxyFTGdWcka3PhytdK4V28tE5sGfRvvvRV7EaN4VDT4= +fyne.io/systray v1.12.0 h1:CA1Kk0e2zwFlxtc02L3QFSiIbxJ/P0n582YrZHT7aTM= +fyne.io/systray v1.12.0/go.mod h1:RVwqP9nYMo7h5zViCBHri2FgjXF7H2cub7MAq4NSoLs= 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= @@ -64,6 +66,8 @@ github.com/go-task/slim-sprig v0.0.0-20210107165309-348f09dbbbc0/go.mod h1:fyg78 github.com/go-test/deep v1.1.1 h1:0r/53hagsehfO4bzD2Pgr/+RgHqhmf+k1Bpse2cTu1U= github.com/go-test/deep v1.1.1/go.mod h1:5C2ZWiW0ErCdrYzpqxLbTX7MG14M9iiw8DgHncVwcsE= github.com/godbus/dbus/v5 v5.0.4/go.mod h1:xhWf0FNVPg57R7Z0UbKHbJfkEywrmjJnf7w5xrFpKfA= +github.com/godbus/dbus/v5 v5.1.0 h1:4KLkAxT3aOY8Li4FRJe/KvhoNFFxo0m6fNuFUO8QJUk= +github.com/godbus/dbus/v5 v5.1.0/go.mod h1:xhWf0FNVPg57R7Z0UbKHbJfkEywrmjJnf7w5xrFpKfA= github.com/gogo/protobuf v1.3.2 h1:Ov1cvc58UF3b5XjBnZv7+opcTcQFZebYjWzi34vdm4Q= github.com/gogo/protobuf v1.3.2/go.mod h1:P1XiOD3dCwIKUDQYPy72D8LYyHL2YPYrpS2s69NZV8Q= github.com/golang-jwt/jwt/v5 v5.2.2 h1:Rl4B7itRWVtYIHFrSNd7vhTiz9UpLdi6gZhZ3wEeDy8= diff --git a/pkg/agent/instance_test.go b/pkg/agent/instance_test.go index f8057bb2f..5a13c8f1b 100644 --- a/pkg/agent/instance_test.go +++ b/pkg/agent/instance_test.go @@ -190,7 +190,7 @@ func TestNewAgentInstance_AllowsMediaTempDirForReadListAndExec(t *testing.T) { Agents: config.AgentsConfig{ Defaults: config.AgentDefaults{ Workspace: workspace, - Model: "test-model", + ModelName: "test-model", RestrictToWorkspace: true, }, }, diff --git a/web/Makefile b/web/Makefile index 559005956..653dd77e1 100644 --- a/web/Makefile +++ b/web/Makefile @@ -1,5 +1,59 @@ .PHONY: dev dev-frontend dev-backend build test lint clean +# Version +VERSION?=$(shell git describe --tags --always --dirty 2>/dev/null || echo "dev") +GIT_COMMIT=$(shell git rev-parse --short=8 HEAD 2>/dev/null || echo "dev") +BUILD_TIME=$(shell date +%FT%T%z) +GO_VERSION=$(shell $(GO) version | awk '{print $$3}') +CONFIG_PKG=github.com/sipeed/picoclaw/pkg/config +LDFLAGS=-X $(CONFIG_PKG).Version=$(VERSION) -X $(CONFIG_PKG).GitCommit=$(GIT_COMMIT) -X $(CONFIG_PKG).BuildTime=$(BUILD_TIME) -X $(CONFIG_PKG).GoVersion=$(GO_VERSION) -s -w + +# Go variables +GO?=CGO_ENABLED=0 go +GOFLAGS?=-v -tags stdjson + + +# OS detection +UNAME_S:=$(shell uname -s) +UNAME_M:=$(shell uname -m) + +# Platform-specific settings +ifeq ($(UNAME_S),Linux) + PLATFORM=linux + ifeq ($(UNAME_M),x86_64) + ARCH=amd64 + else ifeq ($(UNAME_M),aarch64) + ARCH=arm64 + else ifeq ($(UNAME_M),armv81) + ARCH=arm64 + else ifeq ($(UNAME_M),loongarch64) + ARCH=loong64 + else ifeq ($(UNAME_M),riscv64) + ARCH=riscv64 + else ifeq ($(UNAME_M),mipsel) + ARCH=mipsle + else + ARCH=$(UNAME_M) + endif +else ifeq ($(UNAME_S),Darwin) + PLATFORM=darwin + GO=CGO_ENABLED=1 go + ifeq ($(UNAME_M),x86_64) + ARCH=amd64 + else ifeq ($(UNAME_M),arm64) + ARCH=arm64 + else + ARCH=$(UNAME_M) + endif +else ifeq ($(UNAME_S),Windows) + PLATFORM=windows + ARCH=$(UNAME_M) + LDFLAGS=-H=windowsgui $(LDFLAGS) +else + PLATFORM=$(UNAME_S) + ARCH=$(UNAME_M) +endif + # Run both frontend and backend dev servers dev: @if [ ! -f backend/picoclaw-web ] || [ ! -d backend/dist ]; then \ @@ -15,21 +69,21 @@ dev-frontend: # Start backend dev server dev-backend: - cd backend && go run . + cd backend && ${GO} run -ldflags "$(LDFLAGS)" . # Build frontend and embed into Go binary build: cd frontend && pnpm build:backend - cd backend && go build -o picoclaw-web . + cd backend && ${GO} build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o picoclaw-web . # Run all tests test: - cd backend && go test ./... + cd backend && ${GO} test ./... cd frontend && pnpm lint # Lint and format lint: - cd backend && go vet ./... + cd backend && ${GO} vet ./... cd frontend && pnpm check # Clean build artifacts diff --git a/web/backend/api/events.go b/web/backend/api/events.go index af44d1824..5c85b149a 100644 --- a/web/backend/api/events.go +++ b/web/backend/api/events.go @@ -40,9 +40,13 @@ func (b *EventBroadcaster) Subscribe() chan string { // Unsubscribe removes a listener channel and closes it. func (b *EventBroadcaster) Unsubscribe(ch chan string) { b.mu.Lock() - delete(b.clients, ch) - b.mu.Unlock() - close(ch) + defer b.mu.Unlock() + + // Check if the channel is still registered before closing + if _, exists := b.clients[ch]; exists { + delete(b.clients, ch) + close(ch) + } } // Broadcast sends a GatewayEvent to all connected SSE clients. @@ -63,3 +67,14 @@ func (b *EventBroadcaster) Broadcast(event GatewayEvent) { } } } + +// Shutdown closes all subscriber channels, notifying all SSE clients to disconnect. +// This should be called when the server is shutting down. +func (b *EventBroadcaster) Shutdown() { + // Close all channels to notify listeners + for ch := range b.clients { + b.Unsubscribe(ch) + } + // Clear the map + b.clients = make(map[chan string]struct{}) +} diff --git a/web/backend/api/gateway.go b/web/backend/api/gateway.go index f50f7609a..424b21e96 100644 --- a/web/backend/api/gateway.go +++ b/web/backend/api/gateway.go @@ -3,10 +3,10 @@ package api import ( "bufio" "encoding/json" + "errors" "fmt" "io" "log" - "net" "net/http" "os" "os/exec" @@ -18,6 +18,7 @@ import ( "time" "github.com/sipeed/picoclaw/pkg/config" + "github.com/sipeed/picoclaw/pkg/health" "github.com/sipeed/picoclaw/web/backend/utils" ) @@ -48,6 +49,27 @@ var gatewayHealthGet = func(url string, timeout time.Duration) (*http.Response, return client.Get(url) } +// getGatewayHealth checks the gateway health endpoint and returns the status response +// Returns (*health.StatusResponse, statusCode, error). If error is not nil, the other values are not valid. +func getGatewayHealth(port int, timeout time.Duration) (*health.StatusResponse, int, error) { + if port == 0 { + port = 18790 + } + url := fmt.Sprintf("http://127.0.0.1:%d/health", port) + resp, err := gatewayHealthGet(url, timeout) + if err != nil { + return nil, 0, err + } + defer resp.Body.Close() + + var healthResponse health.StatusResponse + if decErr := json.NewDecoder(resp.Body).Decode(&healthResponse); decErr != nil { + return nil, resp.StatusCode, decErr + } + + return &healthResponse, resp.StatusCode, nil +} + // registerGatewayRoutes binds gateway lifecycle endpoints to the ServeMux. func (h *Handler) registerGatewayRoutes(mux *http.ServeMux) { mux.HandleFunc("GET /api/gateway/status", h.handleGatewayStatus) @@ -62,12 +84,35 @@ func (h *Handler) registerGatewayRoutes(mux *http.ServeMux) { // TryAutoStartGateway checks whether gateway start preconditions are met and // starts it when possible. Intended to be called by the backend at startup. func (h *Handler) TryAutoStartGateway() { + // Check if gateway is already running via health endpoint + cfg, cfgErr := config.LoadConfig(h.configPath) + if cfgErr == nil && cfg != nil { + healthResp, statusCode, err := getGatewayHealth(cfg.Gateway.Port, 2*time.Second) + if err == nil && statusCode == http.StatusOK { + // Gateway is already running, attach to the existing process + pid := healthResp.Pid + gateway.mu.Lock() + defer gateway.mu.Unlock() + ready, reason, err := h.gatewayStartReady() + if err != nil { + log.Printf("Skip auto-starting gateway: %v", err) + return + } + if !ready { + log.Printf("Skip auto-starting gateway: %s", reason) + return + } + _, err = h.startGatewayLocked("starting", pid) + if err != nil { + log.Printf("Failed to attach to running gateway (PID: %d): %v", pid, err) + } + return + } + } + gateway.mu.Lock() defer gateway.mu.Unlock() - if isGatewayProcessAliveLocked() { - return - } if gateway.cmd != nil && gateway.cmd.Process != nil { gateway.cmd = nil } @@ -82,7 +127,7 @@ func (h *Handler) TryAutoStartGateway() { return } - pid, err := h.startGatewayLocked("starting") + pid, err := h.startGatewayLocked("starting", 0) if err != nil { log.Printf("Failed to auto-start gateway: %v", err) return @@ -125,10 +170,6 @@ func lookupModelConfig(cfg *config.Config, modelName string) *config.ModelConfig return modelCfg } -func isGatewayProcessAliveLocked() bool { - return isCmdProcessAliveLocked(gateway.cmd) -} - func isCmdProcessAliveLocked(cmd *exec.Cmd) bool { if cmd == nil || cmd.Process == nil { return false @@ -157,6 +198,28 @@ func setGatewayRuntimeStatusLocked(status string) { gateway.startupDeadline = time.Time{} } +// attachToGatewayProcess attaches to an existing gateway process by PID +// and updates the gateway state accordingly. +// Assumes gateway.mu is held by the caller. +func attachToGatewayProcessLocked(pid int, cfg *config.Config) error { + process, err := os.FindProcess(pid) + if err != nil { + return fmt.Errorf("failed to find process for PID %d: %w", pid, err) + } + + gateway.cmd = &exec.Cmd{Process: process} + setGatewayRuntimeStatusLocked("running") + + // Update bootDefaultModel from config + if cfg != nil { + defaultModelName := strings.TrimSpace(cfg.Agents.Defaults.GetModelName()) + gateway.bootDefaultModel = defaultModelName + } + + log.Printf("Attached to gateway process (PID: %d)", pid) + return nil +} + func gatewayStatusOnHealthFailureLocked() string { if gateway.runtimeStatus == "starting" || gateway.runtimeStatus == "restarting" { if gateway.startupDeadline.IsZero() || time.Now().Before(gateway.startupDeadline) { @@ -238,24 +301,41 @@ func stopGatewayProcessForRestart(cmd *exec.Cmd) error { return fmt.Errorf("existing gateway did not exit before restart") } -func gatewayRestartRequired(status, bootDefaultModel, configDefaultModel string) bool { - return status == "running" && - bootDefaultModel != "" && - configDefaultModel != "" && - bootDefaultModel != configDefaultModel -} - -func (h *Handler) startGatewayLocked(initialStatus string) (int, error) { +func (h *Handler) startGatewayLocked(initialStatus string, existingPid int) (int, error) { cfg, err := config.LoadConfig(h.configPath) if err != nil { return 0, fmt.Errorf("failed to load config: %w", err) } defaultModelName := strings.TrimSpace(cfg.Agents.Defaults.GetModelName()) + var cmd *exec.Cmd + var pid int + + if existingPid > 0 { + // Attach to existing process + pid = existingPid + gateway.cmd = nil // Clear first to ensure clean state + if err = attachToGatewayProcessLocked(pid, cfg); err != nil { + return 0, err + } + + // Broadcast the attached state + gateway.events.Broadcast(GatewayEvent{ + Status: initialStatus, + PID: pid, + BootDefaultModel: defaultModelName, + ConfigDefaultModel: defaultModelName, + RestartRequired: false, + }) + + return pid, nil + } + + // Start new process // Locate the picoclaw executable execPath := utils.FindPicoclawBinary() - cmd := exec.Command(execPath, "gateway") + cmd = exec.Command(execPath, "gateway") cmd.Env = os.Environ() // Forward the launcher's config path via the environment variable that // GetConfigPath() already reads, so the gateway sub-process uses the same @@ -293,7 +373,7 @@ func (h *Handler) startGatewayLocked(initialStatus string) (int, error) { gateway.cmd = cmd gateway.bootDefaultModel = defaultModelName setGatewayRuntimeStatusLocked(initialStatus) - pid := cmd.Process.Pid + pid = cmd.Process.Pid log.Printf("Started picoclaw gateway (PID: %d) from %s", pid, execPath) // Broadcast the launch state immediately so clients can reflect it without polling. @@ -351,30 +431,22 @@ func (h *Handler) startGatewayLocked(initialStatus string) (int, error) { if err != nil { continue } - healthHost := gatewayProbeHost(h.effectiveGatewayBindHost(cfg)) - healthPort := cfg.Gateway.Port - if healthPort == 0 { - healthPort = 18790 - } - healthURL := fmt.Sprintf("http://%s/health", net.JoinHostPort(healthHost, strconv.Itoa(healthPort))) - resp, err := gatewayHealthGet(healthURL, 1*time.Second) - if err == nil { - resp.Body.Close() - if resp.StatusCode == http.StatusOK { - gateway.mu.Lock() - if gateway.cmd == cmd { - setGatewayRuntimeStatusLocked("running") - } - gateway.mu.Unlock() - gateway.events.Broadcast(GatewayEvent{ - Status: "running", - PID: pid, - BootDefaultModel: defaultModelName, - ConfigDefaultModel: defaultModelName, - RestartRequired: false, - }) - return + healthResp, statusCode, err := getGatewayHealth(cfg.Gateway.Port, 1*time.Second) + if err == nil && statusCode == http.StatusOK && healthResp.Pid == pid { + // Verify the health endpoint returns the expected pid + gateway.mu.Lock() + if gateway.cmd == cmd { + setGatewayRuntimeStatusLocked("running") } + gateway.mu.Unlock() + gateway.events.Broadcast(GatewayEvent{ + Status: "running", + PID: pid, + BootDefaultModel: defaultModelName, + ConfigDefaultModel: defaultModelName, + RestartRequired: false, + }) + return } } }() @@ -386,19 +458,54 @@ func (h *Handler) startGatewayLocked(initialStatus string) (int, error) { // // POST /api/gateway/start func (h *Handler) handleGatewayStart(w http.ResponseWriter, r *http.Request) { + // Prevent duplicate starts by checking health endpoint + cfg, cfgErr := config.LoadConfig(h.configPath) + if cfgErr == nil && cfg != nil { + healthResp, statusCode, err := getGatewayHealth(cfg.Gateway.Port, 2*time.Second) + if err == nil && statusCode == http.StatusOK { + // Gateway is already running, attach to the existing process + pid := healthResp.Pid + gateway.mu.Lock() + ready, reason, err := h.gatewayStartReady() + if err != nil { + gateway.mu.Unlock() + http.Error( + w, + fmt.Sprintf("Failed to validate gateway start conditions: %v", err), + http.StatusInternalServerError, + ) + return + } + if !ready { + gateway.mu.Unlock() + w.Header().Set("Content-Type", "application/json") + w.WriteHeader(http.StatusBadRequest) + json.NewEncoder(w).Encode(map[string]any{ + "status": "precondition_failed", + "message": reason, + }) + return + } + _, err = h.startGatewayLocked("starting", pid) + gateway.mu.Unlock() + if err != nil { + log.Printf("Failed to attach to running gateway (PID: %d): %v", pid, err) + http.Error(w, fmt.Sprintf("Failed to attach to gateway: %v", err), http.StatusInternalServerError) + return + } + w.Header().Set("Content-Type", "application/json") + w.WriteHeader(http.StatusOK) + json.NewEncoder(w).Encode(map[string]any{ + "status": "ok", + "pid": pid, + }) + return + } + } + gateway.mu.Lock() defer gateway.mu.Unlock() - // Prevent duplicate starts - if isGatewayProcessAliveLocked() { - w.Header().Set("Content-Type", "application/json") - w.WriteHeader(http.StatusConflict) - json.NewEncoder(w).Encode(map[string]any{ - "status": "already_running", - "pid": gateway.cmd.Process.Pid, - }) - return - } if gateway.cmd != nil && gateway.cmd.Process != nil { gateway.cmd = nil setGatewayRuntimeStatusLocked("stopped") @@ -423,7 +530,7 @@ func (h *Handler) handleGatewayStart(w http.ResponseWriter, r *http.Request) { return } - pid, err := h.startGatewayLocked("starting") + pid, err := h.startGatewayLocked("starting", 0) if err != nil { http.Error(w, fmt.Sprintf("Failed to start gateway: %v", err), http.StatusInternalServerError) return @@ -475,27 +582,16 @@ func (h *Handler) handleGatewayStop(w http.ResponseWriter, r *http.Request) { }) } -// handleGatewayRestart stops the gateway (if running) and starts a new instance. -// -// POST /api/gateway/restart -func (h *Handler) handleGatewayRestart(w http.ResponseWriter, r *http.Request) { +// RestartGateway restarts the gateway process. This is a non-blocking operation +// that stops the current gateway (if running) and starts a new one. +// Returns the PID of the new gateway process or an error. +func (h *Handler) RestartGateway() (int, error) { ready, reason, err := h.gatewayStartReady() if err != nil { - http.Error( - w, - fmt.Sprintf("Failed to validate gateway start conditions: %v", err), - http.StatusInternalServerError, - ) - return + return 0, fmt.Errorf("failed to validate gateway start conditions: %w", err) } if !ready { - w.Header().Set("Content-Type", "application/json") - w.WriteHeader(http.StatusBadRequest) - json.NewEncoder(w).Encode(map[string]any{ - "status": "precondition_failed", - "message": reason, - }) - return + return 0, &preconditionFailedError{reason: reason} } gateway.mu.Lock() @@ -519,8 +615,7 @@ func (h *Handler) handleGatewayRestart(w http.ResponseWriter, r *http.Request) { } } gateway.mu.Unlock() - http.Error(w, fmt.Sprintf("Failed to restart gateway: %v", err), http.StatusInternalServerError) - return + return 0, fmt.Errorf("failed to stop gateway: %w", err) } gateway.mu.Lock() @@ -528,7 +623,7 @@ func (h *Handler) handleGatewayRestart(w http.ResponseWriter, r *http.Request) { gateway.cmd = nil gateway.bootDefaultModel = "" } - pid, err := h.startGatewayLocked("restarting") + pid, err := h.startGatewayLocked("restarting", 0) if err != nil { gateway.cmd = nil gateway.bootDefaultModel = "" @@ -536,6 +631,43 @@ func (h *Handler) handleGatewayRestart(w http.ResponseWriter, r *http.Request) { } gateway.mu.Unlock() if err != nil { + return 0, fmt.Errorf("failed to start gateway: %w", err) + } + + return pid, nil +} + +// preconditionFailedError is returned when gateway restart preconditions are not met +type preconditionFailedError struct { + reason string +} + +func (e *preconditionFailedError) Error() string { + return e.reason +} + +// IsBadRequest returns true if the error should result in a 400 Bad Request status +func (e *preconditionFailedError) IsBadRequest() bool { + return true +} + +// handleGatewayRestart stops the gateway (if running) and starts a new instance. +// +// POST /api/gateway/restart +func (h *Handler) handleGatewayRestart(w http.ResponseWriter, r *http.Request) { + pid, err := h.RestartGateway() + if err != nil { + // Check if it's a precondition failed error + var precondErr *preconditionFailedError + if errors.As(err, &precondErr) { + w.Header().Set("Content-Type", "application/json") + w.WriteHeader(http.StatusBadRequest) + json.NewEncoder(w).Encode(map[string]any{ + "status": "precondition_failed", + "message": precondErr.reason, + }) + return + } http.Error(w, fmt.Sprintf("Failed to restart gateway: %v", err), http.StatusInternalServerError) return } @@ -573,83 +705,74 @@ func (h *Handler) handleGatewayStatus(w http.ResponseWriter, r *http.Request) { func (h *Handler) gatewayStatusData() map[string]any { data := map[string]any{} cfg, cfgErr := config.LoadConfig(h.configPath) - configDefaultModel := "" if cfgErr == nil && cfg != nil { - configDefaultModel = strings.TrimSpace(cfg.Agents.Defaults.GetModelName()) + configDefaultModel := strings.TrimSpace(cfg.Agents.Defaults.GetModelName()) if configDefaultModel != "" { data["config_default_model"] = configDefaultModel } } - // Check process state - gateway.mu.Lock() - processAlive := isGatewayProcessAliveLocked() - bootDefaultModel := "" - if processAlive { - data["pid"] = gateway.cmd.Process.Pid - if gateway.bootDefaultModel != "" { - data["boot_default_model"] = gateway.bootDefaultModel - bootDefaultModel = gateway.bootDefaultModel - } + // Probe health endpoint to get pid and status + port := 0 + if cfgErr == nil && cfg != nil { + port = cfg.Gateway.Port } - gateway.mu.Unlock() - if !processAlive { + healthResp, statusCode, err := getGatewayHealth(port, 2*time.Second) + if err != nil { gateway.mu.Lock() - data["gateway_status"] = currentGatewayStatusLocked(false) + data["gateway_status"] = currentGatewayStatusLocked(true) gateway.mu.Unlock() + log.Printf("Gateway health check failed: %v", err) } else { - // Process is alive — probe its health endpoint - host := "127.0.0.1" - port := 18790 - if cfgErr == nil && cfg != nil { - host = gatewayProbeHost(h.effectiveGatewayBindHost(cfg)) - if cfg.Gateway.Port != 0 { - port = cfg.Gateway.Port - } - } - - url := fmt.Sprintf("http://%s/health", net.JoinHostPort(host, strconv.Itoa(port))) - resp, err := gatewayHealthGet(url, 2*time.Second) - - if err != nil { + log.Printf("Gateway health status: %d", statusCode) + if statusCode != http.StatusOK { gateway.mu.Lock() - data["gateway_status"] = currentGatewayStatusLocked(true) + setGatewayRuntimeStatusLocked("error") gateway.mu.Unlock() + data["gateway_status"] = "error" + data["status_code"] = statusCode } else { - defer resp.Body.Close() - if resp.StatusCode != http.StatusOK { - gateway.mu.Lock() - setGatewayRuntimeStatusLocked("error") - gateway.mu.Unlock() - data["gateway_status"] = "error" - data["status_code"] = resp.StatusCode + gateway.mu.Lock() + // Check if this pid matches our tracked process + if gateway.cmd != nil && gateway.cmd.Process != nil && gateway.cmd.Process.Pid == healthResp.Pid { + setGatewayRuntimeStatusLocked("running") + bootDefaultModel := gateway.bootDefaultModel + if bootDefaultModel != "" { + data["boot_default_model"] = bootDefaultModel + } + data["gateway_status"] = "running" + data["pid"] = healthResp.Pid } else { - var healthData map[string]any - if decErr := json.NewDecoder(resp.Body).Decode(&healthData); decErr != nil { - gateway.mu.Lock() + // Health endpoint responded with a different pid + // This could be a manual restart, try to attach to the new process + oldPid := "none" + if gateway.cmd != nil && gateway.cmd.Process != nil { + oldPid = fmt.Sprintf("%d", gateway.cmd.Process.Pid) + } + log.Printf("Detected new gateway PID (old: %s, new: %d), attempting to attach", oldPid, healthResp.Pid) + + if err := attachToGatewayProcessLocked(healthResp.Pid, cfg); err != nil { + // Failed to find the process, treat as error setGatewayRuntimeStatusLocked("error") - gateway.mu.Unlock() data["gateway_status"] = "error" + data["pid"] = healthResp.Pid + log.Printf("Failed to attach to new gateway process (PID: %d): %v", healthResp.Pid, err) } else { - gateway.mu.Lock() - setGatewayRuntimeStatusLocked("running") - gateway.mu.Unlock() - for k, v := range healthData { - data[k] = v + // Successfully attached, update response data + bootDefaultModel := gateway.bootDefaultModel + if bootDefaultModel != "" { + data["boot_default_model"] = bootDefaultModel } data["gateway_status"] = "running" + data["pid"] = healthResp.Pid } } + gateway.mu.Unlock() } } - status, _ := data["gateway_status"].(string) - data["gateway_restart_required"] = gatewayRestartRequired( - status, - bootDefaultModel, - configDefaultModel, - ) + data["gateway_restart_required"] = false ready, reason, readyErr := h.gatewayStartReady() if readyErr != nil { diff --git a/web/backend/api/gateway_test.go b/web/backend/api/gateway_test.go index 06803722d..fb4f7d943 100644 --- a/web/backend/api/gateway_test.go +++ b/web/backend/api/gateway_test.go @@ -494,60 +494,6 @@ func TestGatewayStatusReturnsRestartingDuringRestartGap(t *testing.T) { } } -func TestGatewayStatusIncludesRestartRequiredWhenModelsDiffer(t *testing.T) { - resetGatewayTestState(t) - - configPath := filepath.Join(t.TempDir(), "config.json") - cfg := config.DefaultConfig() - cfg.Agents.Defaults.ModelName = cfg.ModelList[0].ModelName - cfg.ModelList[0].APIKey = "test-key" - if err := config.SaveConfig(configPath, cfg); err != nil { - t.Fatalf("SaveConfig() error = %v", err) - } - - h := NewHandler(configPath) - mux := http.NewServeMux() - h.RegisterRoutes(mux) - - cmd := startLongRunningProcess(t) - t.Cleanup(func() { - if cmd.Process != nil { - _ = cmd.Process.Kill() - } - _ = cmd.Wait() - }) - - gateway.mu.Lock() - gateway.cmd = cmd - gateway.bootDefaultModel = "previous-model" - setGatewayRuntimeStatusLocked("running") - gateway.mu.Unlock() - - gatewayHealthGet = func(string, time.Duration) (*http.Response, error) { - rec := httptest.NewRecorder() - rec.WriteHeader(http.StatusOK) - _, _ = rec.WriteString(`{"ok":true}`) - return rec.Result(), nil - } - - rec := httptest.NewRecorder() - req := httptest.NewRequest(http.MethodGet, "/api/gateway/status", nil) - mux.ServeHTTP(rec, req) - - if rec.Code != http.StatusOK { - t.Fatalf("status = %d, want %d", rec.Code, http.StatusOK) - } - - var body map[string]any - if err := json.Unmarshal(rec.Body.Bytes(), &body); err != nil { - t.Fatalf("unmarshal response: %v", err) - } - - if got := body["gateway_restart_required"]; got != true { - t.Fatalf("gateway_restart_required = %#v, want true", got) - } -} - func TestGatewayRestartKeepsRunningProcessWhenPreconditionsFail(t *testing.T) { configPath := filepath.Join(t.TempDir(), "config.json") cfg := config.DefaultConfig() diff --git a/web/backend/api/router.go b/web/backend/api/router.go index 5f081dee9..b56438784 100644 --- a/web/backend/api/router.go +++ b/web/backend/api/router.go @@ -70,3 +70,8 @@ func (h *Handler) RegisterRoutes(mux *http.ServeMux) { // Launcher service parameters (port/public) h.registerLauncherConfigRoutes(mux) } + +// Shutdown gracefully shuts down the handler, closing all SSE connections. +func (h *Handler) Shutdown() { + gateway.events.Shutdown() +} diff --git a/web/backend/i18n.go b/web/backend/i18n.go new file mode 100644 index 000000000..9cda9e5d5 --- /dev/null +++ b/web/backend/i18n.go @@ -0,0 +1,120 @@ +package main + +import ( + "fmt" + "os" + "strings" +) + +// Language represents the supported languages +type Language string + +const ( + LanguageEnglish Language = "en" + LanguageChinese Language = "zh" +) + +// current language (default: English) +var currentLang Language = LanguageEnglish + +// TranslationKey represents a translation key used for i18n +type TranslationKey string + +const ( + AppTooltip TranslationKey = "AppTooltip" + MenuOpen TranslationKey = "MenuOpen" + MenuOpenTooltip TranslationKey = "MenuOpenTooltip" + MenuAbout TranslationKey = "MenuAbout" + MenuAboutTooltip TranslationKey = "MenuAboutTooltip" + MenuVersion TranslationKey = "MenuVersion" + MenuVersionTooltip TranslationKey = "MenuVersionTooltip" + MenuGitHub TranslationKey = "MenuGitHub" + MenuDocs TranslationKey = "MenuDocs" + MenuRestart TranslationKey = "MenuRestart" + MenuRestartTooltip TranslationKey = "MenuRestartTooltip" + MenuQuit TranslationKey = "MenuQuit" + MenuQuitTooltip TranslationKey = "MenuQuitTooltip" + Exiting TranslationKey = "Exiting" + DocUrl TranslationKey = "DocUrl" +) + +// Translation tables +// Chinese translations intentionally contain Han script +// +//nolint:gosmopolitan +var translations = map[Language]map[TranslationKey]string{ + LanguageEnglish: { + AppTooltip: "%s - Web Console", + MenuOpen: "Open Console", + MenuOpenTooltip: "Open PicoClaw console in browser", + MenuAbout: "About", + MenuAboutTooltip: "About PicoClaw", + MenuVersion: "Version: %s", + MenuVersionTooltip: "Current version number", + MenuGitHub: "GitHub", + MenuDocs: "Documentation", + MenuRestart: "Restart Service", + MenuRestartTooltip: "Restart Gateway service", + MenuQuit: "Quit", + MenuQuitTooltip: "Exit PicoClaw", + Exiting: "Exiting PicoClaw...", + DocUrl: "https://docs.picoclaw.io/docs/", + }, + LanguageChinese: { + AppTooltip: "%s - Web Console", + MenuOpen: "打开控制台", + MenuOpenTooltip: "在浏览器中打开 PicoClaw 控制台", + MenuAbout: "关于", + MenuAboutTooltip: "关于 PicoClaw", + MenuVersion: "版本: %s", + MenuVersionTooltip: "当前版本号", + MenuGitHub: "GitHub", + MenuDocs: "文档", + MenuRestart: "重启服务", + MenuRestartTooltip: "重启核心服务", + MenuQuit: "退出", + MenuQuitTooltip: "退出 PicoClaw", + Exiting: "正在退出 PicoClaw...", + DocUrl: "https://docs.picoclaw.io/zh-Hans/docs/", + }, +} + +// SetLanguage sets the current language +func SetLanguage(lang string) { + lang = strings.ToLower(strings.TrimSpace(lang)) + + // Extract language code before first underscore or dot + // e.g., "en_US.UTF-8" -> "en", "zh_CN" -> "zh" + if idx := strings.IndexAny(lang, "_."); idx > 0 { + lang = lang[:idx] + } + + if lang == "zh" || lang == "zh-cn" || lang == "chinese" { + currentLang = LanguageChinese + } else { + currentLang = LanguageEnglish + } +} + +// GetLanguage returns the current language +func GetLanguage() Language { + return currentLang +} + +// T translates a key to the current language +func T(key TranslationKey, args ...any) string { + if trans, ok := translations[currentLang][key]; ok { + if len(args) > 0 { + return fmt.Sprintf(trans, args...) + } + return trans + } + return string(key) +} + +// Initialize i18n from environment variable +func init() { + if lang := os.Getenv("LANG"); lang != "" { + SetLanguage(lang) + } +} diff --git a/web/backend/icon.png b/web/backend/icon.png new file mode 100644 index 0000000000000000000000000000000000000000..e0b4aab9c42f1b84b3ff7ffb145a965bcd67e925 GIT binary patch literal 104580 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Ð(DO2QQ;r?v9Hw5{pgM358g3j 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 literal 0 HcmV?d00001 diff --git a/web/backend/main.go b/web/backend/main.go index 650540ea8..f2fe3de97 100644 --- a/web/backend/main.go +++ b/web/backend/main.go @@ -22,16 +22,34 @@ import ( "strconv" "time" + "fyne.io/systray" + + "github.com/sipeed/picoclaw/pkg/config" "github.com/sipeed/picoclaw/web/backend/api" "github.com/sipeed/picoclaw/web/backend/launcherconfig" "github.com/sipeed/picoclaw/web/backend/middleware" "github.com/sipeed/picoclaw/web/backend/utils" ) +const ( + appName = "PicoClaw" +) + +var ( + appVersion = config.Version + + server *http.Server + serverAddr string + apiHandler *api.Handler + + noBrowser *bool +) + func main() { port := flag.String("port", "18800", "Port to listen on") public := flag.Bool("public", false, "Listen on all interfaces (0.0.0.0) instead of localhost only") - noBrowser := flag.Bool("no-browser", false, "Do not auto-open browser on startup") + noBrowser = flag.Bool("no-browser", false, "Do not auto-open browser on startup") + lang := flag.String("lang", "", "Language: en (English) or zh (Chinese). Default: auto-detect from system locale") flag.Usage = func() { fmt.Fprintf(os.Stderr, "PicoClaw Launcher - A web-based configuration editor\n\n") @@ -51,6 +69,11 @@ func main() { } flag.Parse() + // Set language from command line or auto-detect + if *lang != "" { + SetLanguage(*lang) + } + // Resolve config path configPath := utils.GetDefaultConfigPath() if flag.NArg() > 0 { @@ -113,7 +136,7 @@ func main() { mux := http.NewServeMux() // API Routes (e.g. /api/status) - apiHandler := api.NewHandler(absPath) + apiHandler = api.NewHandler(absPath) apiHandler.SetServerOptions(portNum, effectivePublic, explicitPublic, launcherCfg.AllowedCIDRs) apiHandler.RegisterRoutes(mux) @@ -145,16 +168,10 @@ func main() { } fmt.Println() - // Auto-open browser - if !*noBrowser { - go func() { - time.Sleep(500 * time.Millisecond) - url := "http://localhost:" + effectivePort - if err := utils.OpenBrowser(url); err != nil { - log.Printf("Warning: Failed to auto-open browser: %v", err) - } - }() - } + // Set server address for systray + serverAddr = fmt.Sprintf("http://localhost:%s", effectivePort) + + // Auto-open browser will be handled by systray onReady // Auto-start gateway after backend starts listening. go func() { @@ -162,8 +179,15 @@ func main() { apiHandler.TryAutoStartGateway() }() - // Start the Server - if err := http.ListenAndServe(addr, handler); err != nil { - log.Fatalf("Server failed to start: %v", err) - } + // Start the Server in a goroutine + server = &http.Server{Addr: addr, Handler: handler} + go func() { + log.Printf("Server listening on %s", addr) + if err := server.ListenAndServe(); err != nil && err != http.ErrServerClosed { + log.Fatalf("Server failed to start: %v", err) + } + }() + + // Start system tray + systray.Run(onReady, onExit) } diff --git a/web/backend/systray.go b/web/backend/systray.go new file mode 100644 index 000000000..58ce4984f --- /dev/null +++ b/web/backend/systray.go @@ -0,0 +1,133 @@ +package main + +import ( + "context" + _ "embed" + "fmt" + "time" + + "fyne.io/systray" + + "github.com/sipeed/picoclaw/pkg/logger" + "github.com/sipeed/picoclaw/web/backend/utils" +) + +const ( + browserDelay = 500 * time.Millisecond + shutdownTimeout = 15 * time.Second +) + +// onReady is called when the system tray is ready +func onReady() { + // Set icon and tooltip + systray.SetIcon(getIcon()) + systray.SetTooltip(fmt.Sprintf(T(AppTooltip), appName)) + + // Create menu items + mOpen := systray.AddMenuItem(T(MenuOpen), T(MenuOpenTooltip)) + mAbout := systray.AddMenuItem(T(MenuAbout), T(MenuAboutTooltip)) + + // Add version info under About menu + mVersion := mAbout.AddSubMenuItem(fmt.Sprintf(T(MenuVersion), appVersion), T(MenuVersionTooltip)) + mVersion.Disable() + mRepo := mAbout.AddSubMenuItem(T(MenuGitHub), "") + mDocs := mAbout.AddSubMenuItem(T(MenuDocs), "") + + systray.AddSeparator() + + // Add restart option + mRestart := systray.AddMenuItem(T(MenuRestart), T(MenuRestartTooltip)) + + systray.AddSeparator() + + // Quit option + mQuit := systray.AddMenuItem(T(MenuQuit), T(MenuQuitTooltip)) + + // Handle menu clicks + go func() { + for { + select { + case <-mOpen.ClickedCh: + if err := openBrowser(); err != nil { + logger.Errorf("Failed to open browser: %v", err) + } + + case <-mVersion.ClickedCh: + // Version info - do nothing, just shows current version + + case <-mRepo.ClickedCh: + if err := utils.OpenBrowser("https://github.com/sipeed/picoclaw"); err != nil { + logger.Errorf("Failed to open GitHub: %v", err) + } + + case <-mDocs.ClickedCh: + if err := utils.OpenBrowser(T(DocUrl)); err != nil { + logger.Errorf("Failed to open docs: %v", err) + } + + case <-mRestart.ClickedCh: + fmt.Println("Restart request received...") + if apiHandler != nil { + if pid, err := apiHandler.RestartGateway(); err != nil { + logger.Errorf("Failed to restart gateway: %v", err) + } else { + logger.Infof("Gateway restarted (PID: %d)", pid) + } + } + + case <-mQuit.ClickedCh: + systray.Quit() + } + } + }() + + if !*noBrowser { + // Auto-open browser after systray is ready (if not disabled) + // Check no-browser flag via environment or pass as parameter if needed + if err := openBrowser(); err != nil { + logger.Errorf("Warning: Failed to auto-open browser: %v", err) + } + } +} + +// onExit is called when the system tray is exiting +func onExit() { + fmt.Println(T(Exiting)) + + // First, shutdown API handler to close all SSE connections + if apiHandler != nil { + apiHandler.Shutdown() + } + + if server != nil { + // Disable keep-alive to allow graceful shutdown + server.SetKeepAlivesEnabled(false) + + ctx, cancel := context.WithTimeout(context.Background(), shutdownTimeout) + defer cancel() + if err := server.Shutdown(ctx); err != nil { + // Context deadline exceeded is expected if there are active connections + // This is not necessarily an error, so log it at info level + if err == context.DeadlineExceeded { + logger.Infof("Server shutdown timeout after %v, forcing close", shutdownTimeout) + } else { + logger.Errorf("Server shutdown error: %v", err) + } + } else { + logger.Infof("Server shutdown completed successfully") + } + } +} + +// openBrowser opens the PicoClaw web console in the default browser +func openBrowser() error { + if serverAddr == "" { + return fmt.Errorf("server address not set") + } + return utils.OpenBrowser(serverAddr) +} + +// getIcon returns the system tray icon +func getIcon() []byte { + return iconData +} diff --git a/web/backend/systray_unix.go b/web/backend/systray_unix.go new file mode 100644 index 000000000..0f9d2bb51 --- /dev/null +++ b/web/backend/systray_unix.go @@ -0,0 +1,8 @@ +//go:build !windows + +package main + +import _ "embed" + +//go:embed icon.png +var iconData []byte diff --git a/web/backend/systray_windows.go b/web/backend/systray_windows.go new file mode 100644 index 000000000..cc1885155 --- /dev/null +++ b/web/backend/systray_windows.go @@ -0,0 +1,8 @@ +//go:build windows + +package main + +import _ "embed" + +//go:embed icon.ico +var iconData []byte From b402888bfacd559852d2c245d33b578d4d8e2e5a Mon Sep 17 00:00:00 2001 From: Desmond Foo <102380796+SHINE-six@users.noreply.github.com> Date: Tue, 17 Mar 2026 14:41:43 +0800 Subject: [PATCH 42/56] feat(tools): add SpawnStatusTool for reporting subagent statuses (#1540) * feat(tools): add SpawnStatusTool for reporting subagent statuses * feat(tools): enhance SpawnStatusTool to restrict task visibility by conversation context * feat(tests): add Unicode result truncation and channel filtering tests for SpawnStatusTool * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * feat(tools): enhance SpawnStatusTool with task ID validation and sorting by creation timestamp * feat(tools): update SpawnStatusTool description and parameter documentation for clarity * refactor(tests): improve comments for clarity in ChannelFiltering test case * fix(tools): update no subagents message for clarity and remove unnecessary locking in runTask * fix(tools): improve description clarity for SpawnStatusTool regarding task context * feat(tools): add spawn_status tool configuration and registration * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * fix(agent): improve subagent management for spawn and spawn_status tools * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * fix(tests): update ResultTruncation_Unicode test to use valid CJK character --------- Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: lxowalle <83055338+lxowalle@users.noreply.github.com> --- pkg/agent/loop.go | 20 +- pkg/config/config.go | 3 + pkg/config/defaults.go | 3 + pkg/tools/spawn_status.go | 178 +++++++++++++++ pkg/tools/spawn_status_test.go | 406 +++++++++++++++++++++++++++++++++ pkg/tools/subagent.go | 28 ++- web/backend/api/tools.go | 14 +- 7 files changed, 641 insertions(+), 11 deletions(-) create mode 100644 pkg/tools/spawn_status.go create mode 100644 pkg/tools/spawn_status_test.go diff --git a/pkg/agent/loop.go b/pkg/agent/loop.go index 182bc0495..8328c691e 100644 --- a/pkg/agent/loop.go +++ b/pkg/agent/loop.go @@ -225,20 +225,26 @@ 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) - subagentManager.SetLLMOptions(agent.MaxTokens, agent.Temperature) + // Spawn and spawn_status tools share a SubagentManager. + // Construct it when either tool is enabled (both require subagent). + spawnEnabled := cfg.Tools.IsToolEnabled("spawn") + spawnStatusEnabled := cfg.Tools.IsToolEnabled("spawn_status") + if (spawnEnabled || spawnStatusEnabled) && cfg.Tools.IsToolEnabled("subagent") { + subagentManager := tools.NewSubagentManager(provider, agent.Model, agent.Workspace) + subagentManager.SetLLMOptions(agent.MaxTokens, agent.Temperature) + if spawnEnabled { spawnTool := tools.NewSpawnTool(subagentManager) currentAgentID := agentID spawnTool.SetAllowlistChecker(func(targetAgentID string) bool { return registry.CanSpawnSubagent(currentAgentID, targetAgentID) }) agent.Tools.Register(spawnTool) - } else { - logger.WarnCF("agent", "spawn tool requires subagent to be enabled", nil) } + if spawnStatusEnabled { + agent.Tools.Register(tools.NewSpawnStatusTool(subagentManager)) + } + } else if (spawnEnabled || spawnStatusEnabled) && !cfg.Tools.IsToolEnabled("subagent") { + logger.WarnCF("agent", "spawn/spawn_status tools require subagent to be enabled", nil) } } } diff --git a/pkg/config/config.go b/pkg/config/config.go index ad5618907..35de48f23 100644 --- a/pkg/config/config.go +++ b/pkg/config/config.go @@ -751,6 +751,7 @@ type ToolsConfig struct { ReadFile ReadFileToolConfig `json:"read_file" envPrefix:"PICOCLAW_TOOLS_READ_FILE_"` SendFile ToolConfig `json:"send_file" envPrefix:"PICOCLAW_TOOLS_SEND_FILE_"` Spawn ToolConfig `json:"spawn" envPrefix:"PICOCLAW_TOOLS_SPAWN_"` + SpawnStatus ToolConfig `json:"spawn_status" envPrefix:"PICOCLAW_TOOLS_SPAWN_STATUS_"` SPI ToolConfig `json:"spi" envPrefix:"PICOCLAW_TOOLS_SPI_"` Subagent ToolConfig `json:"subagent" envPrefix:"PICOCLAW_TOOLS_SUBAGENT_"` WebFetch ToolConfig `json:"web_fetch" envPrefix:"PICOCLAW_TOOLS_WEB_FETCH_"` @@ -1112,6 +1113,8 @@ func (t *ToolsConfig) IsToolEnabled(name string) bool { return t.ReadFile.Enabled case "spawn": return t.Spawn.Enabled + case "spawn_status": + return t.SpawnStatus.Enabled case "spi": return t.SPI.Enabled case "subagent": diff --git a/pkg/config/defaults.go b/pkg/config/defaults.go index a029eeb59..2b177d5de 100644 --- a/pkg/config/defaults.go +++ b/pkg/config/defaults.go @@ -522,6 +522,9 @@ func DefaultConfig() *Config { Spawn: ToolConfig{ Enabled: true, }, + SpawnStatus: ToolConfig{ + Enabled: false, + }, SPI: ToolConfig{ Enabled: false, // Hardware tool - Linux only }, diff --git a/pkg/tools/spawn_status.go b/pkg/tools/spawn_status.go new file mode 100644 index 000000000..416fd2226 --- /dev/null +++ b/pkg/tools/spawn_status.go @@ -0,0 +1,178 @@ +package tools + +import ( + "context" + "fmt" + "sort" + "strings" + "time" +) + +// SpawnStatusTool reports the status of subagents that were spawned via the +// spawn tool. It can query a specific task by ID, or list every known task with +// a summary count broken-down by status. +type SpawnStatusTool struct { + manager *SubagentManager +} + +// NewSpawnStatusTool creates a SpawnStatusTool backed by the given manager. +func NewSpawnStatusTool(manager *SubagentManager) *SpawnStatusTool { + return &SpawnStatusTool{manager: manager} +} + +func (t *SpawnStatusTool) Name() string { + return "spawn_status" +} + +func (t *SpawnStatusTool) Description() string { + return "Get the status of spawned subagents. " + + "Returns a list of all subagents and their current state " + + "(running, completed, failed, or canceled), or retrieves details " + + "for a specific subagent task when task_id is provided. " + + "Results are scoped to the current conversation's channel and chat ID; " + + "all tasks are listed only when no channel/chat context is injected " + + "(e.g. direct programmatic calls via Execute)." +} + +func (t *SpawnStatusTool) Parameters() map[string]any { + return map[string]any{ + "type": "object", + "properties": map[string]any{ + "task_id": map[string]any{ + "type": "string", + "description": "Optional task ID (e.g. \"subagent-1\") to inspect a specific " + + "subagent. When omitted, all visible subagents are listed.", + }, + }, + "required": []string{}, + } +} + +func (t *SpawnStatusTool) Execute(ctx context.Context, args map[string]any) *ToolResult { + if t.manager == nil { + return ErrorResult("Subagent manager not configured") + } + + // Derive the calling conversation's identity so we can scope results to the + // current chat only — preventing cross-conversation task leakage in + // multi-user deployments. + callerChannel := ToolChannel(ctx) + callerChatID := ToolChatID(ctx) + + var taskID string + if rawTaskID, ok := args["task_id"]; ok && rawTaskID != nil { + taskIDStr, ok := rawTaskID.(string) + if !ok { + return ErrorResult("task_id must be a string") + } + taskID = strings.TrimSpace(taskIDStr) + } + + if taskID != "" { + // GetTaskCopy returns a consistent snapshot under the manager lock, + // eliminating any data race with the concurrent subagent goroutine. + taskCopy, ok := t.manager.GetTaskCopy(taskID) + if !ok { + return ErrorResult(fmt.Sprintf("No subagent found with task ID: %s", taskID)) + } + + // Restrict lookup to tasks that belong to this conversation. + if callerChannel != "" && taskCopy.OriginChannel != "" && taskCopy.OriginChannel != callerChannel { + return ErrorResult(fmt.Sprintf("No subagent found with task ID: %s", taskID)) + } + if callerChatID != "" && taskCopy.OriginChatID != "" && taskCopy.OriginChatID != callerChatID { + return ErrorResult(fmt.Sprintf("No subagent found with task ID: %s", taskID)) + } + + return NewToolResult(spawnStatusFormatTask(&taskCopy)) + } + + // ListTaskCopies returns consistent snapshots under the manager lock. + origTasks := t.manager.ListTaskCopies() + if len(origTasks) == 0 { + return NewToolResult("No subagents have been spawned yet.") + } + + tasks := make([]*SubagentTask, 0, len(origTasks)) + for i := range origTasks { + cpy := &origTasks[i] + + // Filter to tasks that originate from the current conversation only. + if callerChannel != "" && cpy.OriginChannel != "" && cpy.OriginChannel != callerChannel { + continue + } + if callerChatID != "" && cpy.OriginChatID != "" && cpy.OriginChatID != callerChatID { + continue + } + + tasks = append(tasks, cpy) + } + + if len(tasks) == 0 { + return NewToolResult("No subagents found for this conversation.") + } + + // Order by creation time (ascending) so spawning order is preserved. + // Fall back to ID string for tasks created in the same millisecond. + sort.Slice(tasks, func(i, j int) bool { + if tasks[i].Created != tasks[j].Created { + return tasks[i].Created < tasks[j].Created + } + return tasks[i].ID < tasks[j].ID + }) + + counts := map[string]int{} + for _, task := range tasks { + counts[task.Status]++ + } + + var sb strings.Builder + sb.WriteString(fmt.Sprintf("Subagent status report (%d total):\n", len(tasks))) + for _, status := range []string{"running", "completed", "failed", "canceled"} { + if n := counts[status]; n > 0 { + label := strings.ToUpper(status[:1]) + status[1:] + ":" + sb.WriteString(fmt.Sprintf(" %-10s %d\n", label, n)) + } + } + sb.WriteString("\n") + + for _, task := range tasks { + sb.WriteString(spawnStatusFormatTask(task)) + sb.WriteString("\n\n") + } + + return NewToolResult(strings.TrimRight(sb.String(), "\n")) +} + +// spawnStatusFormatTask renders a single SubagentTask as a human-readable block. +func spawnStatusFormatTask(task *SubagentTask) string { + var sb strings.Builder + + header := fmt.Sprintf("[%s] status=%s", task.ID, task.Status) + if task.Label != "" { + header += fmt.Sprintf(" label=%q", task.Label) + } + if task.AgentID != "" { + header += fmt.Sprintf(" agent=%s", task.AgentID) + } + if task.Created > 0 { + created := time.UnixMilli(task.Created).UTC().Format("2006-01-02 15:04:05 UTC") + header += fmt.Sprintf(" created=%s", created) + } + sb.WriteString(header) + + if task.Task != "" { + sb.WriteString(fmt.Sprintf("\n task: %s", task.Task)) + } + if task.Result != "" { + result := task.Result + const maxResultLen = 300 + runes := []rune(result) + if len(runes) > maxResultLen { + result = string(runes[:maxResultLen]) + "…" + } + sb.WriteString(fmt.Sprintf("\n result: %s", result)) + } + + return sb.String() +} diff --git a/pkg/tools/spawn_status_test.go b/pkg/tools/spawn_status_test.go new file mode 100644 index 000000000..9c772d61a --- /dev/null +++ b/pkg/tools/spawn_status_test.go @@ -0,0 +1,406 @@ +package tools + +import ( + "context" + "fmt" + "strings" + "testing" + "time" +) + +func TestSpawnStatusTool_Name(t *testing.T) { + provider := &MockLLMProvider{} + workspace := t.TempDir() + manager := NewSubagentManager(provider, "test-model", workspace) + tool := NewSpawnStatusTool(manager) + + if tool.Name() != "spawn_status" { + t.Errorf("Expected name 'spawn_status', got '%s'", tool.Name()) + } +} + +func TestSpawnStatusTool_Description(t *testing.T) { + provider := &MockLLMProvider{} + workspace := t.TempDir() + manager := NewSubagentManager(provider, "test-model", workspace) + tool := NewSpawnStatusTool(manager) + + desc := tool.Description() + if desc == "" { + t.Error("Description should not be empty") + } + if !strings.Contains(strings.ToLower(desc), "subagent") { + t.Errorf("Description should mention 'subagent', got: %s", desc) + } +} + +func TestSpawnStatusTool_Parameters(t *testing.T) { + provider := &MockLLMProvider{} + workspace := t.TempDir() + manager := NewSubagentManager(provider, "test-model", workspace) + tool := NewSpawnStatusTool(manager) + + params := tool.Parameters() + if params["type"] != "object" { + t.Errorf("Expected type 'object', got: %v", params["type"]) + } + props, ok := params["properties"].(map[string]any) + if !ok { + t.Fatal("Expected 'properties' to be a map") + } + if _, hasTaskID := props["task_id"]; !hasTaskID { + t.Error("Expected 'task_id' parameter in properties") + } +} + +func TestSpawnStatusTool_NilManager(t *testing.T) { + tool := &SpawnStatusTool{manager: nil} + result := tool.Execute(context.Background(), map[string]any{}) + if !result.IsError { + t.Error("Expected error result when manager is nil") + } +} + +func TestSpawnStatusTool_Empty(t *testing.T) { + provider := &MockLLMProvider{} + workspace := t.TempDir() + manager := NewSubagentManager(provider, "test-model", workspace) + tool := NewSpawnStatusTool(manager) + + result := tool.Execute(context.Background(), map[string]any{}) + if result.IsError { + t.Fatalf("Expected success, got error: %s", result.ForLLM) + } + if !strings.Contains(result.ForLLM, "No subagents") { + t.Errorf("Expected 'No subagents' message, got: %s", result.ForLLM) + } +} + +func TestSpawnStatusTool_ListAll(t *testing.T) { + provider := &MockLLMProvider{} + workspace := t.TempDir() + manager := NewSubagentManager(provider, "test-model", workspace) + + now := time.Now().UnixMilli() + manager.mu.Lock() + manager.tasks["subagent-1"] = &SubagentTask{ + ID: "subagent-1", + Task: "Do task A", + Label: "task-a", + Status: "running", + Created: now, + } + manager.tasks["subagent-2"] = &SubagentTask{ + ID: "subagent-2", + Task: "Do task B", + Label: "task-b", + Status: "completed", + Result: "Done successfully", + Created: now, + } + manager.tasks["subagent-3"] = &SubagentTask{ + ID: "subagent-3", + Task: "Do task C", + Status: "failed", + Result: "Error: something went wrong", + } + manager.mu.Unlock() + + tool := NewSpawnStatusTool(manager) + result := tool.Execute(context.Background(), map[string]any{}) + + if result.IsError { + t.Fatalf("Expected success, got error: %s", result.ForLLM) + } + + // Summary header + if !strings.Contains(result.ForLLM, "3 total") { + t.Errorf("Expected total count in header, got: %s", result.ForLLM) + } + + // Individual task IDs + for _, id := range []string{"subagent-1", "subagent-2", "subagent-3"} { + if !strings.Contains(result.ForLLM, id) { + t.Errorf("Expected task %s in output, got:\n%s", id, result.ForLLM) + } + } + + // Status values + for _, status := range []string{"running", "completed", "failed"} { + if !strings.Contains(result.ForLLM, status) { + t.Errorf("Expected status '%s' in output, got:\n%s", status, result.ForLLM) + } + } + + // Result content + if !strings.Contains(result.ForLLM, "Done successfully") { + t.Errorf("Expected result text in output, got:\n%s", result.ForLLM) + } +} + +func TestSpawnStatusTool_GetByID(t *testing.T) { + provider := &MockLLMProvider{} + manager := NewSubagentManager(provider, "test-model", "/tmp/test") + + manager.mu.Lock() + manager.tasks["subagent-42"] = &SubagentTask{ + ID: "subagent-42", + Task: "Specific task", + Label: "my-task", + Status: "failed", + Result: "Something went wrong", + Created: time.Now().UnixMilli(), + } + manager.mu.Unlock() + + tool := NewSpawnStatusTool(manager) + result := tool.Execute(context.Background(), map[string]any{"task_id": "subagent-42"}) + + if result.IsError { + t.Fatalf("Expected success, got error: %s", result.ForLLM) + } + if !strings.Contains(result.ForLLM, "subagent-42") { + t.Errorf("Expected task ID in output, got: %s", result.ForLLM) + } + if !strings.Contains(result.ForLLM, "failed") { + t.Errorf("Expected status 'failed' in output, got: %s", result.ForLLM) + } + if !strings.Contains(result.ForLLM, "Something went wrong") { + t.Errorf("Expected result text in output, got: %s", result.ForLLM) + } + if !strings.Contains(result.ForLLM, "my-task") { + t.Errorf("Expected label in output, got: %s", result.ForLLM) + } +} + +func TestSpawnStatusTool_GetByID_NotFound(t *testing.T) { + provider := &MockLLMProvider{} + manager := NewSubagentManager(provider, "test-model", "/tmp/test") + tool := NewSpawnStatusTool(manager) + + result := tool.Execute(context.Background(), map[string]any{"task_id": "nonexistent-999"}) + if !result.IsError { + t.Errorf("Expected error for nonexistent task, got: %s", result.ForLLM) + } + if !strings.Contains(result.ForLLM, "nonexistent-999") { + t.Errorf("Expected task ID in error message, got: %s", result.ForLLM) + } +} + +func TestSpawnStatusTool_TaskID_NonString(t *testing.T) { + provider := &MockLLMProvider{} + manager := NewSubagentManager(provider, "test-model", "/tmp/test") + tool := NewSpawnStatusTool(manager) + + for _, badVal := range []any{42, 3.14, true, map[string]any{"x": 1}, []string{"a"}} { + result := tool.Execute(context.Background(), map[string]any{"task_id": badVal}) + if !result.IsError { + t.Errorf("Expected error for task_id=%T(%v), got success: %s", badVal, badVal, result.ForLLM) + } + if !strings.Contains(result.ForLLM, "task_id must be a string") { + t.Errorf("Expected type-error message, got: %s", result.ForLLM) + } + } +} + +func TestSpawnStatusTool_ResultTruncation(t *testing.T) { + provider := &MockLLMProvider{} + manager := NewSubagentManager(provider, "test-model", "/tmp/test") + + longResult := strings.Repeat("X", 500) + manager.mu.Lock() + manager.tasks["subagent-1"] = &SubagentTask{ + ID: "subagent-1", + Task: "Long task", + Status: "completed", + Result: longResult, + } + manager.mu.Unlock() + + tool := NewSpawnStatusTool(manager) + result := tool.Execute(context.Background(), map[string]any{"task_id": "subagent-1"}) + + if result.IsError { + t.Fatalf("Unexpected error: %s", result.ForLLM) + } + // Output should be shorter than the raw result due to truncation + if len(result.ForLLM) >= len(longResult) { + t.Errorf("Expected result to be truncated, but ForLLM is %d chars", len(result.ForLLM)) + } + if !strings.Contains(result.ForLLM, "…") { + t.Errorf("Expected truncation indicator '…' in output, got: %s", result.ForLLM) + } +} + +func TestSpawnStatusTool_ResultTruncation_Unicode(t *testing.T) { + provider := &MockLLMProvider{} + manager := NewSubagentManager(provider, "test-model", "/tmp/test") + + // Each CJK rune is 3 bytes; 400 runes = 1200 bytes — well over the 300-rune limit. + cjkChar := string(rune(0x5b57)) + longResult := strings.Repeat(cjkChar, 400) + manager.mu.Lock() + manager.tasks["subagent-1"] = &SubagentTask{ + ID: "subagent-1", + Task: "Unicode task", + Status: "completed", + Result: longResult, + } + manager.mu.Unlock() + + tool := NewSpawnStatusTool(manager) + result := tool.Execute(context.Background(), map[string]any{"task_id": "subagent-1"}) + + if result.IsError { + t.Fatalf("Unexpected error: %s", result.ForLLM) + } + if !strings.Contains(result.ForLLM, "…") { + t.Errorf("Expected truncation indicator in output") + } + // The truncated result must be valid UTF-8 (no split rune boundaries). + if !strings.Contains(result.ForLLM, cjkChar) { + t.Errorf("Expected CJK runes to appear intact in output") + } +} + +func TestSpawnStatusTool_StatusCounts(t *testing.T) { + provider := &MockLLMProvider{} + manager := NewSubagentManager(provider, "test-model", "/tmp/test") + + manager.mu.Lock() + for i, status := range []string{"running", "running", "completed", "failed", "canceled"} { + id := fmt.Sprintf("subagent-%d", i+1) + manager.tasks[id] = &SubagentTask{ID: id, Task: "t", Status: status} + } + manager.mu.Unlock() + + tool := NewSpawnStatusTool(manager) + result := tool.Execute(context.Background(), map[string]any{}) + + if result.IsError { + t.Fatalf("Unexpected error: %s", result.ForLLM) + } + // The summary line should mention all statuses that have counts + for _, want := range []string{"Running:", "Completed:", "Failed:", "Canceled:"} { + if !strings.Contains(result.ForLLM, want) { + t.Errorf("Expected %q in summary, got:\n%s", want, result.ForLLM) + } + } +} + +func TestSpawnStatusTool_SortByCreatedTimestamp(t *testing.T) { + provider := &MockLLMProvider{} + manager := NewSubagentManager(provider, "test-model", "/tmp/test") + + now := time.Now().UnixMilli() + manager.mu.Lock() + // Intentionally insert with out-of-order IDs and timestamps that reflect + // true spawn order: subagent-2 was spawned first, subagent-10 second. + manager.tasks["subagent-10"] = &SubagentTask{ + ID: "subagent-10", Task: "second", Status: "running", + Created: now + 1, + } + manager.tasks["subagent-2"] = &SubagentTask{ + ID: "subagent-2", Task: "first", Status: "running", + Created: now, + } + manager.mu.Unlock() + + tool := NewSpawnStatusTool(manager) + result := tool.Execute(context.Background(), map[string]any{}) + + if result.IsError { + t.Fatalf("Unexpected error: %s", result.ForLLM) + } + + pos2 := strings.Index(result.ForLLM, "subagent-2") + pos10 := strings.Index(result.ForLLM, "subagent-10") + if pos2 < 0 || pos10 < 0 { + t.Fatalf("Both task IDs should appear in output:\n%s", result.ForLLM) + } + if pos2 > pos10 { + t.Errorf("Expected subagent-2 (created first) to appear before subagent-10, but got:\n%s", result.ForLLM) + } +} + +func TestSpawnStatusTool_ChannelFiltering_ListAll(t *testing.T) { + provider := &MockLLMProvider{} + manager := NewSubagentManager(provider, "test-model", "/tmp/test") + + manager.mu.Lock() + manager.tasks["subagent-1"] = &SubagentTask{ + ID: "subagent-1", Task: "mine", Status: "running", + OriginChannel: "telegram", OriginChatID: "chat-A", + } + manager.tasks["subagent-2"] = &SubagentTask{ + ID: "subagent-2", Task: "other user", Status: "running", + OriginChannel: "telegram", OriginChatID: "chat-B", + } + manager.mu.Unlock() + + tool := NewSpawnStatusTool(manager) + + // Caller is chat-A — should only see subagent-1. + ctx := WithToolContext(context.Background(), "telegram", "chat-A") + result := tool.Execute(ctx, map[string]any{}) + + if result.IsError { + t.Fatalf("Unexpected error: %s", result.ForLLM) + } + if !strings.Contains(result.ForLLM, "subagent-1") { + t.Errorf("Expected own task in output, got:\n%s", result.ForLLM) + } + if strings.Contains(result.ForLLM, "subagent-2") { + t.Errorf("Should NOT see other chat's task, got:\n%s", result.ForLLM) + } +} + +func TestSpawnStatusTool_ChannelFiltering_GetByID(t *testing.T) { + provider := &MockLLMProvider{} + manager := NewSubagentManager(provider, "test-model", "/tmp/test") + + manager.mu.Lock() + manager.tasks["subagent-99"] = &SubagentTask{ + ID: "subagent-99", Task: "secret", Status: "completed", Result: "private data", + OriginChannel: "slack", OriginChatID: "room-Z", + } + manager.mu.Unlock() + + tool := NewSpawnStatusTool(manager) + + // Different chat trying to look up subagent-99 by ID. + ctx := WithToolContext(context.Background(), "slack", "room-OTHER") + result := tool.Execute(ctx, map[string]any{"task_id": "subagent-99"}) + + if !result.IsError { + t.Errorf("Expected error (cross-chat lookup blocked), got: %s", result.ForLLM) + } +} + +func TestSpawnStatusTool_ChannelFiltering_NoContext(t *testing.T) { + provider := &MockLLMProvider{} + manager := NewSubagentManager(provider, "test-model", "/tmp/test") + + manager.mu.Lock() + manager.tasks["subagent-1"] = &SubagentTask{ + ID: "subagent-1", Task: "t", Status: "completed", + OriginChannel: "telegram", OriginChatID: "chat-A", + } + manager.mu.Unlock() + + tool := NewSpawnStatusTool(manager) + + // No ToolContext injected (e.g. a direct programmatic call that bypasses + // WithToolContext entirely) — callerChannel and callerChatID are both "". + // Note: the normal CLI path uses ProcessDirectWithChannel("cli", "direct"), + // which *does* inject a non-empty context; this test covers the case where + // no context injection happens at all. + // The filter conditions require a non-empty caller value, so all tasks pass through. + result := tool.Execute(context.Background(), map[string]any{}) + if result.IsError { + t.Fatalf("Unexpected error: %s", result.ForLLM) + } + if !strings.Contains(result.ForLLM, "subagent-1") { + t.Errorf("Expected task visible from no-context caller, got:\n%s", result.ForLLM) + } +} diff --git a/pkg/tools/subagent.go b/pkg/tools/subagent.go index e51cbaafa..c37a5ee0f 100644 --- a/pkg/tools/subagent.go +++ b/pkg/tools/subagent.go @@ -109,9 +109,6 @@ func (sm *SubagentManager) Spawn( } func (sm *SubagentManager) runTask(ctx context.Context, task *SubagentTask, callback AsyncCallback) { - task.Status = "running" - task.Created = time.Now().UnixMilli() - // Build system prompt for subagent systemPrompt := `You are a subagent. Complete the given task independently and report the result. You have access to tools - use them as needed to complete your task. @@ -219,6 +216,18 @@ func (sm *SubagentManager) GetTask(taskID string) (*SubagentTask, bool) { return task, ok } +// GetTaskCopy returns a copy of the task with the given ID, taken under the +// read lock, so the caller receives a consistent snapshot with no data race. +func (sm *SubagentManager) GetTaskCopy(taskID string) (SubagentTask, bool) { + sm.mu.RLock() + defer sm.mu.RUnlock() + task, ok := sm.tasks[taskID] + if !ok { + return SubagentTask{}, false + } + return *task, true +} + func (sm *SubagentManager) ListTasks() []*SubagentTask { sm.mu.RLock() defer sm.mu.RUnlock() @@ -230,6 +239,19 @@ func (sm *SubagentManager) ListTasks() []*SubagentTask { return tasks } +// ListTaskCopies returns value copies of all tasks, taken under the read lock, +// so callers receive consistent snapshots with no data race. +func (sm *SubagentManager) ListTaskCopies() []SubagentTask { + sm.mu.RLock() + defer sm.mu.RUnlock() + + copies := make([]SubagentTask, 0, len(sm.tasks)) + for _, task := range sm.tasks { + copies = append(copies, *task) + } + return copies +} + // SubagentTool executes a subagent task synchronously and returns the result. // Unlike SpawnTool which runs tasks asynchronously, SubagentTool waits for completion // and returns the result directly in the ToolResult. diff --git a/web/backend/api/tools.go b/web/backend/api/tools.go index 373a3be12..9df4a7091 100644 --- a/web/backend/api/tools.go +++ b/web/backend/api/tools.go @@ -118,6 +118,12 @@ var toolCatalog = []toolCatalogEntry{ Category: "agents", ConfigKey: "spawn", }, + { + Name: "spawn_status", + Description: "Query the status of spawned subagents.", + Category: "agents", + ConfigKey: "spawn_status", + }, { Name: "i2c", Description: "Interact with I2C hardware devices exposed on the host.", @@ -205,7 +211,7 @@ func buildToolSupport(cfg *config.Config) []toolSupportItem { reasonCode = "requires_skills" } } - case "spawn": + case "spawn", "spawn_status": if cfg.Tools.IsToolEnabled(entry.ConfigKey) { if cfg.Tools.IsToolEnabled("subagent") { status = "enabled" @@ -300,6 +306,12 @@ func applyToolState(cfg *config.Config, toolName string, enabled bool) error { if enabled { cfg.Tools.Subagent.Enabled = true } + case "spawn_status": + cfg.Tools.SpawnStatus.Enabled = enabled + if enabled { + cfg.Tools.Spawn.Enabled = true + cfg.Tools.Subagent.Enabled = true + } case "i2c": cfg.Tools.I2C.Enabled = enabled case "spi": From 0499cdab72ea13f74100b9bcf57d9cf88a4ba1d4 Mon Sep 17 00:00:00 2001 From: wenjie <meetwenjie@gmail.com> Date: Tue, 17 Mar 2026 15:23:49 +0800 Subject: [PATCH 43/56] build: use WEB_GO for web targets and preserve backend dist directory (#1671) Separate web Go commands from the default Go toolchain so web builds, tests, and vet can enable CGO on Darwin without affecting the rest of the project. Also ensure frontend backend builds recreate backend/dist with a .gitkeep file so the embedded output directory remains tracked. --- Makefile | 8 +++++-- web/Makefile | 21 ++++++++++--------- web/frontend/package.json | 2 +- .../scripts/ensure-backend-gitkeep.cjs | 9 ++++++++ 4 files changed, 27 insertions(+), 13 deletions(-) create mode 100644 web/frontend/scripts/ensure-backend-gitkeep.cjs diff --git a/Makefile b/Makefile index 4f4a7a6cb..1c6b73591 100644 --- a/Makefile +++ b/Makefile @@ -16,6 +16,7 @@ LDFLAGS=-X $(CONFIG_PKG).Version=$(VERSION) -X $(CONFIG_PKG).GitCommit=$(GIT_COM # Go variables GO?=CGO_ENABLED=0 go +WEB_GO?=$(GO) GOFLAGS?=-v -tags stdjson # Patch MIPS LE ELF e_flags (offset 36) for NaN2008-only kernels (e.g. Ingenic X2600). @@ -79,6 +80,7 @@ ifeq ($(UNAME_S),Linux) endif else ifeq ($(UNAME_S),Darwin) PLATFORM=darwin + WEB_GO=CGO_ENABLED=1 go ifeq ($(UNAME_M),x86_64) ARCH=amd64 else ifeq ($(UNAME_M),arm64) @@ -119,7 +121,7 @@ build-launcher: echo "Building frontend..."; \ cd web/frontend && pnpm install && pnpm build:backend; \ fi - @$(GO) build $(GOFLAGS) -o $(BUILD_DIR)/picoclaw-launcher-$(PLATFORM)-$(ARCH) ./web/backend + @$(WEB_GO) build $(GOFLAGS) -o $(BUILD_DIR)/picoclaw-launcher-$(PLATFORM)-$(ARCH) ./web/backend @ln -sf picoclaw-launcher-$(PLATFORM)-$(ARCH) $(BUILD_DIR)/picoclaw-launcher @echo "Build complete: $(BUILD_DIR)/picoclaw-launcher" @@ -219,7 +221,9 @@ clean: ## vet: Run go vet for static analysis vet: generate - @$(GO) vet ./... + @packages="$$(go list ./...)" && \ + $(GO) vet $$(printf '%s\n' "$$packages" | grep -v '^github.com/sipeed/picoclaw/web/') + @cd web/backend && $(WEB_GO) vet ./... ## test: Test Go code test: generate diff --git a/web/Makefile b/web/Makefile index 653dd77e1..5943924f2 100644 --- a/web/Makefile +++ b/web/Makefile @@ -1,17 +1,18 @@ .PHONY: dev dev-frontend dev-backend build test lint clean +# Go variables +GO?=CGO_ENABLED=0 go +WEB_GO?=$(GO) +GOFLAGS?=-v -tags stdjson + # Version VERSION?=$(shell git describe --tags --always --dirty 2>/dev/null || echo "dev") GIT_COMMIT=$(shell git rev-parse --short=8 HEAD 2>/dev/null || echo "dev") BUILD_TIME=$(shell date +%FT%T%z) -GO_VERSION=$(shell $(GO) version | awk '{print $$3}') +GO_VERSION=$(shell $(WEB_GO) version | awk '{print $$3}') CONFIG_PKG=github.com/sipeed/picoclaw/pkg/config LDFLAGS=-X $(CONFIG_PKG).Version=$(VERSION) -X $(CONFIG_PKG).GitCommit=$(GIT_COMMIT) -X $(CONFIG_PKG).BuildTime=$(BUILD_TIME) -X $(CONFIG_PKG).GoVersion=$(GO_VERSION) -s -w -# Go variables -GO?=CGO_ENABLED=0 go -GOFLAGS?=-v -tags stdjson - # OS detection UNAME_S:=$(shell uname -s) @@ -37,7 +38,7 @@ ifeq ($(UNAME_S),Linux) endif else ifeq ($(UNAME_S),Darwin) PLATFORM=darwin - GO=CGO_ENABLED=1 go + WEB_GO=CGO_ENABLED=1 go ifeq ($(UNAME_M),x86_64) ARCH=amd64 else ifeq ($(UNAME_M),arm64) @@ -69,21 +70,21 @@ dev-frontend: # Start backend dev server dev-backend: - cd backend && ${GO} run -ldflags "$(LDFLAGS)" . + cd backend && ${WEB_GO} run -ldflags "$(LDFLAGS)" . # Build frontend and embed into Go binary build: cd frontend && pnpm build:backend - cd backend && ${GO} build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o picoclaw-web . + cd backend && ${WEB_GO} build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o picoclaw-web . # Run all tests test: - cd backend && ${GO} test ./... + cd backend && ${WEB_GO} test ./... cd frontend && pnpm lint # Lint and format lint: - cd backend && ${GO} vet ./... + cd backend && ${WEB_GO} vet ./... cd frontend && pnpm check # Clean build artifacts diff --git a/web/frontend/package.json b/web/frontend/package.json index 973586519..2e0e37117 100644 --- a/web/frontend/package.json +++ b/web/frontend/package.json @@ -6,7 +6,7 @@ "scripts": { "dev": "vite", "build": "tsc -b && vite build", - "build:backend": "tsc -b && vite build --outDir ../backend/dist --emptyOutDir", + "build:backend": "tsc -b && vite build --outDir ../backend/dist --emptyOutDir && node ./scripts/ensure-backend-gitkeep.cjs", "lint": "eslint .", "preview": "vite preview", "format": "prettier --check .", diff --git a/web/frontend/scripts/ensure-backend-gitkeep.cjs b/web/frontend/scripts/ensure-backend-gitkeep.cjs new file mode 100644 index 000000000..db9782ab4 --- /dev/null +++ b/web/frontend/scripts/ensure-backend-gitkeep.cjs @@ -0,0 +1,9 @@ +const fs = require("node:fs") +const path = require("node:path") + +const gitkeepPath = path.resolve(__dirname, "../../backend/dist/.gitkeep") +const gitkeepContents = + "# Keep the embedded web backend dist directory in version control.\n" + +fs.mkdirSync(path.dirname(gitkeepPath), { recursive: true }) +fs.writeFileSync(gitkeepPath, gitkeepContents) From 11207186c8d99e4286ad8fb8a6e3c7dee0974c05 Mon Sep 17 00:00:00 2001 From: Liu Yuan <namei.unix@gmail.com> Date: Tue, 17 Mar 2026 17:36:06 +0800 Subject: [PATCH 44/56] fix: proxy WebSocket through web server port (#1665) - Modify buildWsURL to use web server port (18800) instead of gateway port (18790) - Add WebSocket proxy handler to forward /pico/ws to gateway - Gateway port is read from config (cfg.Gateway.Port), defaults to 18790 - This allows WebSocket connections through the same port as the web UI, avoiding the need to expose extra ports for Tailscale/Docker --- web/backend/api/gateway_host.go | 8 ++++++- web/backend/api/gateway_host_test.go | 16 ++++++------- web/backend/api/pico.go | 35 ++++++++++++++++++++++++++++ 3 files changed, 50 insertions(+), 9 deletions(-) diff --git a/web/backend/api/gateway_host.go b/web/backend/api/gateway_host.go index 5ef3ba2c5..8dde29b76 100644 --- a/web/backend/api/gateway_host.go +++ b/web/backend/api/gateway_host.go @@ -80,5 +80,11 @@ func (h *Handler) buildWsURL(r *http.Request, cfg *config.Config) string { if host == "" || host == "0.0.0.0" { host = requestHostName(r) } - return requestWSScheme(r) + "://" + net.JoinHostPort(host, strconv.Itoa(cfg.Gateway.Port)) + "/pico/ws" + // Use web server port instead of gateway port to avoid exposing extra ports + // The WebSocket connection will be proxied by the backend to the gateway + wsPort := h.serverPort + if wsPort == 0 { + wsPort = 18800 // default web server port + } + return requestWSScheme(r) + "://" + net.JoinHostPort(host, strconv.Itoa(wsPort)) + "/pico/ws" } diff --git a/web/backend/api/gateway_host_test.go b/web/backend/api/gateway_host_test.go index 43e84ff0e..3fffeb893 100644 --- a/web/backend/api/gateway_host_test.go +++ b/web/backend/api/gateway_host_test.go @@ -48,8 +48,8 @@ func TestBuildWsURLUsesRequestHostWhenLauncherPublicSaved(t *testing.T) { req := httptest.NewRequest("GET", "http://launcher.local/api/pico/token", nil) req.Host = "192.168.1.9:18800" - if got := h.buildWsURL(req, cfg); got != "ws://192.168.1.9:18790/pico/ws" { - t.Fatalf("buildWsURL() = %q, want %q", got, "ws://192.168.1.9:18790/pico/ws") + if got := h.buildWsURL(req, cfg); got != "ws://192.168.1.9:18800/pico/ws" { + t.Fatalf("buildWsURL() = %q, want %q", got, "ws://192.168.1.9:18800/pico/ws") } } @@ -71,8 +71,8 @@ func TestBuildWsURLUsesWSSWhenForwardedProtoIsHTTPS(t *testing.T) { req.Host = "chat.example.com" req.Header.Set("X-Forwarded-Proto", "https") - if got := h.buildWsURL(req, cfg); got != "wss://chat.example.com:18790/pico/ws" { - t.Fatalf("buildWsURL() = %q, want %q", got, "wss://chat.example.com:18790/pico/ws") + if got := h.buildWsURL(req, cfg); got != "wss://chat.example.com:18800/pico/ws" { + t.Fatalf("buildWsURL() = %q, want %q", got, "wss://chat.example.com:18800/pico/ws") } } @@ -88,8 +88,8 @@ func TestBuildWsURLUsesWSSWhenRequestIsTLS(t *testing.T) { req.Host = "secure.example.com" req.TLS = &tls.ConnectionState{} - if got := h.buildWsURL(req, cfg); got != "wss://secure.example.com:18790/pico/ws" { - t.Fatalf("buildWsURL() = %q, want %q", got, "wss://secure.example.com:18790/pico/ws") + if got := h.buildWsURL(req, cfg); got != "wss://secure.example.com:18800/pico/ws" { + t.Fatalf("buildWsURL() = %q, want %q", got, "wss://secure.example.com:18800/pico/ws") } } @@ -106,7 +106,7 @@ func TestBuildWsURLPrefersForwardedHTTPOverTLS(t *testing.T) { req.TLS = &tls.ConnectionState{} req.Header.Set("X-Forwarded-Proto", "http") - if got := h.buildWsURL(req, cfg); got != "ws://chat.example.com:18790/pico/ws" { - t.Fatalf("buildWsURL() = %q, want %q", got, "ws://chat.example.com:18790/pico/ws") + if got := h.buildWsURL(req, cfg); got != "ws://chat.example.com:18800/pico/ws" { + t.Fatalf("buildWsURL() = %q, want %q", got, "ws://chat.example.com:18800/pico/ws") } } diff --git a/web/backend/api/pico.go b/web/backend/api/pico.go index 2d2201e16..d11f7bc5e 100644 --- a/web/backend/api/pico.go +++ b/web/backend/api/pico.go @@ -6,6 +6,8 @@ import ( "encoding/json" "fmt" "net/http" + "net/http/httputil" + "net/url" "time" "github.com/sipeed/picoclaw/pkg/config" @@ -16,6 +18,39 @@ func (h *Handler) registerPicoRoutes(mux *http.ServeMux) { mux.HandleFunc("GET /api/pico/token", h.handleGetPicoToken) mux.HandleFunc("POST /api/pico/token", h.handleRegenPicoToken) mux.HandleFunc("POST /api/pico/setup", h.handlePicoSetup) + + // WebSocket proxy: forward /pico/ws to gateway + // This allows the frontend to connect via the same port as the web UI, + // avoiding the need to expose extra ports for WebSocket communication. + wsProxy := h.createWsProxy() + mux.HandleFunc("GET /pico/ws", h.handleWebSocketProxy(wsProxy)) +} + +// createWsProxy creates a reverse proxy to the gateway WebSocket endpoint. +// The gateway port is read from the configuration. +func (h *Handler) createWsProxy() *httputil.ReverseProxy { + cfg, err := config.LoadConfig(h.configPath) + gatewayPort := 18790 // default + if err == nil && cfg.Gateway.Port != 0 { + gatewayPort = cfg.Gateway.Port + } + gatewayURL, _ := url.Parse(fmt.Sprintf("http://127.0.0.1:%d", gatewayPort)) + wsProxy := httputil.NewSingleHostReverseProxy(gatewayURL) + wsProxy.ErrorHandler = func(w http.ResponseWriter, r *http.Request, err error) { + http.Error(w, "Gateway unavailable: "+err.Error(), http.StatusBadGateway) + } + return wsProxy +} + +// handleWebSocketProxy wraps a reverse proxy to handle WebSocket connections. +// It ensures the Connection and Upgrade headers are properly forwarded. +func (h *Handler) handleWebSocketProxy(proxy *httputil.ReverseProxy) http.HandlerFunc { + return func(w http.ResponseWriter, r *http.Request) { + // Set headers for WebSocket upgrade + r.Header.Set("Connection", "upgrade") + r.Header.Set("Upgrade", "websocket") + proxy.ServeHTTP(w, r) + } } // handleGetPicoToken returns the current WS token and URL for the frontend. From 8a44410e378b8a4e7789e2b3941001f4bddd5ad3 Mon Sep 17 00:00:00 2001 From: wenjie <meetwenjie@gmail.com> Date: Tue, 17 Mar 2026 18:46:00 +0800 Subject: [PATCH 45/56] feat: add web gateway hot reload and polling state sync (#1684) * feat(gateway): support hot reload and empty startup - extract gateway runtime into pkg/gateway - add gateway.hot_reload config with default and example values - allow starting the gateway without a default model via --allow-empty - stop treating missing enabled channels as a startup error - update related tests * feat: replace gateway SSE updates with polling-based state sync - remove gateway SSE broadcasting and event endpoint - add polling-based gateway status refresh with stopping state handling - detect when gateway restart is required after default model changes - resolve gateway health and websocket proxy targets from configured host - update gateway UI labels and add backend/frontend test coverage --- cmd/picoclaw/internal/gateway/command.go | 12 +- cmd/picoclaw/internal/gateway/command_test.go | 1 + config/config.example.json | 3 +- pkg/channels/manager.go | 1 - pkg/config/config.go | 5 +- pkg/config/config_test.go | 3 + pkg/config/defaults.go | 5 +- .../helpers.go => pkg/gateway/gateway.go | 262 ++++++++---------- web/backend/api/events.go | 80 ------ web/backend/api/gateway.go | 209 ++++---------- web/backend/api/gateway_host.go | 18 ++ web/backend/api/gateway_host_test.go | 76 +++++ web/backend/api/gateway_test.go | 129 +++++++++ web/backend/api/pico.go | 24 +- web/backend/api/pico_test.go | 77 +++++ web/backend/api/router.go | 5 +- web/backend/middleware/middleware.go | 5 +- web/backend/systray.go | 2 +- web/frontend/src/components/app-header.tsx | 34 ++- web/frontend/src/hooks/use-gateway-logs.ts | 4 +- web/frontend/src/hooks/use-gateway.ts | 138 ++------- web/frontend/src/i18n/locales/en.json | 3 +- web/frontend/src/i18n/locales/zh.json | 3 +- web/frontend/src/store/gateway.ts | 144 +++++++++- 24 files changed, 700 insertions(+), 543 deletions(-) rename cmd/picoclaw/internal/gateway/helpers.go => pkg/gateway/gateway.go (61%) delete mode 100644 web/backend/api/events.go diff --git a/cmd/picoclaw/internal/gateway/command.go b/cmd/picoclaw/internal/gateway/command.go index bfa69f072..4812f1bee 100644 --- a/cmd/picoclaw/internal/gateway/command.go +++ b/cmd/picoclaw/internal/gateway/command.go @@ -5,6 +5,8 @@ import ( "github.com/spf13/cobra" + "github.com/sipeed/picoclaw/cmd/picoclaw/internal" + "github.com/sipeed/picoclaw/pkg/gateway" "github.com/sipeed/picoclaw/pkg/logger" "github.com/sipeed/picoclaw/pkg/utils" ) @@ -12,6 +14,7 @@ import ( func NewGatewayCommand() *cobra.Command { var debug bool var noTruncate bool + var allowEmpty bool cmd := &cobra.Command{ Use: "gateway", @@ -31,12 +34,19 @@ func NewGatewayCommand() *cobra.Command { return nil }, RunE: func(_ *cobra.Command, _ []string) error { - return gatewayCmd(debug) + return gateway.Run(debug, internal.GetConfigPath(), allowEmpty) }, } cmd.Flags().BoolVarP(&debug, "debug", "d", false, "Enable debug logging") cmd.Flags().BoolVarP(&noTruncate, "no-truncate", "T", false, "Disable string truncation in debug logs") + cmd.Flags().BoolVarP( + &allowEmpty, + "allow-empty", + "E", + false, + "Continue starting even when no default model is configured", + ) return cmd } diff --git a/cmd/picoclaw/internal/gateway/command_test.go b/cmd/picoclaw/internal/gateway/command_test.go index 4d591ea67..839a7315a 100644 --- a/cmd/picoclaw/internal/gateway/command_test.go +++ b/cmd/picoclaw/internal/gateway/command_test.go @@ -28,4 +28,5 @@ func TestNewGatewayCommand(t *testing.T) { assert.True(t, cmd.HasFlags()) assert.NotNil(t, cmd.Flags().Lookup("debug")) + assert.NotNil(t, cmd.Flags().Lookup("allow-empty")) } diff --git a/config/config.example.json b/config/config.example.json index 1c11cd42a..14e209259 100644 --- a/config/config.example.json +++ b/config/config.example.json @@ -518,6 +518,7 @@ }, "gateway": { "host": "127.0.0.1", - "port": 18790 + "port": 18790, + "hot_reload": false } } diff --git a/pkg/channels/manager.go b/pkg/channels/manager.go index df430e4d3..8121525ab 100644 --- a/pkg/channels/manager.go +++ b/pkg/channels/manager.go @@ -357,7 +357,6 @@ func (m *Manager) StartAll(ctx context.Context) error { if len(m.channels) == 0 { logger.WarnC("channels", "No channels enabled") - return errors.New("no channels enabled") } logger.InfoC("channels", "Starting all channels") diff --git a/pkg/config/config.go b/pkg/config/config.go index 35de48f23..6694ef3a1 100644 --- a/pkg/config/config.go +++ b/pkg/config/config.go @@ -625,8 +625,9 @@ func (c *ModelConfig) Validate() error { } type GatewayConfig struct { - Host string `json:"host" env:"PICOCLAW_GATEWAY_HOST"` - Port int `json:"port" env:"PICOCLAW_GATEWAY_PORT"` + Host string `json:"host" env:"PICOCLAW_GATEWAY_HOST"` + Port int `json:"port" env:"PICOCLAW_GATEWAY_PORT"` + HotReload bool `json:"hot_reload" env:"PICOCLAW_GATEWAY_HOT_RELOAD"` } type ToolDiscoveryConfig struct { diff --git a/pkg/config/config_test.go b/pkg/config/config_test.go index fc835f78f..f4f8979e1 100644 --- a/pkg/config/config_test.go +++ b/pkg/config/config_test.go @@ -267,6 +267,9 @@ func TestDefaultConfig_Gateway(t *testing.T) { if cfg.Gateway.Port == 0 { t.Error("Gateway port should have default value") } + if cfg.Gateway.HotReload { + t.Error("Gateway hot reload should be disabled by default") + } } // TestDefaultConfig_Providers verifies provider structure diff --git a/pkg/config/defaults.go b/pkg/config/defaults.go index 2b177d5de..90a99408e 100644 --- a/pkg/config/defaults.go +++ b/pkg/config/defaults.go @@ -395,8 +395,9 @@ func DefaultConfig() *Config { }, }, Gateway: GatewayConfig{ - Host: "127.0.0.1", - Port: 18790, + Host: "127.0.0.1", + Port: 18790, + HotReload: false, }, Tools: ToolsConfig{ MediaCleanup: MediaCleanupConfig{ diff --git a/cmd/picoclaw/internal/gateway/helpers.go b/pkg/gateway/gateway.go similarity index 61% rename from cmd/picoclaw/internal/gateway/helpers.go rename to pkg/gateway/gateway.go index 85e93bcf9..6745d1748 100644 --- a/cmd/picoclaw/internal/gateway/helpers.go +++ b/pkg/gateway/gateway.go @@ -10,7 +10,6 @@ import ( "syscall" "time" - "github.com/sipeed/picoclaw/cmd/picoclaw/internal" "github.com/sipeed/picoclaw/pkg/agent" "github.com/sipeed/picoclaw/pkg/bus" "github.com/sipeed/picoclaw/pkg/channels" @@ -42,15 +41,13 @@ import ( "github.com/sipeed/picoclaw/pkg/voice" ) -// Timeout constants for service operations const ( serviceShutdownTimeout = 30 * time.Second providerReloadTimeout = 30 * time.Second gracefulShutdownTimeout = 15 * time.Second ) -// gatewayServices holds references to all running services -type gatewayServices struct { +type services struct { CronService *cron.CronService HeartbeatService *heartbeat.HeartbeatService MediaStore media.MediaStore @@ -59,24 +56,41 @@ type gatewayServices struct { HealthServer *health.Server } -func gatewayCmd(debug bool) error { +type startupBlockedProvider struct { + reason string +} + +func (p *startupBlockedProvider) Chat( + _ context.Context, + _ []providers.Message, + _ []providers.ToolDefinition, + _ string, + _ map[string]any, +) (*providers.LLMResponse, error) { + return nil, fmt.Errorf("%s", p.reason) +} + +func (p *startupBlockedProvider) GetDefaultModel() string { + return "" +} + +// Run starts the gateway runtime using the configuration loaded from configPath. +func Run(debug bool, configPath string, allowEmptyStartup bool) error { if debug { logger.SetLevel(logger.DEBUG) fmt.Println("🔍 Debug mode enabled") } - configPath := internal.GetConfigPath() - cfg, err := internal.LoadConfig() + cfg, err := config.LoadConfig(configPath) if err != nil { return fmt.Errorf("error loading config: %w", err) } - provider, modelID, err := providers.CreateProvider(cfg) + provider, modelID, err := createStartupProvider(cfg, allowEmptyStartup) if err != nil { return fmt.Errorf("error creating provider: %w", err) } - // Use the resolved model ID from provider creation if modelID != "" { cfg.Agents.Defaults.ModelName = modelID } @@ -84,17 +98,13 @@ func gatewayCmd(debug bool) error { msgBus := bus.NewMessageBus() agentLoop := agent.NewAgentLoop(cfg, msgBus, provider) - // Print agent startup info fmt.Println("\n📦 Agent Status:") startupInfo := agentLoop.GetStartupInfo() toolsInfo := startupInfo["tools"].(map[string]any) skillsInfo := startupInfo["skills"].(map[string]any) fmt.Printf(" • Tools: %d loaded\n", toolsInfo["count"]) - fmt.Printf(" • Skills: %d/%d available\n", - skillsInfo["available"], - skillsInfo["total"]) + fmt.Printf(" • Skills: %d/%d available\n", skillsInfo["available"], skillsInfo["total"]) - // Log to file as well logger.InfoCF("agent", "Agent initialized", map[string]any{ "tools_count": toolsInfo["count"], @@ -102,8 +112,7 @@ func gatewayCmd(debug bool) error { "skills_available": skillsInfo["available"], }) - // Setup and start all services - services, err := setupAndStartServices(cfg, agentLoop, msgBus) + runningServices, err := setupAndStartServices(cfg, agentLoop, msgBus) if err != nil { return err } @@ -116,23 +125,25 @@ func gatewayCmd(debug bool) error { go agentLoop.Run(ctx) - // Setup config file watcher for hot reload - configReloadChan, stopWatch := setupConfigWatcherPolling(configPath, debug) + var configReloadChan <-chan *config.Config + stopWatch := func() {} + if cfg.Gateway.HotReload { + configReloadChan, stopWatch = setupConfigWatcherPolling(configPath, debug) + logger.Info("Config hot reload enabled") + } defer stopWatch() sigChan := make(chan os.Signal, 1) signal.Notify(sigChan, os.Interrupt, syscall.SIGTERM) - // Main event loop - wait for signals or config changes for { select { case <-sigChan: logger.Info("Shutting down...") - shutdownGateway(services, agentLoop, provider, true) + shutdownGateway(runningServices, agentLoop, provider, true) return nil - case newCfg := <-configReloadChan: - err := handleConfigReload(ctx, agentLoop, newCfg, &provider, services, msgBus) + err := handleConfigReload(ctx, agentLoop, newCfg, &provider, runningServices, msgBus, allowEmptyStartup) if err != nil { logger.Errorf("Config reload failed: %v", err) } @@ -140,18 +151,33 @@ func gatewayCmd(debug bool) error { } } -// setupAndStartServices initializes and starts all services +func createStartupProvider( + cfg *config.Config, + allowEmptyStartup bool, +) (providers.LLMProvider, string, error) { + modelName := cfg.Agents.Defaults.GetModelName() + if modelName == "" && allowEmptyStartup { + reason := "no default model configured; gateway started in limited mode" + fmt.Printf("⚠ Warning: %s\n", reason) + logger.WarnCF("gateway", "Gateway started without default model", map[string]any{ + "limited_mode": true, + }) + return &startupBlockedProvider{reason: reason}, "", nil + } + + return providers.CreateProvider(cfg) +} + func setupAndStartServices( cfg *config.Config, agentLoop *agent.AgentLoop, msgBus *bus.MessageBus, -) (*gatewayServices, error) { - services := &gatewayServices{} +) (*services, error) { + runningServices := &services{} - // Setup cron tool and service execTimeout := time.Duration(cfg.Tools.Cron.ExecTimeoutMinutes) * time.Minute var err error - services.CronService, err = setupCronTool( + runningServices.CronService, err = setupCronTool( agentLoop, msgBus, cfg.WorkspacePath(), @@ -162,120 +188,105 @@ func setupAndStartServices( if err != nil { return nil, fmt.Errorf("error setting up cron service: %w", err) } - if err = services.CronService.Start(); err != nil { + if err = runningServices.CronService.Start(); err != nil { return nil, fmt.Errorf("error starting cron service: %w", err) } fmt.Println("✓ Cron service started") - // Setup heartbeat service - services.HeartbeatService = heartbeat.NewHeartbeatService( + runningServices.HeartbeatService = heartbeat.NewHeartbeatService( cfg.WorkspacePath(), cfg.Heartbeat.Interval, cfg.Heartbeat.Enabled, ) - services.HeartbeatService.SetBus(msgBus) - services.HeartbeatService.SetHandler(createHeartbeatHandler(agentLoop)) - if err = services.HeartbeatService.Start(); err != nil { + runningServices.HeartbeatService.SetBus(msgBus) + runningServices.HeartbeatService.SetHandler(createHeartbeatHandler(agentLoop)) + if err = runningServices.HeartbeatService.Start(); err != nil { return nil, fmt.Errorf("error starting heartbeat service: %w", err) } fmt.Println("✓ Heartbeat service started") - // Create media store for file lifecycle management with TTL cleanup - services.MediaStore = media.NewFileMediaStoreWithCleanup(media.MediaCleanerConfig{ + runningServices.MediaStore = media.NewFileMediaStoreWithCleanup(media.MediaCleanerConfig{ Enabled: cfg.Tools.MediaCleanup.Enabled, MaxAge: time.Duration(cfg.Tools.MediaCleanup.MaxAge) * time.Minute, Interval: time.Duration(cfg.Tools.MediaCleanup.Interval) * time.Minute, }) - // Start the media store if it's a FileMediaStore with cleanup - if fms, ok := services.MediaStore.(*media.FileMediaStore); ok { + if fms, ok := runningServices.MediaStore.(*media.FileMediaStore); ok { fms.Start() } - // Create channel manager - services.ChannelManager, err = channels.NewManager(cfg, msgBus, services.MediaStore) + runningServices.ChannelManager, err = channels.NewManager(cfg, msgBus, runningServices.MediaStore) if err != nil { - // Stop the media store if it's a FileMediaStore with cleanup - if fms, ok := services.MediaStore.(*media.FileMediaStore); ok { + if fms, ok := runningServices.MediaStore.(*media.FileMediaStore); ok { fms.Stop() } return nil, fmt.Errorf("error creating channel manager: %w", err) } - // Inject channel manager and media store into agent loop - agentLoop.SetChannelManager(services.ChannelManager) - agentLoop.SetMediaStore(services.MediaStore) + agentLoop.SetChannelManager(runningServices.ChannelManager) + agentLoop.SetMediaStore(runningServices.MediaStore) - // Wire up voice transcription if a supported provider is configured. if transcriber := voice.DetectTranscriber(cfg); transcriber != nil { agentLoop.SetTranscriber(transcriber) logger.InfoCF("voice", "Transcription enabled (agent-level)", map[string]any{"provider": transcriber.Name()}) } - enabledChannels := services.ChannelManager.GetEnabledChannels() + enabledChannels := runningServices.ChannelManager.GetEnabledChannels() if len(enabledChannels) > 0 { fmt.Printf("✓ Channels enabled: %s\n", enabledChannels) } else { fmt.Println("⚠ Warning: No channels enabled") } - // Setup shared HTTP server with health endpoints and webhook handlers addr := fmt.Sprintf("%s:%d", cfg.Gateway.Host, cfg.Gateway.Port) - services.HealthServer = health.NewServer(cfg.Gateway.Host, cfg.Gateway.Port) - services.ChannelManager.SetupHTTPServer(addr, services.HealthServer) + runningServices.HealthServer = health.NewServer(cfg.Gateway.Host, cfg.Gateway.Port) + runningServices.ChannelManager.SetupHTTPServer(addr, runningServices.HealthServer) - if err = services.ChannelManager.StartAll(context.Background()); err != nil { + if err = runningServices.ChannelManager.StartAll(context.Background()); err != nil { return nil, fmt.Errorf("error starting channels: %w", err) } fmt.Printf("✓ Health endpoints available at http://%s:%d/health and /ready\n", cfg.Gateway.Host, cfg.Gateway.Port) - // Setup state manager and device service stateManager := state.NewManager(cfg.WorkspacePath()) - services.DeviceService = devices.NewService(devices.Config{ + runningServices.DeviceService = devices.NewService(devices.Config{ Enabled: cfg.Devices.Enabled, MonitorUSB: cfg.Devices.MonitorUSB, }, stateManager) - services.DeviceService.SetBus(msgBus) - if err = services.DeviceService.Start(context.Background()); err != nil { + runningServices.DeviceService.SetBus(msgBus) + if err = runningServices.DeviceService.Start(context.Background()); err != nil { logger.ErrorCF("device", "Error starting device service", map[string]any{"error": err.Error()}) } else if cfg.Devices.Enabled { fmt.Println("✓ Device event service started") } - return services, nil + return runningServices, nil } -// stopAndCleanupServices stops all services and cleans up resources -func stopAndCleanupServices( - services *gatewayServices, - shutdownTimeout time.Duration, -) { +func stopAndCleanupServices(runningServices *services, shutdownTimeout time.Duration) { shutdownCtx, shutdownCancel := context.WithTimeout(context.Background(), shutdownTimeout) defer shutdownCancel() - if services.ChannelManager != nil { - services.ChannelManager.StopAll(shutdownCtx) + if runningServices.ChannelManager != nil { + runningServices.ChannelManager.StopAll(shutdownCtx) } - if services.DeviceService != nil { - services.DeviceService.Stop() + if runningServices.DeviceService != nil { + runningServices.DeviceService.Stop() } - if services.HeartbeatService != nil { - services.HeartbeatService.Stop() + if runningServices.HeartbeatService != nil { + runningServices.HeartbeatService.Stop() } - if services.CronService != nil { - services.CronService.Stop() + if runningServices.CronService != nil { + runningServices.CronService.Stop() } - if services.MediaStore != nil { - // Stop the media store if it's a FileMediaStore with cleanup - if fms, ok := services.MediaStore.(*media.FileMediaStore); ok { + if runningServices.MediaStore != nil { + if fms, ok := runningServices.MediaStore.(*media.FileMediaStore); ok { fms.Stop() } } } -// shutdownGateway performs a complete gateway shutdown func shutdownGateway( - services *gatewayServices, + runningServices *services, agentLoop *agent.AgentLoop, provider providers.LLMProvider, fullShutdown bool, @@ -284,7 +295,7 @@ func shutdownGateway( cp.Close() } - stopAndCleanupServices(services, gracefulShutdownTimeout) + stopAndCleanupServices(runningServices, gracefulShutdownTimeout) agentLoop.Stop() agentLoop.Close() @@ -292,15 +303,14 @@ func shutdownGateway( logger.Info("✓ Gateway stopped") } -// handleConfigReload handles config file reload by stopping all services, -// reloading the provider and config, and restarting services with the new config. func handleConfigReload( ctx context.Context, al *agent.AgentLoop, newCfg *config.Config, providerRef *providers.LLMProvider, - services *gatewayServices, + runningServices *services, msgBus *bus.MessageBus, + allowEmptyStartup bool, ) error { logger.Info("🔄 Config file changed, reloading...") @@ -311,18 +321,14 @@ func handleConfigReload( logger.Infof(" New model is '%s', recreating provider...", newModel) - // Stop all services before reloading logger.Info(" Stopping all services...") - stopAndCleanupServices(services, serviceShutdownTimeout) + stopAndCleanupServices(runningServices, serviceShutdownTimeout) - // Create new provider from updated config first to ensure validity - // This will use the correct API key and settings from newCfg.ModelList - newProvider, newModelID, err := providers.CreateProvider(newCfg) + newProvider, newModelID, err := createStartupProvider(newCfg, allowEmptyStartup) if err != nil { logger.Errorf(" ⚠ Error creating new provider: %v", err) logger.Warn(" Attempting to restart services with old provider and config...") - // Try to restart services with old configuration - if restartErr := restartServices(al, services, msgBus); restartErr != nil { + if restartErr := restartServices(al, runningServices, msgBus); restartErr != nil { logger.Errorf(" ⚠ Failed to restart services: %v", restartErr) } return fmt.Errorf("error creating new provider: %w", err) @@ -332,31 +338,25 @@ func handleConfigReload( newCfg.Agents.Defaults.ModelName = newModelID } - // Use the atomic reload method on AgentLoop to safely swap provider and config. - // This handles locking internally to prevent races with in-flight LLM calls - // and concurrent reads of registry/config while the swap occurs. reloadCtx, reloadCancel := context.WithTimeout(context.Background(), providerReloadTimeout) defer reloadCancel() if err := al.ReloadProviderAndConfig(reloadCtx, newProvider, newCfg); err != nil { logger.Errorf(" ⚠ Error reloading agent loop: %v", err) - // Close the newly created provider since it wasn't adopted if cp, ok := newProvider.(providers.StatefulProvider); ok { cp.Close() } logger.Warn(" Attempting to restart services with old provider and config...") - if restartErr := restartServices(al, services, msgBus); restartErr != nil { + if restartErr := restartServices(al, runningServices, msgBus); restartErr != nil { logger.Errorf(" ⚠ Failed to restart services: %v", restartErr) } return fmt.Errorf("error reloading agent loop: %w", err) } - // Update local provider reference only after successful atomic reload *providerRef = newProvider - // Restart all services with new config logger.Info(" Restarting all services with new configuration...") - if err := restartServices(al, services, msgBus); err != nil { + if err := restartServices(al, runningServices, msgBus); err != nil { logger.Errorf(" ⚠ Error restarting services: %v", err) return fmt.Errorf("error restarting services: %w", err) } @@ -365,19 +365,16 @@ func handleConfigReload( return nil } -// restartServices restarts all services after a config reload func restartServices( al *agent.AgentLoop, - services *gatewayServices, + runningServices *services, msgBus *bus.MessageBus, ) error { - // Get current config from agent loop (which has been updated if this is a reload) cfg := al.GetConfig() - // Re-create and start cron service with new config execTimeout := time.Duration(cfg.Tools.Cron.ExecTimeoutMinutes) * time.Minute var err error - services.CronService, err = setupCronTool( + runningServices.CronService, err = setupCronTool( al, msgBus, cfg.WorkspacePath(), @@ -388,57 +385,51 @@ func restartServices( if err != nil { return fmt.Errorf("error restarting cron service: %w", err) } - if err = services.CronService.Start(); err != nil { + if err = runningServices.CronService.Start(); err != nil { return fmt.Errorf("error restarting cron service: %w", err) } fmt.Println(" ✓ Cron service restarted") - // Re-create and start heartbeat service with new config - services.HeartbeatService = heartbeat.NewHeartbeatService( + runningServices.HeartbeatService = heartbeat.NewHeartbeatService( cfg.WorkspacePath(), cfg.Heartbeat.Interval, cfg.Heartbeat.Enabled, ) - services.HeartbeatService.SetBus(msgBus) - services.HeartbeatService.SetHandler(createHeartbeatHandler(al)) - if err = services.HeartbeatService.Start(); err != nil { + runningServices.HeartbeatService.SetBus(msgBus) + runningServices.HeartbeatService.SetHandler(createHeartbeatHandler(al)) + if err = runningServices.HeartbeatService.Start(); err != nil { return fmt.Errorf("error restarting heartbeat service: %w", err) } fmt.Println(" ✓ Heartbeat service restarted") - // Re-create media store with new config - services.MediaStore = media.NewFileMediaStoreWithCleanup(media.MediaCleanerConfig{ + runningServices.MediaStore = media.NewFileMediaStoreWithCleanup(media.MediaCleanerConfig{ Enabled: cfg.Tools.MediaCleanup.Enabled, MaxAge: time.Duration(cfg.Tools.MediaCleanup.MaxAge) * time.Minute, Interval: time.Duration(cfg.Tools.MediaCleanup.Interval) * time.Minute, }) - // Start the media store if it's a FileMediaStore with cleanup - if fms, ok := services.MediaStore.(*media.FileMediaStore); ok { + if fms, ok := runningServices.MediaStore.(*media.FileMediaStore); ok { fms.Start() } - al.SetMediaStore(services.MediaStore) + al.SetMediaStore(runningServices.MediaStore) - // Re-create channel manager with new config - services.ChannelManager, err = channels.NewManager(cfg, msgBus, services.MediaStore) + runningServices.ChannelManager, err = channels.NewManager(cfg, msgBus, runningServices.MediaStore) if err != nil { return fmt.Errorf("error recreating channel manager: %w", err) } - al.SetChannelManager(services.ChannelManager) + al.SetChannelManager(runningServices.ChannelManager) - enabledChannels := services.ChannelManager.GetEnabledChannels() + enabledChannels := runningServices.ChannelManager.GetEnabledChannels() if len(enabledChannels) > 0 { fmt.Printf(" ✓ Channels enabled: %s\n", enabledChannels) } else { fmt.Println(" ⚠ Warning: No channels enabled") } - // Setup HTTP server with new config addr := fmt.Sprintf("%s:%d", cfg.Gateway.Host, cfg.Gateway.Port) - services.HealthServer = health.NewServer(cfg.Gateway.Host, cfg.Gateway.Port) - services.ChannelManager.SetupHTTPServer(addr, services.HealthServer) + runningServices.HealthServer = health.NewServer(cfg.Gateway.Host, cfg.Gateway.Port) + runningServices.ChannelManager.SetupHTTPServer(addr, runningServices.HealthServer) - // Use background context for lifecycle to ensure services persist after restartServices returns - if err = services.ChannelManager.StartAll(context.Background()); err != nil { + if err = runningServices.ChannelManager.StartAll(context.Background()); err != nil { return fmt.Errorf("error restarting channels: %w", err) } fmt.Printf( @@ -447,22 +438,20 @@ func restartServices( cfg.Gateway.Port, ) - // Re-create device service with new config stateManager := state.NewManager(cfg.WorkspacePath()) - services.DeviceService = devices.NewService(devices.Config{ + runningServices.DeviceService = devices.NewService(devices.Config{ Enabled: cfg.Devices.Enabled, MonitorUSB: cfg.Devices.MonitorUSB, }, stateManager) - services.DeviceService.SetBus(msgBus) - if err := services.DeviceService.Start(context.Background()); err != nil { + runningServices.DeviceService.SetBus(msgBus) + if err := runningServices.DeviceService.Start(context.Background()); err != nil { logger.WarnCF("device", "Failed to restart device service", map[string]any{"error": err.Error()}) } else if cfg.Devices.Enabled { fmt.Println(" ✓ Device event service restarted") } - // Wire up voice transcription with new config transcriber := voice.DetectTranscriber(cfg) - al.SetTranscriber(transcriber) // This will set it to nil if disabled + al.SetTranscriber(transcriber) if transcriber != nil { logger.InfoCF("voice", "Transcription re-enabled (agent-level)", map[string]any{"provider": transcriber.Name()}) } else { @@ -472,8 +461,6 @@ func restartServices( return nil } -// setupConfigWatcherPolling sets up a simple polling-based config file watcher -// Returns a channel for config updates and a stop function func setupConfigWatcherPolling(configPath string, debug bool) (chan *config.Config, func()) { configChan := make(chan *config.Config, 1) stop := make(chan struct{}) @@ -483,11 +470,10 @@ func setupConfigWatcherPolling(configPath string, debug bool) (chan *config.Conf go func() { defer wg.Done() - // Get initial file info lastModTime := getFileModTime(configPath) lastSize := getFileSize(configPath) - ticker := time.NewTicker(2 * time.Second) // Check every 2 seconds + ticker := time.NewTicker(2 * time.Second) defer ticker.Stop() for { @@ -496,20 +482,16 @@ func setupConfigWatcherPolling(configPath string, debug bool) (chan *config.Conf currentModTime := getFileModTime(configPath) currentSize := getFileSize(configPath) - // Check if file changed (modification time or size changed) if currentModTime.After(lastModTime) || currentSize != lastSize { if debug { logger.Debugf("🔍 Config file change detected") } - // Debounce - wait a bit to ensure file write is complete time.Sleep(500 * time.Millisecond) - // Update last known state to prevent repeated reload attempts on failure lastModTime = currentModTime lastSize = currentSize - // Validate and load new config newCfg, err := config.LoadConfig(configPath) if err != nil { logger.Errorf("⚠ Error loading new config: %v", err) @@ -517,7 +499,6 @@ func setupConfigWatcherPolling(configPath string, debug bool) (chan *config.Conf continue } - // Validate the new config if err := newCfg.ValidateModelList(); err != nil { logger.Errorf(" ⚠ New config validation failed: %v", err) logger.Warn(" Using previous valid config") @@ -526,15 +507,12 @@ func setupConfigWatcherPolling(configPath string, debug bool) (chan *config.Conf logger.Info("✓ Config file validated and loaded") - // Send new config to main loop (non-blocking) select { case configChan <- newCfg: default: - // Channel full, skip this update logger.Warn("⚠ Previous config reload still in progress, skipping") } } - case <-stop: return } @@ -549,7 +527,6 @@ func setupConfigWatcherPolling(configPath string, debug bool) (chan *config.Conf return configChan, stopFunc } -// getFileModTime returns the modification time of a file, or zero time if file doesn't exist func getFileModTime(path string) time.Time { info, err := os.Stat(path) if err != nil { @@ -558,7 +535,6 @@ func getFileModTime(path string) time.Time { return info.ModTime() } -// getFileSize returns the size of a file, or 0 if file doesn't exist func getFileSize(path string) int64 { info, err := os.Stat(path) if err != nil { @@ -577,10 +553,8 @@ func setupCronTool( ) (*cron.CronService, error) { cronStorePath := filepath.Join(workspace, "cron", "jobs.json") - // Create cron service cronService := cron.NewCronService(cronStorePath, nil) - // Create and register CronTool if enabled var cronTool *tools.CronTool if cfg.Tools.IsToolEnabled("cron") { var err error @@ -592,7 +566,6 @@ func setupCronTool( agentLoop.RegisterTool(cronTool) } - // Set onJob handler if cronTool != nil { cronService.SetOnJob(func(job *cron.CronJob) (string, error) { result := cronTool.ExecuteJob(context.Background(), job) @@ -605,22 +578,17 @@ func setupCronTool( func createHeartbeatHandler(agentLoop *agent.AgentLoop) func(prompt, channel, chatID string) *tools.ToolResult { return func(prompt, channel, chatID string) *tools.ToolResult { - // Use cli:direct as fallback if no valid channel if channel == "" || chatID == "" { channel, chatID = "cli", "direct" } - // Use ProcessHeartbeat - no session history, each heartbeat is independent - var response string - var err error - response, err = agentLoop.ProcessHeartbeat(context.Background(), prompt, channel, chatID) + + response, err := agentLoop.ProcessHeartbeat(context.Background(), prompt, channel, chatID) if err != nil { return tools.ErrorResult(fmt.Sprintf("Heartbeat error: %v", err)) } if response == "HEARTBEAT_OK" { return tools.SilentResult("Heartbeat OK") } - // For heartbeat, always return silent - the subagent result will be - // sent to user via processSystemMessage when the async task completes return tools.SilentResult(response) } } diff --git a/web/backend/api/events.go b/web/backend/api/events.go deleted file mode 100644 index 5c85b149a..000000000 --- a/web/backend/api/events.go +++ /dev/null @@ -1,80 +0,0 @@ -package api - -import ( - "encoding/json" - "sync" -) - -// GatewayEvent represents a state change event for the gateway process. -type GatewayEvent struct { - Status string `json:"gateway_status"` // "running", "starting", "restarting", "stopped", "error" - PID int `json:"pid,omitempty"` - BootDefaultModel string `json:"boot_default_model,omitempty"` - ConfigDefaultModel string `json:"config_default_model,omitempty"` - RestartRequired bool `json:"gateway_restart_required,omitempty"` -} - -// EventBroadcaster manages SSE client subscriptions and broadcasts events. -type EventBroadcaster struct { - mu sync.RWMutex - clients map[chan string]struct{} -} - -// NewEventBroadcaster creates a new broadcaster. -func NewEventBroadcaster() *EventBroadcaster { - return &EventBroadcaster{ - clients: make(map[chan string]struct{}), - } -} - -// Subscribe adds a new listener channel and returns it. -// The caller must call Unsubscribe when done. -func (b *EventBroadcaster) Subscribe() chan string { - ch := make(chan string, 8) - b.mu.Lock() - b.clients[ch] = struct{}{} - b.mu.Unlock() - return ch -} - -// Unsubscribe removes a listener channel and closes it. -func (b *EventBroadcaster) Unsubscribe(ch chan string) { - b.mu.Lock() - defer b.mu.Unlock() - - // Check if the channel is still registered before closing - if _, exists := b.clients[ch]; exists { - delete(b.clients, ch) - close(ch) - } -} - -// Broadcast sends a GatewayEvent to all connected SSE clients. -func (b *EventBroadcaster) Broadcast(event GatewayEvent) { - data, err := json.Marshal(event) - if err != nil { - return - } - - b.mu.RLock() - defer b.mu.RUnlock() - - for ch := range b.clients { - // Non-blocking send; drop event if client is slow - select { - case ch <- string(data): - default: - } - } -} - -// Shutdown closes all subscriber channels, notifying all SSE clients to disconnect. -// This should be called when the server is shutting down. -func (b *EventBroadcaster) Shutdown() { - // Close all channels to notify listeners - for ch := range b.clients { - b.Unsubscribe(ch) - } - // Clear the map - b.clients = make(map[chan string]struct{}) -} diff --git a/web/backend/api/gateway.go b/web/backend/api/gateway.go index 424b21e96..16b793427 100644 --- a/web/backend/api/gateway.go +++ b/web/backend/api/gateway.go @@ -7,6 +7,7 @@ import ( "fmt" "io" "log" + "net" "net/http" "os" "os/exec" @@ -30,11 +31,9 @@ var gateway = struct { runtimeStatus string startupDeadline time.Time logs *LogBuffer - events *EventBroadcaster }{ runtimeStatus: "stopped", logs: NewLogBuffer(200), - events: NewEventBroadcaster(), } var ( @@ -51,11 +50,19 @@ var gatewayHealthGet = func(url string, timeout time.Duration) (*http.Response, // getGatewayHealth checks the gateway health endpoint and returns the status response // Returns (*health.StatusResponse, statusCode, error). If error is not nil, the other values are not valid. -func getGatewayHealth(port int, timeout time.Duration) (*health.StatusResponse, int, error) { - if port == 0 { - port = 18790 +func (h *Handler) getGatewayHealth(cfg *config.Config, timeout time.Duration) (*health.StatusResponse, int, error) { + port := 18790 + if cfg != nil && cfg.Gateway.Port != 0 { + port = cfg.Gateway.Port } - url := fmt.Sprintf("http://127.0.0.1:%d/health", port) + + probeHost := gatewayProbeHost(h.effectiveGatewayBindHost(cfg)) + url := "http://" + net.JoinHostPort(probeHost, strconv.Itoa(port)) + "/health" + + return getGatewayHealthByURL(url, timeout) +} + +func getGatewayHealthByURL(url string, timeout time.Duration) (*health.StatusResponse, int, error) { resp, err := gatewayHealthGet(url, timeout) if err != nil { return nil, 0, err @@ -73,7 +80,6 @@ func getGatewayHealth(port int, timeout time.Duration) (*health.StatusResponse, // registerGatewayRoutes binds gateway lifecycle endpoints to the ServeMux. func (h *Handler) registerGatewayRoutes(mux *http.ServeMux) { mux.HandleFunc("GET /api/gateway/status", h.handleGatewayStatus) - mux.HandleFunc("GET /api/gateway/events", h.handleGatewayEvents) mux.HandleFunc("GET /api/gateway/logs", h.handleGatewayLogs) mux.HandleFunc("POST /api/gateway/logs/clear", h.handleGatewayClearLogs) mux.HandleFunc("POST /api/gateway/start", h.handleGatewayStart) @@ -87,7 +93,7 @@ func (h *Handler) TryAutoStartGateway() { // Check if gateway is already running via health endpoint cfg, cfgErr := config.LoadConfig(h.configPath) if cfgErr == nil && cfg != nil { - healthResp, statusCode, err := getGatewayHealth(cfg.Gateway.Port, 2*time.Second) + healthResp, statusCode, err := h.getGatewayHealth(cfg, 2*time.Second) if err == nil && statusCode == http.StatusOK { // Gateway is already running, attach to the existing process pid := healthResp.Pid @@ -170,6 +176,16 @@ func lookupModelConfig(cfg *config.Config, modelName string) *config.ModelConfig return modelCfg } +func gatewayRestartRequired(configDefaultModel, bootDefaultModel, gatewayStatus string) bool { + if gatewayStatus != "running" { + return false + } + if strings.TrimSpace(configDefaultModel) == "" || strings.TrimSpace(bootDefaultModel) == "" { + return false + } + return configDefaultModel != bootDefaultModel +} + func isCmdProcessAliveLocked(cmd *exec.Cmd) bool { if cmd == nil || cmd.Process == nil { return false @@ -220,7 +236,7 @@ func attachToGatewayProcessLocked(pid int, cfg *config.Config) error { return nil } -func gatewayStatusOnHealthFailureLocked() string { +func gatewayStatusWithoutHealthLocked() string { if gateway.runtimeStatus == "starting" || gateway.runtimeStatus == "restarting" { if gateway.startupDeadline.IsZero() || time.Now().Before(gateway.startupDeadline) { return gateway.runtimeStatus @@ -233,23 +249,7 @@ func gatewayStatusOnHealthFailureLocked() string { if gateway.runtimeStatus == "error" { return "error" } - return "error" -} - -func currentGatewayStatusLocked(processAlive bool) string { - if !processAlive { - if gateway.runtimeStatus == "restarting" { - if gateway.startupDeadline.IsZero() || time.Now().Before(gateway.startupDeadline) { - return "restarting" - } - return "error" - } - if gateway.runtimeStatus == "error" { - return "error" - } - return "stopped" - } - return gatewayStatusOnHealthFailureLocked() + return "stopped" } func waitForGatewayProcessExit(cmd *exec.Cmd, timeout time.Duration) bool { @@ -319,15 +319,6 @@ func (h *Handler) startGatewayLocked(initialStatus string, existingPid int) (int return 0, err } - // Broadcast the attached state - gateway.events.Broadcast(GatewayEvent{ - Status: initialStatus, - PID: pid, - BootDefaultModel: defaultModelName, - ConfigDefaultModel: defaultModelName, - RestartRequired: false, - }) - return pid, nil } @@ -335,7 +326,7 @@ func (h *Handler) startGatewayLocked(initialStatus string, existingPid int) (int // Locate the picoclaw executable execPath := utils.FindPicoclawBinary() - cmd = exec.Command(execPath, "gateway") + cmd = exec.Command(execPath, "gateway", "-E") cmd.Env = os.Environ() // Forward the launcher's config path via the environment variable that // GetConfigPath() already reads, so the gateway sub-process uses the same @@ -376,15 +367,6 @@ func (h *Handler) startGatewayLocked(initialStatus string, existingPid int) (int pid = cmd.Process.Pid log.Printf("Started picoclaw gateway (PID: %d) from %s", pid, execPath) - // Broadcast the launch state immediately so clients can reflect it without polling. - gateway.events.Broadcast(GatewayEvent{ - Status: initialStatus, - PID: pid, - BootDefaultModel: defaultModelName, - ConfigDefaultModel: defaultModelName, - RestartRequired: false, - }) - // Capture stdout/stderr in background go scanPipe(stdoutPipe, gateway.logs) go scanPipe(stderrPipe, gateway.logs) @@ -398,26 +380,17 @@ func (h *Handler) startGatewayLocked(initialStatus string, existingPid int) (int } gateway.mu.Lock() - shouldBroadcastStopped := false if gateway.cmd == cmd { gateway.cmd = nil gateway.bootDefaultModel = "" if gateway.runtimeStatus != "restarting" { setGatewayRuntimeStatusLocked("stopped") - shouldBroadcastStopped = true } } gateway.mu.Unlock() - - if shouldBroadcastStopped { - gateway.events.Broadcast(GatewayEvent{ - Status: "stopped", - RestartRequired: false, - }) - } }() - // Start a goroutine to probe health and broadcast "running" once ready + // Start a goroutine to probe health and update the runtime state once ready. go func() { for i := 0; i < 30; i++ { // try for up to 15 seconds time.Sleep(500 * time.Millisecond) @@ -431,7 +404,7 @@ func (h *Handler) startGatewayLocked(initialStatus string, existingPid int) (int if err != nil { continue } - healthResp, statusCode, err := getGatewayHealth(cfg.Gateway.Port, 1*time.Second) + healthResp, statusCode, err := h.getGatewayHealth(cfg, 1*time.Second) if err == nil && statusCode == http.StatusOK && healthResp.Pid == pid { // Verify the health endpoint returns the expected pid gateway.mu.Lock() @@ -439,13 +412,6 @@ func (h *Handler) startGatewayLocked(initialStatus string, existingPid int) (int setGatewayRuntimeStatusLocked("running") } gateway.mu.Unlock() - gateway.events.Broadcast(GatewayEvent{ - Status: "running", - PID: pid, - BootDefaultModel: defaultModelName, - ConfigDefaultModel: defaultModelName, - RestartRequired: false, - }) return } } @@ -461,7 +427,7 @@ func (h *Handler) handleGatewayStart(w http.ResponseWriter, r *http.Request) { // Prevent duplicate starts by checking health endpoint cfg, cfgErr := config.LoadConfig(h.configPath) if cfgErr == nil && cfg != nil { - healthResp, statusCode, err := getGatewayHealth(cfg.Gateway.Port, 2*time.Second) + healthResp, statusCode, err := h.getGatewayHealth(cfg, 2*time.Second) if err == nil && statusCode == http.StatusOK { // Gateway is already running, attach to the existing process pid := healthResp.Pid @@ -597,10 +563,6 @@ func (h *Handler) RestartGateway() (int, error) { gateway.mu.Lock() previousCmd := gateway.cmd setGatewayRuntimeStatusLocked("restarting") - gateway.events.Broadcast(GatewayEvent{ - Status: "restarting", - RestartRequired: false, - }) gateway.mu.Unlock() if err = stopGatewayProcessForRestart(previousCmd); err != nil { @@ -704,24 +666,20 @@ func (h *Handler) handleGatewayStatus(w http.ResponseWriter, r *http.Request) { func (h *Handler) gatewayStatusData() map[string]any { data := map[string]any{} + configDefaultModel := "" cfg, cfgErr := config.LoadConfig(h.configPath) if cfgErr == nil && cfg != nil { - configDefaultModel := strings.TrimSpace(cfg.Agents.Defaults.GetModelName()) + configDefaultModel = strings.TrimSpace(cfg.Agents.Defaults.GetModelName()) if configDefaultModel != "" { data["config_default_model"] = configDefaultModel } } // Probe health endpoint to get pid and status - port := 0 - if cfgErr == nil && cfg != nil { - port = cfg.Gateway.Port - } - - healthResp, statusCode, err := getGatewayHealth(port, 2*time.Second) + healthResp, statusCode, err := h.getGatewayHealth(cfg, 2*time.Second) if err != nil { gateway.mu.Lock() - data["gateway_status"] = currentGatewayStatusLocked(true) + data["gateway_status"] = gatewayStatusWithoutHealthLocked() gateway.mu.Unlock() log.Printf("Gateway health check failed: %v", err) } else { @@ -734,45 +692,43 @@ func (h *Handler) gatewayStatusData() map[string]any { data["status_code"] = statusCode } else { gateway.mu.Lock() - // Check if this pid matches our tracked process - if gateway.cmd != nil && gateway.cmd.Process != nil && gateway.cmd.Process.Pid == healthResp.Pid { - setGatewayRuntimeStatusLocked("running") - bootDefaultModel := gateway.bootDefaultModel - if bootDefaultModel != "" { - data["boot_default_model"] = bootDefaultModel - } - data["gateway_status"] = "running" - data["pid"] = healthResp.Pid - } else { - // Health endpoint responded with a different pid - // This could be a manual restart, try to attach to the new process + setGatewayRuntimeStatusLocked("running") + if gateway.cmd == nil || gateway.cmd.Process == nil || gateway.cmd.Process.Pid != healthResp.Pid { oldPid := "none" if gateway.cmd != nil && gateway.cmd.Process != nil { oldPid = fmt.Sprintf("%d", gateway.cmd.Process.Pid) } - log.Printf("Detected new gateway PID (old: %s, new: %d), attempting to attach", oldPid, healthResp.Pid) - + log.Printf( + "Detected gateway PID from health (old: %s, new: %d), attempting to attach", + oldPid, + healthResp.Pid, + ) if err := attachToGatewayProcessLocked(healthResp.Pid, cfg); err != nil { - // Failed to find the process, treat as error - setGatewayRuntimeStatusLocked("error") - data["gateway_status"] = "error" - data["pid"] = healthResp.Pid - log.Printf("Failed to attach to new gateway process (PID: %d): %v", healthResp.Pid, err) - } else { - // Successfully attached, update response data - bootDefaultModel := gateway.bootDefaultModel - if bootDefaultModel != "" { - data["boot_default_model"] = bootDefaultModel - } - data["gateway_status"] = "running" - data["pid"] = healthResp.Pid + log.Printf( + "Failed to attach to gateway process reported by health (PID: %d): %v", + healthResp.Pid, + err, + ) } } + + bootDefaultModel := gateway.bootDefaultModel + if bootDefaultModel != "" { + data["boot_default_model"] = bootDefaultModel + } + data["gateway_status"] = "running" + data["pid"] = healthResp.Pid gateway.mu.Unlock() } } - data["gateway_restart_required"] = false + bootDefaultModel, _ := data["boot_default_model"].(string) + gatewayStatus, _ := data["gateway_status"].(string) + data["gateway_restart_required"] = gatewayRestartRequired( + configDefaultModel, + bootDefaultModel, + gatewayStatus, + ) ready, reason, readyErr := h.gatewayStartReady() if readyErr != nil { @@ -842,51 +798,6 @@ func gatewayLogsData(r *http.Request) map[string]any { return data } -// handleGatewayEvents serves an SSE stream of gateway state change events. -// -// GET /api/gateway/events -func (h *Handler) handleGatewayEvents(w http.ResponseWriter, r *http.Request) { - flusher, ok := w.(http.Flusher) - if !ok { - http.Error(w, "SSE not supported", http.StatusInternalServerError) - return - } - - w.Header().Set("Content-Type", "text/event-stream") - w.Header().Set("Cache-Control", "no-cache") - w.Header().Set("Connection", "keep-alive") - w.Header().Set("Access-Control-Allow-Origin", "*") - - // Subscribe to gateway events - ch := gateway.events.Subscribe() - defer gateway.events.Unsubscribe(ch) - - // Send initial status so the client doesn't start blank - initial := h.currentGatewayStatus() - fmt.Fprintf(w, "data: %s\n\n", initial) - flusher.Flush() - - for { - select { - case <-r.Context().Done(): - return - case data, ok := <-ch: - if !ok { - return - } - fmt.Fprintf(w, "data: %s\n\n", data) - flusher.Flush() - } - } -} - -// currentGatewayStatus returns the current gateway status as a JSON string. -func (h *Handler) currentGatewayStatus() string { - data := h.gatewayStatusData() - encoded, _ := json.Marshal(data) - return string(encoded) -} - // scanPipe reads lines from r and appends them to buf. Returns when r reaches EOF. func scanPipe(r io.Reader, buf *LogBuffer) { scanner := bufio.NewScanner(r) diff --git a/web/backend/api/gateway_host.go b/web/backend/api/gateway_host.go index 8dde29b76..592571a28 100644 --- a/web/backend/api/gateway_host.go +++ b/web/backend/api/gateway_host.go @@ -3,6 +3,7 @@ package api import ( "net" "net/http" + "net/url" "strconv" "strings" @@ -46,6 +47,23 @@ func gatewayProbeHost(bindHost string) string { return bindHost } +func (h *Handler) gatewayProxyURL() *url.URL { + cfg, err := config.LoadConfig(h.configPath) + port := 18790 + bindHost := "" + if err == nil && cfg != nil { + if cfg.Gateway.Port != 0 { + port = cfg.Gateway.Port + } + bindHost = h.effectiveGatewayBindHost(cfg) + } + + return &url.URL{ + Scheme: "http", + Host: net.JoinHostPort(gatewayProbeHost(bindHost), strconv.Itoa(port)), + } +} + func requestHostName(r *http.Request) string { reqHost, _, err := net.SplitHostPort(r.Host) if err == nil { diff --git a/web/backend/api/gateway_host_test.go b/web/backend/api/gateway_host_test.go index 3fffeb893..ae3434862 100644 --- a/web/backend/api/gateway_host_test.go +++ b/web/backend/api/gateway_host_test.go @@ -2,9 +2,12 @@ package api import ( "crypto/tls" + "errors" + "net/http" "net/http/httptest" "path/filepath" "testing" + "time" "github.com/sipeed/picoclaw/pkg/config" "github.com/sipeed/picoclaw/web/backend/launcherconfig" @@ -59,6 +62,79 @@ func TestGatewayProbeHostUsesLoopbackForWildcardBind(t *testing.T) { } } +func TestGatewayProxyURLUsesConfiguredHost(t *testing.T) { + configPath := filepath.Join(t.TempDir(), "config.json") + h := NewHandler(configPath) + + cfg := config.DefaultConfig() + cfg.Gateway.Host = "192.168.1.10" + cfg.Gateway.Port = 18791 + if err := config.SaveConfig(configPath, cfg); err != nil { + t.Fatalf("SaveConfig() error = %v", err) + } + + if got := h.gatewayProxyURL().String(); got != "http://192.168.1.10:18791" { + t.Fatalf("gatewayProxyURL() = %q, want %q", got, "http://192.168.1.10:18791") + } +} + +func TestGetGatewayHealthUsesConfiguredHost(t *testing.T) { + configPath := filepath.Join(t.TempDir(), "config.json") + h := NewHandler(configPath) + + cfg := config.DefaultConfig() + cfg.Gateway.Host = "192.168.1.10" + cfg.Gateway.Port = 18791 + + originalHealthGet := gatewayHealthGet + t.Cleanup(func() { + gatewayHealthGet = originalHealthGet + }) + + var requestedURL string + gatewayHealthGet = func(url string, timeout time.Duration) (*http.Response, error) { + requestedURL = url + return nil, errors.New("probe failed") + } + + _, statusCode, err := h.getGatewayHealth(cfg, time.Second) + _ = statusCode + _ = err + + if requestedURL != "http://192.168.1.10:18791/health" { + t.Fatalf("health url = %q, want %q", requestedURL, "http://192.168.1.10:18791/health") + } +} + +func TestGetGatewayHealthUsesProbeHostForPublicLauncher(t *testing.T) { + configPath := filepath.Join(t.TempDir(), "config.json") + h := NewHandler(configPath) + h.SetServerOptions(18800, true, true, nil) + + cfg := config.DefaultConfig() + cfg.Gateway.Host = "127.0.0.1" + cfg.Gateway.Port = 18791 + + originalHealthGet := gatewayHealthGet + t.Cleanup(func() { + gatewayHealthGet = originalHealthGet + }) + + var requestedURL string + gatewayHealthGet = func(url string, timeout time.Duration) (*http.Response, error) { + requestedURL = url + return nil, errors.New("probe failed") + } + + _, statusCode, err := h.getGatewayHealth(cfg, time.Second) + _ = statusCode + _ = err + + if requestedURL != "http://127.0.0.1:18791/health" { + t.Fatalf("health url = %q, want %q", requestedURL, "http://127.0.0.1:18791/health") + } +} + func TestBuildWsURLUsesWSSWhenForwardedProtoIsHTTPS(t *testing.T) { configPath := filepath.Join(t.TempDir(), "config.json") h := NewHandler(configPath) diff --git a/web/backend/api/gateway_test.go b/web/backend/api/gateway_test.go index fb4f7d943..5c94f0b89 100644 --- a/web/backend/api/gateway_test.go +++ b/web/backend/api/gateway_test.go @@ -3,6 +3,7 @@ package api import ( "encoding/json" "errors" + "io" "net/http" "net/http/httptest" "os" @@ -36,6 +37,15 @@ func startLongRunningProcess(t *testing.T) *exec.Cmd { return cmd } +func mockGatewayHealthResponse(statusCode, pid int) *http.Response { + return &http.Response{ + StatusCode: statusCode, + Body: io.NopCloser(strings.NewReader( + `{"status":"ok","uptime":"1s","pid":` + strconv.Itoa(pid) + `}`, + )), + } +} + func startIgnoringTermProcess(t *testing.T) *exec.Cmd { t.Helper() @@ -419,6 +429,125 @@ func TestGatewayStatusKeepsRunningWhenHealthProbeFailsAfterRunning(t *testing.T) } } +func TestGatewayStatusReportsRunningFromHealthProbe(t *testing.T) { + resetGatewayTestState(t) + + configPath := filepath.Join(t.TempDir(), "config.json") + h := NewHandler(configPath) + mux := http.NewServeMux() + h.RegisterRoutes(mux) + + cmd := startLongRunningProcess(t) + t.Cleanup(func() { + if cmd.Process != nil { + _ = cmd.Process.Kill() + } + _ = cmd.Wait() + }) + + gateway.mu.Lock() + setGatewayRuntimeStatusLocked("stopped") + gateway.mu.Unlock() + + gatewayHealthGet = func(string, time.Duration) (*http.Response, error) { + return mockGatewayHealthResponse(http.StatusOK, cmd.Process.Pid), nil + } + + rec := httptest.NewRecorder() + req := httptest.NewRequest(http.MethodGet, "/api/gateway/status", nil) + mux.ServeHTTP(rec, req) + + if rec.Code != http.StatusOK { + t.Fatalf("status = %d, want %d", rec.Code, http.StatusOK) + } + + var body map[string]any + if err := json.Unmarshal(rec.Body.Bytes(), &body); err != nil { + t.Fatalf("unmarshal response: %v", err) + } + + if got := body["gateway_status"]; got != "running" { + t.Fatalf("gateway_status = %#v, want %q", got, "running") + } + if got := body["pid"]; got != float64(cmd.Process.Pid) { + t.Fatalf("pid = %#v, want %d", got, cmd.Process.Pid) + } + if got := body["gateway_restart_required"]; got != false { + t.Fatalf("gateway_restart_required = %#v, want false", got) + } +} + +func TestGatewayStatusRequiresRestartAfterDefaultModelChange(t *testing.T) { + resetGatewayTestState(t) + + configPath := filepath.Join(t.TempDir(), "config.json") + cfg := config.DefaultConfig() + cfg.Agents.Defaults.ModelName = cfg.ModelList[0].ModelName + cfg.ModelList[0].APIKey = "test-key" + cfg.ModelList = append(cfg.ModelList, config.ModelConfig{ + ModelName: "second-model", + Model: "openai/gpt-4.1", + APIKey: "second-key", + }) + if err := config.SaveConfig(configPath, cfg); err != nil { + t.Fatalf("SaveConfig() error = %v", err) + } + + h := NewHandler(configPath) + mux := http.NewServeMux() + h.RegisterRoutes(mux) + + process, err := os.FindProcess(os.Getpid()) + if err != nil { + t.Fatalf("FindProcess() error = %v", err) + } + + gateway.mu.Lock() + gateway.cmd = &exec.Cmd{Process: process} + gateway.bootDefaultModel = cfg.ModelList[0].ModelName + setGatewayRuntimeStatusLocked("running") + gateway.mu.Unlock() + + updatedCfg, err := config.LoadConfig(configPath) + if err != nil { + t.Fatalf("LoadConfig() error = %v", err) + } + updatedCfg.Agents.Defaults.ModelName = "second-model" + if err := config.SaveConfig(configPath, updatedCfg); err != nil { + t.Fatalf("SaveConfig() error = %v", err) + } + + gatewayHealthGet = func(string, time.Duration) (*http.Response, error) { + return mockGatewayHealthResponse(http.StatusOK, os.Getpid()), nil + } + + rec := httptest.NewRecorder() + req := httptest.NewRequest(http.MethodGet, "/api/gateway/status", nil) + mux.ServeHTTP(rec, req) + + if rec.Code != http.StatusOK { + t.Fatalf("status = %d, want %d", rec.Code, http.StatusOK) + } + + var body map[string]any + if err := json.Unmarshal(rec.Body.Bytes(), &body); err != nil { + t.Fatalf("unmarshal response: %v", err) + } + + if got := body["gateway_status"]; got != "running" { + t.Fatalf("gateway_status = %#v, want %q", got, "running") + } + if got := body["boot_default_model"]; got != cfg.ModelList[0].ModelName { + t.Fatalf("boot_default_model = %#v, want %q", got, cfg.ModelList[0].ModelName) + } + if got := body["config_default_model"]; got != "second-model" { + t.Fatalf("config_default_model = %#v, want %q", got, "second-model") + } + if got := body["gateway_restart_required"]; got != true { + t.Fatalf("gateway_restart_required = %#v, want true", got) + } +} + func TestGatewayStatusReturnsErrorAfterStartupWindowExpires(t *testing.T) { resetGatewayTestState(t) diff --git a/web/backend/api/pico.go b/web/backend/api/pico.go index d11f7bc5e..a880f2f0c 100644 --- a/web/backend/api/pico.go +++ b/web/backend/api/pico.go @@ -7,7 +7,6 @@ import ( "fmt" "net/http" "net/http/httputil" - "net/url" "time" "github.com/sipeed/picoclaw/pkg/config" @@ -22,20 +21,13 @@ func (h *Handler) registerPicoRoutes(mux *http.ServeMux) { // WebSocket proxy: forward /pico/ws to gateway // This allows the frontend to connect via the same port as the web UI, // avoiding the need to expose extra ports for WebSocket communication. - wsProxy := h.createWsProxy() - mux.HandleFunc("GET /pico/ws", h.handleWebSocketProxy(wsProxy)) + mux.HandleFunc("GET /pico/ws", h.handleWebSocketProxy()) } -// createWsProxy creates a reverse proxy to the gateway WebSocket endpoint. -// The gateway port is read from the configuration. +// createWsProxy creates a reverse proxy to the current gateway WebSocket endpoint. +// The gateway bind host and port are resolved from the latest configuration. func (h *Handler) createWsProxy() *httputil.ReverseProxy { - cfg, err := config.LoadConfig(h.configPath) - gatewayPort := 18790 // default - if err == nil && cfg.Gateway.Port != 0 { - gatewayPort = cfg.Gateway.Port - } - gatewayURL, _ := url.Parse(fmt.Sprintf("http://127.0.0.1:%d", gatewayPort)) - wsProxy := httputil.NewSingleHostReverseProxy(gatewayURL) + wsProxy := httputil.NewSingleHostReverseProxy(h.gatewayProxyURL()) wsProxy.ErrorHandler = func(w http.ResponseWriter, r *http.Request, err error) { http.Error(w, "Gateway unavailable: "+err.Error(), http.StatusBadGateway) } @@ -43,12 +35,10 @@ func (h *Handler) createWsProxy() *httputil.ReverseProxy { } // handleWebSocketProxy wraps a reverse proxy to handle WebSocket connections. -// It ensures the Connection and Upgrade headers are properly forwarded. -func (h *Handler) handleWebSocketProxy(proxy *httputil.ReverseProxy) http.HandlerFunc { +// The reverse proxy forwards the incoming upgrade handshake as-is. +func (h *Handler) handleWebSocketProxy() http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) { - // Set headers for WebSocket upgrade - r.Header.Set("Connection", "upgrade") - r.Header.Set("Upgrade", "websocket") + proxy := h.createWsProxy() proxy.ServeHTTP(w, r) } } diff --git a/web/backend/api/pico_test.go b/web/backend/api/pico_test.go index 46149fa09..075da4ddc 100644 --- a/web/backend/api/pico_test.go +++ b/web/backend/api/pico_test.go @@ -2,9 +2,12 @@ package api import ( "encoding/json" + "io" "net/http" "net/http/httptest" + "net/url" "path/filepath" + "strconv" "testing" "github.com/sipeed/picoclaw/pkg/config" @@ -235,3 +238,77 @@ func TestHandlePicoSetup_Response(t *testing.T) { t.Error("response should have changed=true on first setup") } } + +func TestHandleWebSocketProxyReloadsGatewayTargetFromConfig(t *testing.T) { + configPath := filepath.Join(t.TempDir(), "config.json") + h := NewHandler(configPath) + handler := h.handleWebSocketProxy() + + server1 := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + if r.URL.Path != "/pico/ws" { + t.Fatalf("server1 path = %q, want %q", r.URL.Path, "/pico/ws") + } + w.WriteHeader(http.StatusOK) + _, _ = io.WriteString(w, "server1") + })) + defer server1.Close() + + server2 := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + if r.URL.Path != "/pico/ws" { + t.Fatalf("server2 path = %q, want %q", r.URL.Path, "/pico/ws") + } + w.WriteHeader(http.StatusOK) + _, _ = io.WriteString(w, "server2") + })) + defer server2.Close() + + cfg := config.DefaultConfig() + cfg.Gateway.Host = "127.0.0.1" + cfg.Gateway.Port = mustGatewayTestPort(t, server1.URL) + if err := config.SaveConfig(configPath, cfg); err != nil { + t.Fatalf("SaveConfig() error = %v", err) + } + + req1 := httptest.NewRequest(http.MethodGet, "/pico/ws", nil) + rec1 := httptest.NewRecorder() + handler(rec1, req1) + + if rec1.Code != http.StatusOK { + t.Fatalf("first status = %d, want %d", rec1.Code, http.StatusOK) + } + if body := rec1.Body.String(); body != "server1" { + t.Fatalf("first body = %q, want %q", body, "server1") + } + + cfg.Gateway.Port = mustGatewayTestPort(t, server2.URL) + if err := config.SaveConfig(configPath, cfg); err != nil { + t.Fatalf("SaveConfig() error = %v", err) + } + + req2 := httptest.NewRequest(http.MethodGet, "/pico/ws", nil) + rec2 := httptest.NewRecorder() + handler(rec2, req2) + + if rec2.Code != http.StatusOK { + t.Fatalf("second status = %d, want %d", rec2.Code, http.StatusOK) + } + if body := rec2.Body.String(); body != "server2" { + t.Fatalf("second body = %q, want %q", body, "server2") + } +} + +func mustGatewayTestPort(t *testing.T, rawURL string) int { + t.Helper() + + parsed, err := url.Parse(rawURL) + if err != nil { + t.Fatalf("url.Parse() error = %v", err) + } + + port, err := strconv.Atoi(parsed.Port()) + if err != nil { + t.Fatalf("Atoi(%q) error = %v", parsed.Port(), err) + } + + return port +} diff --git a/web/backend/api/router.go b/web/backend/api/router.go index b56438784..028a476f2 100644 --- a/web/backend/api/router.go +++ b/web/backend/api/router.go @@ -71,7 +71,4 @@ func (h *Handler) RegisterRoutes(mux *http.ServeMux) { h.registerLauncherConfigRoutes(mux) } -// Shutdown gracefully shuts down the handler, closing all SSE connections. -func (h *Handler) Shutdown() { - gateway.events.Shutdown() -} +func (h *Handler) Shutdown() {} diff --git a/web/backend/middleware/middleware.go b/web/backend/middleware/middleware.go index de9e6d870..e15da577b 100644 --- a/web/backend/middleware/middleware.go +++ b/web/backend/middleware/middleware.go @@ -4,16 +4,14 @@ import ( "log" "net/http" "runtime/debug" - "strings" "time" ) // JSONContentType sets the Content-Type header to application/json for // API requests handled by the wrapped handler. -// SSE endpoints (text/event-stream) are excluded. func JSONContentType(next http.Handler) http.Handler { return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { - if strings.HasPrefix(r.URL.Path, "/api/") && !strings.HasSuffix(r.URL.Path, "/events") { + if len(r.URL.Path) >= 5 && r.URL.Path[:5] == "/api/" { w.Header().Set("Content-Type", "application/json") } next.ServeHTTP(w, r) @@ -32,7 +30,6 @@ func (rr *responseRecorder) WriteHeader(code int) { } // Flush delegates to the underlying ResponseWriter if it implements http.Flusher. -// This is required for SSE (Server-Sent Events) to work through the middleware. func (rr *responseRecorder) Flush() { if f, ok := rr.ResponseWriter.(http.Flusher); ok { f.Flush() diff --git a/web/backend/systray.go b/web/backend/systray.go index 58ce4984f..1ff98c71b 100644 --- a/web/backend/systray.go +++ b/web/backend/systray.go @@ -94,7 +94,7 @@ func onReady() { func onExit() { fmt.Println(T(Exiting)) - // First, shutdown API handler to close all SSE connections + // First, shutdown API handler if apiHandler != nil { apiHandler.Shutdown() } diff --git a/web/frontend/src/components/app-header.tsx b/web/frontend/src/components/app-header.tsx index fe0c84e69..4f0688008 100644 --- a/web/frontend/src/components/app-header.tsx +++ b/web/frontend/src/components/app-header.tsx @@ -56,14 +56,20 @@ export function AppHeader() { const isRunning = gwState === "running" const isStarting = gwState === "starting" const isRestarting = gwState === "restarting" + const isStopping = gwState === "stopping" const isStopped = gwState === "stopped" || gwState === "unknown" const showNotConnectedHint = - !isRestarting && canStart && (gwState === "stopped" || gwState === "error") + !isRestarting && + !isStopping && + canStart && + (gwState === "stopped" || gwState === "error") const [showStopDialog, setShowStopDialog] = React.useState(false) const handleGatewayToggle = () => { - if (gwLoading || isRestarting || (!isRunning && !canStart)) return + if (gwLoading || isRestarting || isStopping || (!isRunning && !canStart)) { + return + } if (isRunning) { setShowStopDialog(true) } else { @@ -137,7 +143,7 @@ export function AppHeader() { size="icon-sm" className="bg-amber-500/15 text-amber-700 hover:bg-amber-500/25 hover:text-amber-800 dark:text-amber-300 dark:hover:bg-amber-500/25" onClick={handleGatewayRestart} - disabled={gwLoading || isRestarting || !canStart} + disabled={gwLoading || isRestarting || isStopping || !canStart} aria-label={t("header.gateway.action.restart")} > <IconRefresh className="size-4" /> @@ -168,25 +174,31 @@ export function AppHeader() { </Tooltip> ) : ( <Button - variant={isStarting || isRestarting ? "secondary" : "default"} + variant={ + isStarting || isRestarting || isStopping ? "secondary" : "default" + } size="sm" className={`h-8 gap-2 px-3 ${ isStopped ? "bg-green-500 text-white hover:bg-green-600" : "" }`} onClick={handleGatewayToggle} - disabled={gwLoading || isStarting || isRestarting || !canStart} + disabled={ + gwLoading || isStarting || isRestarting || isStopping || !canStart + } > - {gwLoading || isStarting || isRestarting ? ( + {gwLoading || isStarting || isRestarting || isStopping ? ( <IconLoader2 className="h-4 w-4 animate-spin opacity-70" /> ) : ( <IconPlayerPlay className="h-4 w-4 opacity-80" /> )} <span className="text-xs font-semibold"> - {isRestarting - ? t("header.gateway.status.restarting") - : isStarting - ? t("header.gateway.status.starting") - : t("header.gateway.action.start")} + {isStopping + ? t("header.gateway.status.stopping") + : isRestarting + ? t("header.gateway.status.restarting") + : isStarting + ? t("header.gateway.status.starting") + : t("header.gateway.action.start")} </span> </Button> )} diff --git a/web/frontend/src/hooks/use-gateway-logs.ts b/web/frontend/src/hooks/use-gateway-logs.ts index 15cbca4ae..1de361124 100644 --- a/web/frontend/src/hooks/use-gateway-logs.ts +++ b/web/frontend/src/hooks/use-gateway-logs.ts @@ -37,7 +37,9 @@ export function useGatewayLogs() { const fetchLogs = async () => { if ( !mounted || - !["running", "starting", "restarting"].includes(gateway.status) + !["running", "starting", "restarting", "stopping"].includes( + gateway.status, + ) ) { if (mounted) { timeout = setTimeout(fetchLogs, 1000) diff --git a/web/frontend/src/hooks/use-gateway.ts b/web/frontend/src/hooks/use-gateway.ts index 65ec2b776..b118b43da 100644 --- a/web/frontend/src/hooks/use-gateway.ts +++ b/web/frontend/src/hooks/use-gateway.ts @@ -1,83 +1,24 @@ import { useAtomValue } from "jotai" import { useCallback, useEffect, useState } from "react" +import { restartGateway, startGateway, stopGateway } from "@/api/gateway" import { - type GatewayStatusResponse, - getGatewayStatus, - restartGateway, - startGateway, - stopGateway, -} from "@/api/gateway" -import { - applyGatewayStatusToStore, + beginGatewayStoppingTransition, + cancelGatewayStoppingTransition, gatewayAtom, + refreshGatewayState, + subscribeGatewayPolling, updateGatewayStore, } from "@/store" -// Global variable to ensure we only have one SSE connection -let sseInitialized = false - export function useGateway() { const gateway = useAtomValue(gatewayAtom) const { status: state, canStart, restartRequired } = gateway const [loading, setLoading] = useState(false) - const applyGatewayStatus = useCallback((data: GatewayStatusResponse) => { - applyGatewayStatusToStore(data) - }, []) - - // Initialize global SSE connection once useEffect(() => { - if (sseInitialized) return - sseInitialized = true - - getGatewayStatus() - .then((data) => applyGatewayStatus(data)) - .catch(() => { - updateGatewayStore({ - status: "unknown", - canStart: true, - restartRequired: false, - }) - }) - - const statusPoll = window.setInterval(() => { - getGatewayStatus() - .then((data) => applyGatewayStatus(data)) - .catch(() => { - // ignore polling errors - }) - }, 5000) - - // Subscribe to SSE for real-time updates globally - const es = new EventSource("/api/gateway/events") - - es.onmessage = (event) => { - try { - const data = JSON.parse(event.data) - if ( - data.gateway_status || - typeof data.gateway_start_allowed === "boolean" - ) { - applyGatewayStatus(data) - } - } catch { - // ignore - } - } - - es.onerror = () => { - // EventSource will auto-reconnect. Preserve the last known gateway - // status so transient SSE disconnects do not suppress chat websocket - // reconnects while polling catches up. - } - - return () => { - window.clearInterval(statusPoll) - es.close() - sseInitialized = false - } - }, [applyGatewayStatus]) + return subscribeGatewayPolling() + }, []) const start = useCallback(async () => { if (!canStart) return @@ -85,33 +26,28 @@ export function useGateway() { setLoading(true) try { await startGateway() - // SSE will push the real state changes, but set optimistic state - updateGatewayStore({ status: "starting" }) - } catch (err) { - console.error("Failed to start gateway:", err) - try { - const status = await getGatewayStatus() - applyGatewayStatus(status) - } catch { - updateGatewayStore({ status: "unknown" }) - } - } finally { - setLoading(false) - } - }, [applyGatewayStatus, canStart]) - - const stop = useCallback(async () => { - setLoading(true) - try { - await stopGateway() updateGatewayStore({ - status: "stopped", - canStart: true, + status: "starting", restartRequired: false, }) } catch (err) { - console.error("Failed to stop gateway:", err) + console.error("Failed to start gateway:", err) } finally { + await refreshGatewayState({ force: true }) + setLoading(false) + } + }, [canStart]) + + const stop = useCallback(async () => { + setLoading(true) + beginGatewayStoppingTransition() + try { + await stopGateway() + } catch (err) { + console.error("Failed to stop gateway:", err) + cancelGatewayStoppingTransition() + } finally { + await refreshGatewayState({ force: true }) setLoading(false) } }, []) @@ -119,34 +55,20 @@ export function useGateway() { const restart = useCallback(async () => { if (state !== "running") return - const previousState = state - const previousCanStart = canStart - const previousRestartRequired = restartRequired - setLoading(true) - updateGatewayStore({ - status: "restarting", - restartRequired: false, - }) - try { await restartGateway() + updateGatewayStore({ + status: "restarting", + restartRequired: false, + }) } catch (err) { console.error("Failed to restart gateway:", err) - try { - const status = await getGatewayStatus() - applyGatewayStatus(status) - } catch { - updateGatewayStore({ - status: previousState, - canStart: previousCanStart, - restartRequired: previousRestartRequired, - }) - } } finally { + await refreshGatewayState({ force: true }) setLoading(false) } - }, [applyGatewayStatus, canStart, restartRequired, state]) + }, [state]) return { state, loading, canStart, restartRequired, start, stop, restart } } diff --git a/web/frontend/src/i18n/locales/en.json b/web/frontend/src/i18n/locales/en.json index 2fa32ebb5..327b4c646 100644 --- a/web/frontend/src/i18n/locales/en.json +++ b/web/frontend/src/i18n/locales/en.json @@ -63,7 +63,8 @@ }, "status": { "starting": "Starting Gateway...", - "restarting": "Restarting Gateway..." + "restarting": "Restarting Gateway...", + "stopping": "Stopping Gateway..." }, "restartRequired": "Model changes require a gateway restart to take effect." } diff --git a/web/frontend/src/i18n/locales/zh.json b/web/frontend/src/i18n/locales/zh.json index badf5bb3d..cd674ddc1 100644 --- a/web/frontend/src/i18n/locales/zh.json +++ b/web/frontend/src/i18n/locales/zh.json @@ -63,7 +63,8 @@ }, "status": { "starting": "服务启动中...", - "restarting": "服务重启中..." + "restarting": "服务重启中...", + "stopping": "服务停止中..." }, "restartRequired": "切换默认模型后需要重启服务才能生效。" } diff --git a/web/frontend/src/store/gateway.ts b/web/frontend/src/store/gateway.ts index c5eee8451..1bdec6220 100644 --- a/web/frontend/src/store/gateway.ts +++ b/web/frontend/src/store/gateway.ts @@ -6,6 +6,7 @@ export type GatewayState = | "running" | "starting" | "restarting" + | "stopping" | "stopped" | "error" | "unknown" @@ -24,9 +25,29 @@ const DEFAULT_GATEWAY_STATE: GatewayStoreState = { restartRequired: false, } +const GATEWAY_POLL_INTERVAL_MS = 2000 +const GATEWAY_TRANSIENT_POLL_INTERVAL_MS = 1000 +const GATEWAY_STOPPING_TIMEOUT_MS = 5000 + +interface RefreshGatewayStateOptions { + force?: boolean +} + // Global atom for gateway state export const gatewayAtom = atom<GatewayStoreState>(DEFAULT_GATEWAY_STATE) +let gatewayPollingSubscribers = 0 +let gatewayPollingTimer: ReturnType<typeof setTimeout> | null = null +let gatewayPollingRequest: Promise<void> | null = null +let gatewayStoppingTimer: ReturnType<typeof setTimeout> | null = null + +function clearGatewayStoppingTimeout() { + if (gatewayStoppingTimer !== null) { + clearTimeout(gatewayStoppingTimer) + gatewayStoppingTimer = null + } +} + function normalizeGatewayStoreState( prev: GatewayStoreState, patch: GatewayStorePatch, @@ -49,10 +70,38 @@ export function updateGatewayStore( | GatewayStorePatch | ((prev: GatewayStoreState) => GatewayStorePatch | GatewayStoreState), ) { - getDefaultStore().set(gatewayAtom, (prev) => { + const store = getDefaultStore() + store.set(gatewayAtom, (prev) => { const nextPatch = typeof patch === "function" ? patch(prev) : patch return normalizeGatewayStoreState(prev, nextPatch) }) + const nextState = store.get(gatewayAtom) + if (nextState?.status !== "stopping") { + clearGatewayStoppingTimeout() + } +} + +export function beginGatewayStoppingTransition() { + clearGatewayStoppingTimeout() + updateGatewayStore({ + status: "stopping", + canStart: false, + restartRequired: false, + }) + gatewayStoppingTimer = setTimeout(() => { + gatewayStoppingTimer = null + updateGatewayStore((prev) => + prev.status === "stopping" ? { status: "running" } : prev, + ) + void refreshGatewayState({ force: true }) + }, GATEWAY_STOPPING_TIMEOUT_MS) +} + +export function cancelGatewayStoppingTransition() { + clearGatewayStoppingTimeout() + updateGatewayStore((prev) => + prev.status === "stopping" ? { status: "running" } : prev, + ) } export function applyGatewayStatusToStore( @@ -64,21 +113,92 @@ export function applyGatewayStatusToStore( >, ) { updateGatewayStore((prev) => ({ - status: data.gateway_status ?? prev.status, - canStart: data.gateway_start_allowed ?? prev.canStart, - restartRequired: - data.gateway_restart_required ?? - (data.gateway_status && data.gateway_status !== "running" + status: + prev.status === "stopping" && data.gateway_status === "running" + ? "stopping" + : (data.gateway_status ?? prev.status), + canStart: + prev.status === "stopping" && data.gateway_status === "running" ? false - : prev.restartRequired), + : (data.gateway_start_allowed ?? prev.canStart), + restartRequired: + prev.status === "stopping" && data.gateway_status === "running" + ? false + : (data.gateway_restart_required ?? prev.restartRequired), })) } -export async function refreshGatewayState() { +function nextGatewayPollInterval() { + const status = getDefaultStore().get(gatewayAtom).status + if ( + status === "starting" || + status === "restarting" || + status === "stopping" + ) { + return GATEWAY_TRANSIENT_POLL_INTERVAL_MS + } + return GATEWAY_POLL_INTERVAL_MS +} + +function scheduleGatewayPoll(delay = nextGatewayPollInterval()) { + if (gatewayPollingSubscribers === 0) { + return + } + + if (gatewayPollingTimer !== null) { + clearTimeout(gatewayPollingTimer) + } + + gatewayPollingTimer = setTimeout(() => { + gatewayPollingTimer = null + void refreshGatewayState() + }, delay) +} + +export async function refreshGatewayState( + options: RefreshGatewayStateOptions = {}, +) { + if (gatewayPollingRequest) { + await gatewayPollingRequest + if (options.force) { + return refreshGatewayState() + } + return + } + + gatewayPollingRequest = (async () => { + try { + const status = await getGatewayStatus() + applyGatewayStatusToStore(status) + } catch { + // Preserve the last known state when a poll fails. + } finally { + gatewayPollingRequest = null + scheduleGatewayPoll() + } + })() + try { - const status = await getGatewayStatus() - applyGatewayStatusToStore(status) - } catch { - updateGatewayStore(DEFAULT_GATEWAY_STATE) + await gatewayPollingRequest + } finally { + if (gatewayPollingSubscribers === 0 && gatewayPollingTimer !== null) { + clearTimeout(gatewayPollingTimer) + gatewayPollingTimer = null + } + } +} + +export function subscribeGatewayPolling() { + gatewayPollingSubscribers += 1 + if (gatewayPollingSubscribers === 1) { + void refreshGatewayState() + } + + return () => { + gatewayPollingSubscribers = Math.max(0, gatewayPollingSubscribers - 1) + if (gatewayPollingSubscribers === 0 && gatewayPollingTimer !== null) { + clearTimeout(gatewayPollingTimer) + gatewayPollingTimer = null + } } } From 7b9fdaec3229422fa9d81d3100eaea0ec8878acb Mon Sep 17 00:00:00 2001 From: wenjie <meetwenjie@gmail.com> Date: Tue, 17 Mar 2026 18:56:52 +0800 Subject: [PATCH 46/56] feat(config): add exec controls and gate cron commands on exec settings (#1685) - add a dedicated exec settings section in the config page - support timeout and custom allow/deny regex patterns for exec - validate custom exec regex patterns in the config API - block cron command scheduling and execution when exec is disabled - update tests and i18n strings for the new command settings --- pkg/tools/cron.go | 37 +++++-- pkg/tools/cron_test.go | 49 +++++++++ web/backend/api/config.go | 22 ++++ web/backend/api/config_test.go | 79 ++++++++++++++ .../src/components/config/config-page.tsx | 30 +++++- .../src/components/config/config-sections.tsx | 102 ++++++++++++++++-- .../src/components/config/form-model.ts | 42 ++++++++ web/frontend/src/i18n/locales/en.json | 24 +++-- web/frontend/src/i18n/locales/zh.json | 22 +++- 9 files changed, 379 insertions(+), 28 deletions(-) diff --git a/pkg/tools/cron.go b/pkg/tools/cron.go index aa22f9aa6..154ec75f0 100644 --- a/pkg/tools/cron.go +++ b/pkg/tools/cron.go @@ -25,6 +25,7 @@ type CronTool struct { msgBus *bus.MessageBus execTool *ExecTool allowCommand bool + execEnabled bool } // NewCronTool creates a new CronTool @@ -33,23 +34,32 @@ func NewCronTool( cronService *cron.CronService, executor JobExecutor, msgBus *bus.MessageBus, workspace string, restrict bool, execTimeout time.Duration, config *config.Config, ) (*CronTool, error) { - execTool, err := NewExecToolWithConfig(workspace, restrict, config) - if err != nil { - return nil, fmt.Errorf("unable to configure exec tool: %w", err) - } - allowCommand := true + execEnabled := true if config != nil { allowCommand = config.Tools.Cron.AllowCommand + execEnabled = config.Tools.Exec.Enabled } - execTool.SetTimeout(execTimeout) + var execTool *ExecTool + if execEnabled { + var err error + execTool, err = NewExecToolWithConfig(workspace, restrict, config) + if err != nil { + return nil, fmt.Errorf("unable to configure exec tool: %w", err) + } + } + + if execTool != nil { + execTool.SetTimeout(execTimeout) + } return &CronTool{ cronService: cronService, executor: executor, msgBus: msgBus, execTool: execTool, allowCommand: allowCommand, + execEnabled: execEnabled, }, nil } @@ -193,6 +203,9 @@ func (t *CronTool) addJob(ctx context.Context, args map[string]any) *ToolResult command, _ := args["command"].(string) commandConfirm, _ := args["command_confirm"].(bool) if command != "" { + if !t.execEnabled { + return ErrorResult("command execution is disabled") + } if !constants.IsInternalChannel(channel) { return ErrorResult("scheduling command execution is restricted to internal channels") } @@ -298,6 +311,18 @@ func (t *CronTool) ExecuteJob(ctx context.Context, job *cron.CronJob) string { // Execute command if present if job.Payload.Command != "" { + if !t.execEnabled || t.execTool == nil { + output := "Error executing scheduled command: command execution is disabled" + pubCtx, pubCancel := context.WithTimeout(context.Background(), 5*time.Second) + defer pubCancel() + t.msgBus.PublishOutbound(pubCtx, bus.OutboundMessage{ + Channel: channel, + ChatID: chatID, + Content: output, + }) + return "ok" + } + args := map[string]any{ "command": job.Payload.Command, "__channel": channel, diff --git a/pkg/tools/cron_test.go b/pkg/tools/cron_test.go index e46b13b13..09d29b6fa 100644 --- a/pkg/tools/cron_test.go +++ b/pkg/tools/cron_test.go @@ -5,6 +5,7 @@ import ( "path/filepath" "strings" "testing" + "time" "github.com/sipeed/picoclaw/pkg/bus" "github.com/sipeed/picoclaw/pkg/config" @@ -112,6 +113,28 @@ func TestCronTool_CommandAllowedWithConfirmWhenAllowCommandDisabled(t *testing.T } } +func TestCronTool_CommandBlockedWhenExecDisabled(t *testing.T) { + cfg := config.DefaultConfig() + cfg.Tools.Exec.Enabled = false + + tool := newTestCronToolWithConfig(t, cfg) + ctx := WithToolContext(context.Background(), "cli", "direct") + result := tool.Execute(ctx, map[string]any{ + "action": "add", + "message": "check disk", + "command": "df -h", + "command_confirm": true, + "at_seconds": float64(60), + }) + + if !result.IsError { + t.Fatal("expected command scheduling to be blocked when exec is disabled") + } + if !strings.Contains(result.ForLLM, "command execution is disabled") { + t.Errorf("expected exec disabled message, got: %s", result.ForLLM) + } +} + // TestCronTool_CommandAllowedFromInternalChannel verifies command scheduling works from internal channels func TestCronTool_CommandAllowedFromInternalChannel(t *testing.T) { tool := newTestCronTool(t) @@ -185,3 +208,29 @@ func TestCronTool_NonCommandJobDefaultsDeliverToFalse(t *testing.T) { t.Fatal("expected deliver=false by default for non-command jobs") } } + +func TestCronTool_ExecuteJobPublishesErrorWhenExecDisabled(t *testing.T) { + cfg := config.DefaultConfig() + cfg.Tools.Exec.Enabled = false + + tool := newTestCronToolWithConfig(t, cfg) + job := &cron.CronJob{} + job.Payload.Channel = "cli" + job.Payload.To = "direct" + job.Payload.Command = "df -h" + + if got := tool.ExecuteJob(context.Background(), job); got != "ok" { + t.Fatalf("ExecuteJob() = %q, want ok", got) + } + + ctx, cancel := context.WithTimeout(context.Background(), time.Second) + defer cancel() + + msg, ok := tool.msgBus.SubscribeOutbound(ctx) + if !ok { + t.Fatal("expected outbound message") + } + if !strings.Contains(msg.Content, "command execution is disabled") { + t.Fatalf("expected exec disabled message, got: %s", msg.Content) + } +} diff --git a/web/backend/api/config.go b/web/backend/api/config.go index 091e3fbae..a7d5b3c5d 100644 --- a/web/backend/api/config.go +++ b/web/backend/api/config.go @@ -5,6 +5,7 @@ import ( "fmt" "io" "net/http" + "regexp" "github.com/sipeed/picoclaw/pkg/config" ) @@ -188,6 +189,27 @@ func validateConfig(cfg *config.Config) []string { errs = append(errs, "channels.discord.token is required when discord channel is enabled") } + if cfg.Tools.Exec.Enabled { + if cfg.Tools.Exec.EnableDenyPatterns { + errs = append( + errs, + validateRegexPatterns("tools.exec.custom_deny_patterns", cfg.Tools.Exec.CustomDenyPatterns)...) + } + errs = append( + errs, + validateRegexPatterns("tools.exec.custom_allow_patterns", cfg.Tools.Exec.CustomAllowPatterns)...) + } + + return errs +} + +func validateRegexPatterns(field string, patterns []string) []string { + var errs []string + for index, pattern := range patterns { + if _, err := regexp.Compile(pattern); err != nil { + errs = append(errs, fmt.Sprintf("%s[%d] is not a valid regular expression: %v", field, index, err)) + } + } return errs } diff --git a/web/backend/api/config_test.go b/web/backend/api/config_test.go index 29811e37e..54ec8e857 100644 --- a/web/backend/api/config_test.go +++ b/web/backend/api/config_test.go @@ -86,3 +86,82 @@ func TestHandleUpdateConfig_DoesNotInheritDefaultModelFields(t *testing.T) { t.Fatalf("model_list[0].api_base = %q, want empty string", got) } } + +func TestHandlePatchConfig_RejectsInvalidExecRegexPatterns(t *testing.T) { + configPath, cleanup := setupOAuthTestEnv(t) + defer cleanup() + + h := NewHandler(configPath) + mux := http.NewServeMux() + h.RegisterRoutes(mux) + + req := httptest.NewRequest(http.MethodPatch, "/api/config", bytes.NewBufferString(`{ + "tools": { + "exec": { + "custom_deny_patterns": ["("] + } + } + }`)) + req.Header.Set("Content-Type", "application/json") + + rec := httptest.NewRecorder() + mux.ServeHTTP(rec, req) + if rec.Code != http.StatusBadRequest { + t.Fatalf("status = %d, want %d, body=%s", rec.Code, http.StatusBadRequest, rec.Body.String()) + } + if !bytes.Contains(rec.Body.Bytes(), []byte("custom_deny_patterns")) { + t.Fatalf("expected validation error mentioning custom_deny_patterns, body=%s", rec.Body.String()) + } +} + +func TestHandlePatchConfig_AllowsInvalidExecRegexPatternsWhenExecDisabled(t *testing.T) { + configPath, cleanup := setupOAuthTestEnv(t) + defer cleanup() + + h := NewHandler(configPath) + mux := http.NewServeMux() + h.RegisterRoutes(mux) + + req := httptest.NewRequest(http.MethodPatch, "/api/config", bytes.NewBufferString(`{ + "tools": { + "exec": { + "enabled": false, + "custom_deny_patterns": ["("], + "custom_allow_patterns": ["("] + } + } + }`)) + req.Header.Set("Content-Type", "application/json") + + rec := httptest.NewRecorder() + mux.ServeHTTP(rec, req) + if rec.Code != http.StatusOK { + t.Fatalf("status = %d, want %d, body=%s", rec.Code, http.StatusOK, rec.Body.String()) + } +} + +func TestHandlePatchConfig_AllowsInvalidDenyRegexPatternsWhenDenyPatternsDisabled(t *testing.T) { + configPath, cleanup := setupOAuthTestEnv(t) + defer cleanup() + + h := NewHandler(configPath) + mux := http.NewServeMux() + h.RegisterRoutes(mux) + + req := httptest.NewRequest(http.MethodPatch, "/api/config", bytes.NewBufferString(`{ + "tools": { + "exec": { + "enabled": true, + "enable_deny_patterns": false, + "custom_deny_patterns": ["("] + } + } + }`)) + req.Header.Set("Content-Type", "application/json") + + rec := httptest.NewRecorder() + mux.ServeHTTP(rec, req) + if rec.Code != http.StatusOK { + t.Fatalf("status = %d, want %d, body=%s", rec.Code, http.StatusOK, rec.Body.String()) + } +} diff --git a/web/frontend/src/components/config/config-page.tsx b/web/frontend/src/components/config/config-page.tsx index 130498ba4..e533b956f 100644 --- a/web/frontend/src/components/config/config-page.tsx +++ b/web/frontend/src/components/config/config-page.tsx @@ -16,6 +16,7 @@ import { AgentDefaultsSection, CronSection, DevicesSection, + ExecSection, LauncherSection, RuntimeSection, } from "@/components/config/config-sections" @@ -27,6 +28,7 @@ import { buildFormFromConfig, parseCIDRText, parseIntField, + parseMultilineList, } from "@/components/config/form-model" import { PageHeader } from "@/components/page-header" import { Button } from "@/components/ui/button" @@ -170,6 +172,28 @@ export function ConfigPage() { "Cron exec timeout", { min: 0 }, ) + const execConfigPatch: Record<string, unknown> = { + enabled: form.execEnabled, + } + + if (form.execEnabled) { + execConfigPatch.allow_remote = form.allowRemote + execConfigPatch.enable_deny_patterns = form.enableDenyPatterns + execConfigPatch.custom_allow_patterns = parseMultilineList( + form.customAllowPatternsText, + ) + execConfigPatch.timeout_seconds = parseIntField( + form.execTimeoutSeconds, + "Exec timeout", + { min: 0 }, + ) + + if (form.enableDenyPatterns) { + execConfigPatch.custom_deny_patterns = parseMultilineList( + form.customDenyPatternsText, + ) + } + } await patchAppConfig({ agents: { @@ -190,9 +214,7 @@ export function ConfigPage() { allow_command: form.allowCommand, exec_timeout_minutes: cronExecTimeoutMinutes, }, - exec: { - allow_remote: form.allowRemote, - }, + exec: execConfigPatch, }, heartbeat: { enabled: form.heartbeatEnabled, @@ -289,6 +311,8 @@ export function ConfigPage() { <RuntimeSection form={form} onFieldChange={updateField} /> + <ExecSection form={form} onFieldChange={updateField} /> + <CronSection form={form} onFieldChange={updateField} /> <LauncherSection diff --git a/web/frontend/src/components/config/config-sections.tsx b/web/frontend/src/components/config/config-sections.tsx index 04b9e528b..517185eda 100644 --- a/web/frontend/src/components/config/config-sections.tsx +++ b/web/frontend/src/components/config/config-sections.tsx @@ -93,14 +93,6 @@ export function AgentDefaultsSection({ } /> - <SwitchCardField - label={t("pages.config.allow_remote")} - hint={t("pages.config.allow_remote_hint")} - layout="setting-row" - checked={form.allowRemote} - onCheckedChange={(checked) => onFieldChange("allowRemote", checked)} - /> - <Field label={t("pages.config.max_tokens")} hint={t("pages.config.max_tokens_hint")} @@ -161,6 +153,98 @@ export function AgentDefaultsSection({ ) } +interface ExecSectionProps { + form: CoreConfigForm + onFieldChange: UpdateCoreField +} + +export function ExecSection({ form, onFieldChange }: ExecSectionProps) { + const { t } = useTranslation() + + return ( + <ConfigSectionCard title={t("pages.config.sections.exec")}> + <SwitchCardField + label={t("pages.config.exec_enabled")} + hint={t("pages.config.exec_enabled_hint")} + layout="setting-row" + checked={form.execEnabled} + onCheckedChange={(checked) => onFieldChange("execEnabled", checked)} + /> + + {form.execEnabled && ( + <> + <SwitchCardField + label={t("pages.config.allow_remote")} + hint={t("pages.config.allow_remote_hint")} + layout="setting-row" + checked={form.allowRemote} + onCheckedChange={(checked) => onFieldChange("allowRemote", checked)} + /> + + <SwitchCardField + label={t("pages.config.enable_deny_patterns")} + hint={t("pages.config.enable_deny_patterns_hint")} + layout="setting-row" + checked={form.enableDenyPatterns} + onCheckedChange={(checked) => + onFieldChange("enableDenyPatterns", checked) + } + /> + + {form.enableDenyPatterns && ( + <Field + label={t("pages.config.custom_deny_patterns")} + hint={t("pages.config.custom_deny_patterns_hint")} + layout="setting-row" + controlClassName="md:max-w-md" + > + <Textarea + value={form.customDenyPatternsText} + placeholder={t("pages.config.custom_patterns_placeholder")} + className="min-h-[88px]" + onChange={(e) => + onFieldChange("customDenyPatternsText", e.target.value) + } + /> + </Field> + )} + + <Field + label={t("pages.config.custom_allow_patterns")} + hint={t("pages.config.custom_allow_patterns_hint")} + layout="setting-row" + controlClassName="md:max-w-md" + > + <Textarea + value={form.customAllowPatternsText} + placeholder={t("pages.config.custom_patterns_placeholder")} + className="min-h-[88px]" + onChange={(e) => + onFieldChange("customAllowPatternsText", e.target.value) + } + /> + </Field> + + <Field + label={t("pages.config.exec_timeout_seconds")} + hint={t("pages.config.exec_timeout_seconds_hint")} + layout="setting-row" + > + <Input + type="number" + min={0} + value={form.execTimeoutSeconds} + onChange={(e) => + onFieldChange("execTimeoutSeconds", e.target.value) + } + /> + </Field> + </> + )} + </ConfigSectionCard> + ) +} + interface RuntimeSectionProps { form: CoreConfigForm onFieldChange: UpdateCoreField @@ -251,6 +335,7 @@ export function CronSection({ form, onFieldChange }: CronSectionProps) { hint={t("pages.config.allow_shell_execution_hint")} layout="setting-row" checked={form.allowCommand} + disabled={!form.execEnabled} onCheckedChange={(checked) => onFieldChange("allowCommand", checked)} /> @@ -262,6 +347,7 @@ export function CronSection({ form, onFieldChange }: CronSectionProps) { <Input type="number" min={0} + disabled={!form.execEnabled} value={form.cronExecTimeoutMinutes} onChange={(e) => onFieldChange("cronExecTimeoutMinutes", e.target.value) diff --git a/web/frontend/src/components/config/form-model.ts b/web/frontend/src/components/config/form-model.ts index 8c850b2c4..90d849274 100644 --- a/web/frontend/src/components/config/form-model.ts +++ b/web/frontend/src/components/config/form-model.ts @@ -3,7 +3,12 @@ export type JsonRecord = Record<string, unknown> export interface CoreConfigForm { workspace: string restrictToWorkspace: boolean + execEnabled: boolean allowRemote: boolean + enableDenyPatterns: boolean + customDenyPatternsText: string + customAllowPatternsText: string + execTimeoutSeconds: string allowCommand: boolean cronExecTimeoutMinutes: string maxTokens: string @@ -57,7 +62,12 @@ export const DM_SCOPE_OPTIONS = [ export const EMPTY_FORM: CoreConfigForm = { workspace: "", restrictToWorkspace: true, + execEnabled: true, allowRemote: true, + enableDenyPatterns: true, + customDenyPatternsText: "", + customAllowPatternsText: "", + execTimeoutSeconds: "0", allowCommand: true, cronExecTimeoutMinutes: "5", maxTokens: "32768", @@ -119,10 +129,32 @@ export function buildFormFromConfig(config: unknown): CoreConfigForm { defaults.restrict_to_workspace === undefined ? EMPTY_FORM.restrictToWorkspace : asBool(defaults.restrict_to_workspace), + execEnabled: + exec.enabled === undefined + ? EMPTY_FORM.execEnabled + : asBool(exec.enabled), allowRemote: exec.allow_remote === undefined ? EMPTY_FORM.allowRemote : asBool(exec.allow_remote), + enableDenyPatterns: + exec.enable_deny_patterns === undefined + ? EMPTY_FORM.enableDenyPatterns + : asBool(exec.enable_deny_patterns), + customDenyPatternsText: Array.isArray(exec.custom_deny_patterns) + ? exec.custom_deny_patterns + .filter((value): value is string => typeof value === "string") + .join("\n") + : EMPTY_FORM.customDenyPatternsText, + customAllowPatternsText: Array.isArray(exec.custom_allow_patterns) + ? exec.custom_allow_patterns + .filter((value): value is string => typeof value === "string") + .join("\n") + : EMPTY_FORM.customAllowPatternsText, + execTimeoutSeconds: asNumberString( + exec.timeout_seconds, + EMPTY_FORM.execTimeoutSeconds, + ), allowCommand: cron.allow_command === undefined ? EMPTY_FORM.allowCommand @@ -191,3 +223,13 @@ export function parseCIDRText(raw: string): string[] { .map((v) => v.trim()) .filter((v) => v.length > 0) } + +export function parseMultilineList(raw: string): string[] { + if (!raw.trim()) { + return [] + } + return raw + .split("\n") + .map((value) => value.trim()) + .filter((value) => value.length > 0) +} diff --git a/web/frontend/src/i18n/locales/en.json b/web/frontend/src/i18n/locales/en.json index 327b4c646..0b9d8c614 100644 --- a/web/frontend/src/i18n/locales/en.json +++ b/web/frontend/src/i18n/locales/en.json @@ -393,12 +393,23 @@ "workspace_hint": "Base directory for agent file operations.", "restrict_workspace": "Restrict to Workspace", "restrict_workspace_hint": "Only allow file operations inside workspace.", - "allow_remote": "Allow Remote Shell Execution", - "allow_remote_hint": "When enabled, shell commands can also run for remote sessions or non-local contexts. When disabled, shell execution stays limited to local safe contexts.", - "allow_shell_execution": "Allow Shell Execution", - "allow_shell_execution_hint": "Enable scheduled shell commands for cron jobs by default. When disabled, users must pass command_confirm=true to schedule a cron command.", - "cron_exec_timeout": "Cron Command Timeout (minutes)", - "cron_exec_timeout_hint": "Maximum runtime for scheduled shell commands. Set to 0 to disable the timeout.", + "exec_enabled": "Allow Commands", + "exec_enabled_hint": "Enable or disable command execution for the app. When disabled, no command requests will run.", + "allow_remote": "Allow Remote Commands", + "allow_remote_hint": "When enabled, remote sessions or non-local contexts can also run commands. When disabled, command execution stays limited to local safe contexts.", + "enable_deny_patterns": "Enable Blacklist", + "enable_deny_patterns_hint": "When enabled, the app blocks commands that match its built-in dangerous patterns and the custom command blacklist below.", + "exec_timeout_seconds": "Command Timeout (seconds)", + "exec_timeout_seconds_hint": "Maximum runtime for command requests. Set to 0 to use the default timeout.", + "custom_deny_patterns": "Command Blacklist", + "custom_deny_patterns_hint": "Add extra command-blocking rules, one regular expression per line. A command matching any rule here will be blocked.", + "custom_allow_patterns": "Command Whitelist", + "custom_allow_patterns_hint": "Add extra command-allow rules, one regular expression per line. A command matching any rule here skips blacklist matching, but other safety limits still apply.", + "custom_patterns_placeholder": "^rm\\s+-rf\\b\n^git\\s+push\\b", + "allow_shell_execution": "Allow Scheduled Commands", + "allow_shell_execution_hint": "Allow scheduled tasks to run commands by default. When disabled, users must pass command_confirm=true to schedule a command task.", + "cron_exec_timeout": "Scheduled Command Timeout (minutes)", + "cron_exec_timeout_hint": "Maximum runtime for scheduled commands. Set to 0 to disable the timeout.", "max_tokens": "Max Tokens", "max_tokens_hint": "Upper token limit per model response.", "max_tool_iterations": "Max Tool Iterations", @@ -439,6 +450,7 @@ "sections": { "agent": "Agent", "runtime": "Runtime", + "exec": "Run Commands", "cron": "Cron Tasks", "launcher": "Service", "devices": "Devices" diff --git a/web/frontend/src/i18n/locales/zh.json b/web/frontend/src/i18n/locales/zh.json index cd674ddc1..c0aa158a2 100644 --- a/web/frontend/src/i18n/locales/zh.json +++ b/web/frontend/src/i18n/locales/zh.json @@ -393,12 +393,23 @@ "workspace_hint": "智能体执行文件读写操作时使用的基础目录。", "restrict_workspace": "限制工作目录访问", "restrict_workspace_hint": "仅允许在工作目录内执行文件操作。", - "allow_remote": "允许远程执行 Shell 命令", - "allow_remote_hint": "开启后,来自远程会话或非本地上下文的请求也可以执行 shell 命令;关闭后,仅允许本地安全上下文执行。", - "allow_shell_execution": "允许 Shell 执行", - "allow_shell_execution_hint": "开启后,cron 定时任务默认允许执行 shell 命令。关闭后,必须显式传入 command_confirm=true 才能创建 cron 命令任务。", + "exec_enabled": "允许命令执行", + "exec_enabled_hint": "控制应用是否允许执行命令。关闭后,所有命令请求都不会执行。", + "allow_remote": "允许远程命令执行", + "allow_remote_hint": "开启后,来自远程会话或非本地上下文的请求也可以执行命令;关闭后,仅允许本地安全上下文执行命令。", + "enable_deny_patterns": "启用黑名单", + "enable_deny_patterns_hint": "开启后,应用会拦截匹配内置危险模式以及下方自定义命令黑名单的命令。", + "exec_timeout_seconds": "命令超时(秒)", + "exec_timeout_seconds_hint": "命令请求的最长运行时间。设置为 0 表示使用默认超时。", + "custom_deny_patterns": "命令黑名单", + "custom_deny_patterns_hint": "用于补充额外的命令拦截规则,每行一个正则表达式。命中任意一条规则的命令都会被阻止。", + "custom_allow_patterns": "命令白名单", + "custom_allow_patterns_hint": "用于补充额外的命令放行规则,每行一个正则表达式。命中任意一条规则的命令会跳过黑名单检查,但仍受其他安全限制约束。", + "custom_patterns_placeholder": "^rm\\s+-rf\\b\n^git\\s+push\\b", + "allow_shell_execution": "允许定时任务运行命令", + "allow_shell_execution_hint": "开启后,定时任务默认允许运行命令。关闭后,必须显式传入 command_confirm=true 才能创建运行命令的定时任务。", "cron_exec_timeout": "定时命令超时(分钟)", - "cron_exec_timeout_hint": "定时 shell 命令的最长执行时间。设置为 0 表示不限制超时。", + "cron_exec_timeout_hint": "定时任务中命令的最长运行时间。设置为 0 表示不限制超时。", "max_tokens": "最大 Token 数", "max_tokens_hint": "单次模型响应允许的最大 Token 数。", "max_tool_iterations": "最大工具迭代次数", @@ -439,6 +450,7 @@ "sections": { "agent": "智能体", "runtime": "运行时", + "exec": "运行命令", "cron": "定时任务", "launcher": "服务参数", "devices": "设备" From afe22c5adf882238f371c60f6d07c48889579433 Mon Sep 17 00:00:00 2001 From: Cytown <cytown@gmail.com> Date: Tue, 17 Mar 2026 19:07:36 +0800 Subject: [PATCH 47/56] bug fix: gateway should not start when gateway server is not running (#1562) --- pkg/channels/manager.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pkg/channels/manager.go b/pkg/channels/manager.go index 8121525ab..7d49a0e30 100644 --- a/pkg/channels/manager.go +++ b/pkg/channels/manager.go @@ -396,7 +396,7 @@ func (m *Manager) StartAll(ctx context.Context) error { "addr": m.httpServer.Addr, }) if err := m.httpServer.ListenAndServe(); err != nil && err != http.ErrServerClosed { - logger.ErrorCF("channels", "Shared HTTP server error", map[string]any{ + logger.FatalCF("channels", "Shared HTTP server error", map[string]any{ "error": err.Error(), }) } From da1fddc4f0ce0fe97a0b2c6c0e07f4032a805248 Mon Sep 17 00:00:00 2001 From: Alix-007 <267018309+Alix-007@users.noreply.github.com> Date: Tue, 17 Mar 2026 19:43:02 +0800 Subject: [PATCH 48/56] docs(exec): document build tool guard limitation --- README.md | 15 +++++++++++++++ docs/tools_configuration.md | 16 ++++++++++++++++ 2 files changed, 31 insertions(+) diff --git a/README.md b/README.md index 159ac706f..328d59f8c 100644 --- a/README.md +++ b/README.md @@ -861,6 +861,21 @@ Even with `restrict_to_workspace: false`, the `exec` tool blocks these dangerous * `shutdown`, `reboot`, `poweroff` — System shutdown * Fork bomb `:(){ :|:& };:` +#### Known Limitation: Child Processes From Build Tools + +The exec safety guard only inspects the command line PicoClaw launches directly. It does not recursively inspect child +processes spawned by allowed developer tools such as `make`, `go run`, `cargo`, `npm run`, or custom build scripts. + +That means a top-level command can still compile or launch other binaries after it passes the initial guard check. In +practice, treat build scripts, Makefiles, package scripts, and generated binaries as executable code that needs the same +level of review as a direct shell command. + +For higher-risk environments: + +* Review build scripts before execution. +* Prefer approval/manual review for compile-and-run workflows. +* Run PicoClaw inside a container or VM if you need stronger isolation than the built-in guard provides. + #### Error Examples ``` diff --git a/docs/tools_configuration.md b/docs/tools_configuration.md index 8c8eb31f0..43810d5f8 100644 --- a/docs/tools_configuration.md +++ b/docs/tools_configuration.md @@ -84,6 +84,22 @@ By default, PicoClaw blocks the following dangerous commands: - Git: `git push`, `git force` - Other: `eval`, `source *.sh` +### Known Architectural Limitation + +The exec guard only validates the top-level command sent to PicoClaw. It does **not** recursively inspect child +processes spawned by build tools or scripts after that command starts running. + +Examples of workflows that can bypass the direct command guard once the initial command is allowed: + +- `make run` +- `go run ./cmd/...` +- `cargo run` +- `npm run build` + +This means the guard is useful for blocking obviously dangerous direct commands, but it is **not** a full sandbox for +unreviewed build pipelines. If your threat model includes untrusted code in the workspace, use stronger isolation such +as containers, VMs, or an approval flow around build-and-run commands. + ### Configuration Example ```json From 174fbba14c10cafe64010df36d2fc6f2d4375bab Mon Sep 17 00:00:00 2001 From: wenjie <meetwenjie@gmail.com> Date: Tue, 17 Mar 2026 19:43:44 +0800 Subject: [PATCH 49/56] refactor(backend): add darwin no-cgo tray fallback (#1689) --- web/backend/app_runtime.go | 46 +++++++++++++++++++++++++ web/backend/main.go | 9 ++--- web/backend/systray.go | 48 +++------------------------ web/backend/tray_stub_darwin_nocgo.go | 32 ++++++++++++++++++ 4 files changed, 86 insertions(+), 49 deletions(-) create mode 100644 web/backend/app_runtime.go create mode 100644 web/backend/tray_stub_darwin_nocgo.go diff --git a/web/backend/app_runtime.go b/web/backend/app_runtime.go new file mode 100644 index 000000000..cf54e18a1 --- /dev/null +++ b/web/backend/app_runtime.go @@ -0,0 +1,46 @@ +package main + +import ( + "context" + "fmt" + "time" + + "github.com/sipeed/picoclaw/pkg/logger" + "github.com/sipeed/picoclaw/web/backend/utils" +) + +const ( + browserDelay = 500 * time.Millisecond + shutdownTimeout = 15 * time.Second +) + +func shutdownApp() { + fmt.Println(T(Exiting)) + + if apiHandler != nil { + apiHandler.Shutdown() + } + + if server != nil { + server.SetKeepAlivesEnabled(false) + + ctx, cancel := context.WithTimeout(context.Background(), shutdownTimeout) + defer cancel() + if err := server.Shutdown(ctx); err != nil { + if err == context.DeadlineExceeded { + logger.Infof("Server shutdown timeout after %v, forcing close", shutdownTimeout) + } else { + logger.Errorf("Server shutdown error: %v", err) + } + } else { + logger.Infof("Server shutdown completed successfully") + } + } +} + +func openBrowser() error { + if serverAddr == "" { + return fmt.Errorf("server address not set") + } + return utils.OpenBrowser(serverAddr) +} diff --git a/web/backend/main.go b/web/backend/main.go index f2fe3de97..ec4e2832d 100644 --- a/web/backend/main.go +++ b/web/backend/main.go @@ -22,8 +22,6 @@ import ( "strconv" "time" - "fyne.io/systray" - "github.com/sipeed/picoclaw/pkg/config" "github.com/sipeed/picoclaw/web/backend/api" "github.com/sipeed/picoclaw/web/backend/launcherconfig" @@ -168,10 +166,10 @@ func main() { } fmt.Println() - // Set server address for systray + // Share the local URL with the launcher runtime. serverAddr = fmt.Sprintf("http://localhost:%s", effectivePort) - // Auto-open browser will be handled by systray onReady + // Auto-open browser will be handled by the launcher runtime. // Auto-start gateway after backend starts listening. go func() { @@ -188,6 +186,5 @@ func main() { } }() - // Start system tray - systray.Run(onReady, onExit) + runTray() } diff --git a/web/backend/systray.go b/web/backend/systray.go index 1ff98c71b..902cc65e0 100644 --- a/web/backend/systray.go +++ b/web/backend/systray.go @@ -1,10 +1,10 @@ +//go:build !darwin || cgo + package main import ( - "context" _ "embed" "fmt" - "time" "fyne.io/systray" @@ -12,10 +12,9 @@ import ( "github.com/sipeed/picoclaw/web/backend/utils" ) -const ( - browserDelay = 500 * time.Millisecond - shutdownTimeout = 15 * time.Second -) +func runTray() { + systray.Run(onReady, shutdownApp) +} // onReady is called when the system tray is ready func onReady() { @@ -90,43 +89,6 @@ func onReady() { } } -// onExit is called when the system tray is exiting -func onExit() { - fmt.Println(T(Exiting)) - - // First, shutdown API handler - if apiHandler != nil { - apiHandler.Shutdown() - } - - if server != nil { - // Disable keep-alive to allow graceful shutdown - server.SetKeepAlivesEnabled(false) - - ctx, cancel := context.WithTimeout(context.Background(), shutdownTimeout) - defer cancel() - if err := server.Shutdown(ctx); err != nil { - // Context deadline exceeded is expected if there are active connections - // This is not necessarily an error, so log it at info level - if err == context.DeadlineExceeded { - logger.Infof("Server shutdown timeout after %v, forcing close", shutdownTimeout) - } else { - logger.Errorf("Server shutdown error: %v", err) - } - } else { - logger.Infof("Server shutdown completed successfully") - } - } -} - -// openBrowser opens the PicoClaw web console in the default browser -func openBrowser() error { - if serverAddr == "" { - return fmt.Errorf("server address not set") - } - return utils.OpenBrowser(serverAddr) -} - // getIcon returns the system tray icon func getIcon() []byte { return iconData diff --git a/web/backend/tray_stub_darwin_nocgo.go b/web/backend/tray_stub_darwin_nocgo.go new file mode 100644 index 000000000..c54aaac1b --- /dev/null +++ b/web/backend/tray_stub_darwin_nocgo.go @@ -0,0 +1,32 @@ +//go:build darwin && !cgo + +package main + +import ( + "context" + "os" + "os/signal" + "syscall" + "time" + + "github.com/sipeed/picoclaw/pkg/logger" +) + +func runTray() { + logger.Infof("System tray is unavailable in darwin builds without cgo; running without tray") + + if !*noBrowser { + go func() { + time.Sleep(browserDelay) + if err := openBrowser(); err != nil { + logger.Errorf("Warning: Failed to auto-open browser: %v", err) + } + }() + } + + ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM) + defer stop() + + <-ctx.Done() + shutdownApp() +} From 3e33d1053c222dcb0400c39657aba776cadf086b Mon Sep 17 00:00:00 2001 From: wenjie <meetwenjie@gmail.com> Date: Tue, 17 Mar 2026 20:13:11 +0800 Subject: [PATCH 50/56] fix(backend): add no-cgo tray fallback for darwin and freebsd (#1691) * refactor(backend): add darwin no-cgo tray fallback * fix(release): stub tray for freebsd builds without cgo --- web/backend/systray.go | 2 +- web/backend/tray_stub_nocgo.go | 33 +++++++++++++++++++++++++++++++++ 2 files changed, 34 insertions(+), 1 deletion(-) create mode 100644 web/backend/tray_stub_nocgo.go diff --git a/web/backend/systray.go b/web/backend/systray.go index 902cc65e0..2ae4434bb 100644 --- a/web/backend/systray.go +++ b/web/backend/systray.go @@ -1,4 +1,4 @@ -//go:build !darwin || cgo +//go:build (!darwin && !freebsd) || cgo package main diff --git a/web/backend/tray_stub_nocgo.go b/web/backend/tray_stub_nocgo.go new file mode 100644 index 000000000..13ecfd2cb --- /dev/null +++ b/web/backend/tray_stub_nocgo.go @@ -0,0 +1,33 @@ +//go:build (darwin || freebsd) && !cgo + +package main + +import ( + "context" + "os" + "os/signal" + "runtime" + "syscall" + "time" + + "github.com/sipeed/picoclaw/pkg/logger" +) + +func runTray() { + logger.Infof("System tray is unavailable in %s builds without cgo; running without tray", runtime.GOOS) + + if !*noBrowser { + go func() { + time.Sleep(browserDelay) + if err := openBrowser(); err != nil { + logger.Errorf("Warning: Failed to auto-open browser: %v", err) + } + }() + } + + ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM) + defer stop() + + <-ctx.Done() + shutdownApp() +} From 12c01327dd77ffcd4a7409bf9a0174a7169058d8 Mon Sep 17 00:00:00 2001 From: wenjie <meetwenjie@gmail.com> Date: Tue, 17 Mar 2026 20:34:11 +0800 Subject: [PATCH 51/56] Remove redundant Darwin tray stub (#1694) --- web/backend/tray_stub_darwin_nocgo.go | 32 --------------------------- 1 file changed, 32 deletions(-) delete mode 100644 web/backend/tray_stub_darwin_nocgo.go diff --git a/web/backend/tray_stub_darwin_nocgo.go b/web/backend/tray_stub_darwin_nocgo.go deleted file mode 100644 index c54aaac1b..000000000 --- a/web/backend/tray_stub_darwin_nocgo.go +++ /dev/null @@ -1,32 +0,0 @@ -//go:build darwin && !cgo - -package main - -import ( - "context" - "os" - "os/signal" - "syscall" - "time" - - "github.com/sipeed/picoclaw/pkg/logger" -) - -func runTray() { - logger.Infof("System tray is unavailable in darwin builds without cgo; running without tray") - - if !*noBrowser { - go func() { - time.Sleep(browserDelay) - if err := openBrowser(); err != nil { - logger.Errorf("Warning: Failed to auto-open browser: %v", err) - } - }() - } - - ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM) - defer stop() - - <-ctx.Done() - shutdownApp() -} From 5bc4fe4dea84e804548907754e5c02f1093b2faa Mon Sep 17 00:00:00 2001 From: BeaconCat <111232138+BeaconCat@users.noreply.github.com> Date: Tue, 17 Mar 2026 20:51:07 +0800 Subject: [PATCH 52/56] docs: add project identity statement and normalize NanoBot capitalization across all READMEs (#1695) Add a clear identity statement to all 6 README files clarifying that PicoClaw is an independent open-source project by Sipeed, written entirely in Go, and not a fork of OpenClaw, NanoBot, or any other project. This addresses common AI hallucinations found during testing of 11 AI tools. Also normalizes [nanobot] to [NanoBot] for consistent capitalization. Co-authored-by: BeaconCat <BeaconCat@users.noreply.github.com> Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com> --- README.fr.md | 4 +++- README.ja.md | 4 +++- README.md | 4 +++- README.pt-br.md | 4 +++- README.vi.md | 4 +++- README.zh.md | 4 +++- 6 files changed, 18 insertions(+), 6 deletions(-) diff --git a/README.fr.md b/README.fr.md index 49a02fb77..8d66efb66 100644 --- a/README.fr.md +++ b/README.fr.md @@ -23,7 +23,9 @@ --- -🦐 **PicoClaw** est un assistant personnel IA ultra-léger inspiré de [nanobot](https://github.com/HKUDS/nanobot), entièrement réécrit en **Go** via un processus d'auto-amorçage (self-bootstrapping) — où l'agent IA lui-même a piloté l'intégralité de la migration architecturale et de l'optimisation du code. +> **PicoClaw** est un projet open-source indépendant initié par [Sipeed](https://sipeed.com). Il est entièrement écrit en **Go** — ce n'est pas un fork d'OpenClaw, de NanoBot ou de tout autre projet. + +🦐 **PicoClaw** est un assistant personnel IA ultra-léger inspiré de [NanoBot](https://github.com/HKUDS/nanobot), entièrement réécrit en **Go** via un processus d'auto-amorçage (self-bootstrapping) — où l'agent IA lui-même a piloté l'intégralité de la migration architecturale et de l'optimisation du code. ⚡️ **Extrêmement léger :** Fonctionne sur du matériel à seulement **10$** avec **<10 Mo** de RAM. C'est 99% de mémoire en moins qu'OpenClaw et 98% moins cher qu'un Mac mini ! diff --git a/README.ja.md b/README.ja.md index c0d27de4f..be8e05554 100644 --- a/README.ja.md +++ b/README.ja.md @@ -26,7 +26,9 @@ --- -🦐 PicoClaw は [nanobot](https://github.com/HKUDS/nanobot) にインスパイアされた超軽量パーソナル AI アシスタントです。Go でゼロからリファクタリングされ、AI エージェント自身がアーキテクチャの移行とコード最適化を推進するセルフブートストラッピングプロセスで構築されました。 +> **PicoClaw** は [Sipeed](https://sipeed.com) が立ち上げた独立したオープンソースプロジェクトです。完全に **Go 言語**で一から書かれており、OpenClaw、NanoBot、その他のプロジェクトのフォークではありません。 + +🦐 PicoClaw は [NanoBot](https://github.com/HKUDS/nanobot) にインスパイアされた超軽量パーソナル AI アシスタントです。Go でゼロからリファクタリングされ、AI エージェント自身がアーキテクチャの移行とコード最適化を推進するセルフブートストラッピングプロセスで構築されました。 ⚡️ $10 のハードウェアで 10MB 未満の RAM で動作:OpenClaw より 99% 少ないメモリ、Mac mini より 98% 安い! diff --git a/README.md b/README.md index 328d59f8c..f607dc035 100644 --- a/README.md +++ b/README.md @@ -24,7 +24,9 @@ --- -🦐 PicoClaw is an ultra-lightweight personal AI Assistant inspired by [nanobot](https://github.com/HKUDS/nanobot), refactored from the ground up in Go through a self-bootstrapping process, where the AI agent itself drove the entire architectural migration and code optimization. +> **PicoClaw** is an independent open-source project initiated by [Sipeed](https://sipeed.com). It is written entirely in **Go** — not a fork of OpenClaw, NanoBot, or any other project. + +🦐 PicoClaw is an ultra-lightweight personal AI Assistant inspired by [NanoBot](https://github.com/HKUDS/nanobot), refactored from the ground up in Go through a self-bootstrapping process, where the AI agent itself drove the entire architectural migration and code optimization. ⚡️ Runs on $10 hardware with <10MB RAM: That's 99% less memory than OpenClaw and 98% cheaper than a Mac mini! diff --git a/README.pt-br.md b/README.pt-br.md index 56946139b..2d4ce1b8a 100644 --- a/README.pt-br.md +++ b/README.pt-br.md @@ -23,7 +23,9 @@ --- -🦐 **PicoClaw** é um assistente pessoal de IA ultra-leve inspirado no [nanobot](https://github.com/HKUDS/nanobot), reescrito do zero em **Go** por meio de um processo de "auto-inicialização" (self-bootstrapping) — onde o próprio agente de IA conduziu toda a migração de arquitetura e otimização de código. +> **PicoClaw** é um projeto open-source independente iniciado pela [Sipeed](https://sipeed.com). É escrito inteiramente em **Go** — não é um fork do OpenClaw, NanoBot ou qualquer outro projeto. + +🦐 **PicoClaw** é um assistente pessoal de IA ultra-leve inspirado no [NanoBot](https://github.com/HKUDS/nanobot), reescrito do zero em **Go** por meio de um processo de "auto-inicialização" (self-bootstrapping) — onde o próprio agente de IA conduziu toda a migração de arquitetura e otimização de código. ⚡️ **Extremamente leve:** Roda em hardware de apenas **$10** com **<10MB** de RAM. Isso é 99% menos memória que o OpenClaw e 98% mais barato que um Mac mini! diff --git a/README.vi.md b/README.vi.md index a542d6507..da77d0bf5 100644 --- a/README.vi.md +++ b/README.vi.md @@ -23,7 +23,9 @@ --- -🦐 **PicoClaw** là trợ lý AI cá nhân siêu nhẹ, lấy cảm hứng từ [nanobot](https://github.com/HKUDS/nanobot), được viết lại hoàn toàn bằng **Go** thông qua quá trình "tự khởi tạo" (self-bootstrapping) — nơi chính AI Agent đã tự dẫn dắt toàn bộ quá trình chuyển đổi kiến trúc và tối ưu hóa mã nguồn. +> **PicoClaw** là dự án mã nguồn mở độc lập được khởi xướng bởi [Sipeed](https://sipeed.com). Được viết hoàn toàn bằng **Go** — không phải là bản fork của OpenClaw, NanoBot hay bất kỳ dự án nào khác. + +🦐 **PicoClaw** là trợ lý AI cá nhân siêu nhẹ, lấy cảm hứng từ [NanoBot](https://github.com/HKUDS/nanobot), được viết lại hoàn toàn bằng **Go** thông qua quá trình "tự khởi tạo" (self-bootstrapping) — nơi chính AI Agent đã tự dẫn dắt toàn bộ quá trình chuyển đổi kiến trúc và tối ưu hóa mã nguồn. ⚡️ **Cực kỳ nhẹ:** Chạy trên phần cứng chỉ **$10** với RAM **<10MB**. Tiết kiệm 99% bộ nhớ so với OpenClaw và rẻ hơn 98% so với Mac mini! diff --git a/README.zh.md b/README.zh.md index 9877ef9f4..6eacec008 100644 --- a/README.zh.md +++ b/README.zh.md @@ -24,7 +24,9 @@ --- -🦐 **PicoClaw** 是一个受 [nanobot](https://github.com/HKUDS/nanobot) 启发的超轻量级个人 AI 助手。它采用 **Go 语言** 从零重构,经历了一个“自举”过程——即由 AI Agent 自身驱动了整个架构迁移和代码优化。 +> **PicoClaw** 是由 [矽速科技 (Sipeed)](https://sipeed.com) 发起的独立开源项目,完全使用 **Go 语言**从零编写——不是 OpenClaw、NanoBot 或其他项目的分支。 + +🦐 **PicoClaw** 是一个受 [NanoBot](https://github.com/HKUDS/nanobot) 启发的超轻量级个人 AI 助手。它采用 **Go 语言** 从零重构,经历了一个“自举”过程——即由 AI Agent 自身驱动了整个架构迁移和代码优化。 ⚡️ **极致轻量**:可在 **10 美元** 的硬件上运行,内存占用 **<10MB**。这意味着比 OpenClaw 节省 99% 的内存,比 Mac mini 便宜 98%! From b4468313e4510c4b68abb61e75be74d284e730ab Mon Sep 17 00:00:00 2001 From: Alix-007 <llagy007@gmail.com> Date: Tue, 17 Mar 2026 23:22:05 +0800 Subject: [PATCH 53/56] feat(web): whitelist private fetch targets (#1688) * feat(web): whitelist private fetch targets * test(web): avoid accept error shadowing --------- Co-authored-by: Alix-007 <267018309+Alix-007@users.noreply.github.com> --- config/config.example.json | 3 +- pkg/agent/loop.go | 7 +- pkg/config/config.go | 5 +- pkg/tools/web.go | 105 +++++++++++++++++++++++--- pkg/tools/web_test.go | 147 +++++++++++++++++++++++++++++++++++++ 5 files changed, 253 insertions(+), 14 deletions(-) diff --git a/config/config.example.json b/config/config.example.json index 14e209259..f05a09ef9 100644 --- a/config/config.example.json +++ b/config/config.example.json @@ -351,7 +351,8 @@ "search_engine": "search_std", "max_results": 5 }, - "fetch_limit_bytes": 10485760 + "fetch_limit_bytes": 10485760, + "private_host_whitelist": [] }, "cron": { "enabled": true, diff --git a/pkg/agent/loop.go b/pkg/agent/loop.go index 8328c691e..c25650201 100644 --- a/pkg/agent/loop.go +++ b/pkg/agent/loop.go @@ -159,7 +159,12 @@ func registerSharedTools( } } if cfg.Tools.IsToolEnabled("web_fetch") { - fetchTool, err := tools.NewWebFetchToolWithProxy(50000, cfg.Tools.Web.Proxy, cfg.Tools.Web.FetchLimitBytes) + fetchTool, err := tools.NewWebFetchToolWithConfig( + 50000, + cfg.Tools.Web.Proxy, + cfg.Tools.Web.FetchLimitBytes, + cfg.Tools.Web.PrivateHostWhitelist, + ) if err != nil { logger.ErrorCF("agent", "Failed to create web fetch tool", map[string]any{"error": err.Error()}) } else { diff --git a/pkg/config/config.go b/pkg/config/config.go index 6694ef3a1..005e44a30 100644 --- a/pkg/config/config.go +++ b/pkg/config/config.go @@ -695,8 +695,9 @@ type WebToolsConfig struct { GLMSearch GLMSearchConfig ` json:"glm_search"` // Proxy is an optional proxy URL for web tools (http/https/socks5/socks5h). // For authenticated proxies, prefer HTTP_PROXY/HTTPS_PROXY env vars instead of embedding credentials in config. - Proxy string `json:"proxy,omitempty" env:"PICOCLAW_TOOLS_WEB_PROXY"` - FetchLimitBytes int64 `json:"fetch_limit_bytes,omitempty" env:"PICOCLAW_TOOLS_WEB_FETCH_LIMIT_BYTES"` + Proxy string `json:"proxy,omitempty" env:"PICOCLAW_TOOLS_WEB_PROXY"` + FetchLimitBytes int64 `json:"fetch_limit_bytes,omitempty" env:"PICOCLAW_TOOLS_WEB_FETCH_LIMIT_BYTES"` + PrivateHostWhitelist FlexibleStringSlice `json:"private_host_whitelist,omitempty" env:"PICOCLAW_TOOLS_WEB_PRIVATE_HOST_WHITELIST"` } type CronToolsConfig struct { diff --git a/pkg/tools/web.go b/pkg/tools/web.go index e5036d3a8..9ed2140cc 100644 --- a/pkg/tools/web.go +++ b/pkg/tools/web.go @@ -777,11 +777,17 @@ type WebFetchTool struct { proxy string client *http.Client fetchLimitBytes int64 + whitelist *privateHostWhitelist +} + +type privateHostWhitelist struct { + exact map[string]struct{} + cidrs []*net.IPNet } func NewWebFetchTool(maxChars int, fetchLimitBytes int64) (*WebFetchTool, error) { // createHTTPClient cannot fail with an empty proxy string. - return NewWebFetchToolWithProxy(maxChars, "", fetchLimitBytes) + return NewWebFetchToolWithConfig(maxChars, "", fetchLimitBytes, nil) } // allowPrivateWebFetchHosts controls whether loopback/private hosts are allowed. @@ -789,9 +795,22 @@ func NewWebFetchTool(maxChars int, fetchLimitBytes int64) (*WebFetchTool, error) var allowPrivateWebFetchHosts atomic.Bool func NewWebFetchToolWithProxy(maxChars int, proxy string, fetchLimitBytes int64) (*WebFetchTool, error) { + return NewWebFetchToolWithConfig(maxChars, proxy, fetchLimitBytes, nil) +} + +func NewWebFetchToolWithConfig( + maxChars int, + proxy string, + fetchLimitBytes int64, + privateHostWhitelist []string, +) (*WebFetchTool, error) { if maxChars <= 0 { maxChars = defaultMaxChars } + whitelist, err := newPrivateHostWhitelist(privateHostWhitelist) + if err != nil { + return nil, fmt.Errorf("failed to parse web fetch private host whitelist: %w", err) + } client, err := utils.CreateHTTPClient(proxy, fetchTimeout) if err != nil { return nil, fmt.Errorf("failed to create HTTP client for web fetch: %w", err) @@ -801,13 +820,13 @@ func NewWebFetchToolWithProxy(maxChars int, proxy string, fetchLimitBytes int64) Timeout: 15 * time.Second, KeepAlive: 30 * time.Second, } - transport.DialContext = newSafeDialContext(dialer) + transport.DialContext = newSafeDialContext(dialer, whitelist) } client.CheckRedirect = func(req *http.Request, via []*http.Request) error { if len(via) >= maxRedirects { return fmt.Errorf("stopped after %d redirects", maxRedirects) } - if isObviousPrivateHost(req.URL.Hostname()) { + if isObviousPrivateHost(req.URL.Hostname(), whitelist) { return fmt.Errorf("redirect target is private or local network host") } return nil @@ -820,6 +839,7 @@ func NewWebFetchToolWithProxy(maxChars int, proxy string, fetchLimitBytes int64) proxy: proxy, client: client, fetchLimitBytes: fetchLimitBytes, + whitelist: whitelist, }, nil } @@ -871,7 +891,7 @@ func (t *WebFetchTool) Execute(ctx context.Context, args map[string]any) *ToolRe // Lightweight pre-flight: block obvious localhost/literal-IP without DNS resolution. // The real SSRF guard is newSafeDialContext at connect time. hostname := parsedURL.Hostname() - if isObviousPrivateHost(hostname) { + if isObviousPrivateHost(hostname, t.whitelist) { return ErrorResult("fetching private or local network hosts is not allowed") } @@ -981,7 +1001,10 @@ func (t *WebFetchTool) extractText(htmlContent string) string { // newSafeDialContext re-resolves DNS at connect time to mitigate DNS rebinding (TOCTOU) // where a hostname resolves to a public IP during pre-flight but a private IP at connect time. -func newSafeDialContext(dialer *net.Dialer) func(context.Context, string, string) (net.Conn, error) { +func newSafeDialContext( + dialer *net.Dialer, + whitelist *privateHostWhitelist, +) func(context.Context, string, string) (net.Conn, error) { return func(ctx context.Context, network, address string) (net.Conn, error) { if allowPrivateWebFetchHosts.Load() { return dialer.DialContext(ctx, network, address) @@ -996,7 +1019,7 @@ func newSafeDialContext(dialer *net.Dialer) func(context.Context, string, string } if ip := net.ParseIP(host); ip != nil { - if isPrivateOrRestrictedIP(ip) { + if shouldBlockPrivateIP(ip, whitelist) { return nil, fmt.Errorf("blocked private or local target: %s", host) } return dialer.DialContext(ctx, network, net.JoinHostPort(ip.String(), port)) @@ -1010,7 +1033,7 @@ func newSafeDialContext(dialer *net.Dialer) func(context.Context, string, string attempted := 0 var lastErr error for _, ipAddr := range ipAddrs { - if isPrivateOrRestrictedIP(ipAddr.IP) { + if shouldBlockPrivateIP(ipAddr.IP, whitelist) { continue } attempted++ @@ -1022,7 +1045,7 @@ func newSafeDialContext(dialer *net.Dialer) func(context.Context, string, string } if attempted == 0 { - return nil, fmt.Errorf("all resolved addresses for %s are private or restricted", host) + return nil, fmt.Errorf("all resolved addresses for %s are private, restricted, or not whitelisted", host) } if lastErr != nil { return nil, fmt.Errorf("failed connecting to public addresses for %s: %w", host, lastErr) @@ -1031,10 +1054,72 @@ func newSafeDialContext(dialer *net.Dialer) func(context.Context, string, string } } +func newPrivateHostWhitelist(entries []string) (*privateHostWhitelist, error) { + if len(entries) == 0 { + return nil, nil + } + + whitelist := &privateHostWhitelist{ + exact: make(map[string]struct{}), + cidrs: make([]*net.IPNet, 0, len(entries)), + } + for _, entry := range entries { + entry = strings.TrimSpace(entry) + if entry == "" { + continue + } + if ip := net.ParseIP(entry); ip != nil { + whitelist.exact[normalizeWhitelistIP(ip).String()] = struct{}{} + continue + } + _, network, err := net.ParseCIDR(entry) + if err != nil { + return nil, fmt.Errorf("invalid entry %q: expected IP or CIDR", entry) + } + whitelist.cidrs = append(whitelist.cidrs, network) + } + + if len(whitelist.exact) == 0 && len(whitelist.cidrs) == 0 { + return nil, nil + } + return whitelist, nil +} + +func (w *privateHostWhitelist) Contains(ip net.IP) bool { + if w == nil || ip == nil { + return false + } + + normalized := normalizeWhitelistIP(ip) + if _, ok := w.exact[normalized.String()]; ok { + return true + } + for _, network := range w.cidrs { + if network.Contains(normalized) { + return true + } + } + return false +} + +func normalizeWhitelistIP(ip net.IP) net.IP { + if ip == nil { + return nil + } + if ip4 := ip.To4(); ip4 != nil { + return ip4 + } + return ip +} + +func shouldBlockPrivateIP(ip net.IP, whitelist *privateHostWhitelist) bool { + return isPrivateOrRestrictedIP(ip) && !whitelist.Contains(ip) +} + // isObviousPrivateHost performs a lightweight, no-DNS check for obviously private hosts. // It catches localhost, literal private IPs, and empty hosts. It does NOT resolve DNS — // the real SSRF guard is newSafeDialContext which checks IPs at connect time. -func isObviousPrivateHost(host string) bool { +func isObviousPrivateHost(host string, whitelist *privateHostWhitelist) bool { if allowPrivateWebFetchHosts.Load() { return false } @@ -1050,7 +1135,7 @@ func isObviousPrivateHost(host string) bool { } if ip := net.ParseIP(h); ip != nil { - return isPrivateOrRestrictedIP(ip) + return shouldBlockPrivateIP(ip, whitelist) } return false diff --git a/pkg/tools/web_test.go b/pkg/tools/web_test.go index 41d83e6f5..80c9a2067 100644 --- a/pkg/tools/web_test.go +++ b/pkg/tools/web_test.go @@ -10,6 +10,7 @@ import ( "net/http/httptest" "strings" "testing" + "time" "github.com/sipeed/picoclaw/pkg/logger" ) @@ -423,6 +424,29 @@ func withPrivateWebFetchHostsAllowed(t *testing.T) { }) } +func serverHostAndPort(t *testing.T, rawURL string) (string, string) { + t.Helper() + hostPort := strings.TrimPrefix(rawURL, "http://") + hostPort = strings.TrimPrefix(hostPort, "https://") + host, port, err := net.SplitHostPort(hostPort) + if err != nil { + t.Fatalf("failed to split host/port from %q: %v", rawURL, err) + } + return host, port +} + +func singleHostCIDR(t *testing.T, host string) string { + t.Helper() + ip := net.ParseIP(host) + if ip == nil { + t.Fatalf("failed to parse IP %q", host) + } + if ip.To4() != nil { + return ip.String() + "/32" + } + return ip.String() + "/128" +} + func TestWebTool_WebFetch_PrivateHostBlocked(t *testing.T) { tool, err := NewWebFetchTool(50000, testFetchLimit) if err != nil { @@ -441,6 +465,56 @@ func TestWebTool_WebFetch_PrivateHostBlocked(t *testing.T) { } } +func TestWebTool_WebFetch_PrivateHostAllowedByExactWhitelist(t *testing.T) { + server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + w.Header().Set("Content-Type", "text/plain") + w.WriteHeader(http.StatusOK) + w.Write([]byte("exact whitelist ok")) + })) + defer server.Close() + + host, _ := serverHostAndPort(t, server.URL) + tool, err := NewWebFetchToolWithConfig(50000, "", testFetchLimit, []string{host}) + if err != nil { + t.Fatalf("Failed to create web fetch tool: %v", err) + } + + result := tool.Execute(context.Background(), map[string]any{ + "url": server.URL, + }) + if result.IsError { + t.Fatalf("expected success for exact whitelisted private IP, got %q", result.ForLLM) + } + if !strings.Contains(result.ForLLM, "exact whitelist ok") { + t.Fatalf("expected fetched content, got %q", result.ForLLM) + } +} + +func TestWebTool_WebFetch_PrivateHostAllowedByCIDRWhitelist(t *testing.T) { + server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + w.Header().Set("Content-Type", "text/plain") + w.WriteHeader(http.StatusOK) + w.Write([]byte("cidr whitelist ok")) + })) + defer server.Close() + + host, _ := serverHostAndPort(t, server.URL) + tool, err := NewWebFetchToolWithConfig(50000, "", testFetchLimit, []string{singleHostCIDR(t, host)}) + if err != nil { + t.Fatalf("Failed to create web fetch tool: %v", err) + } + + result := tool.Execute(context.Background(), map[string]any{ + "url": server.URL, + }) + if result.IsError { + t.Fatalf("expected success for CIDR-whitelisted private IP, got %q", result.ForLLM) + } + if !strings.Contains(result.ForLLM, "cidr whitelist ok") { + t.Fatalf("expected fetched content, got %q", result.ForLLM) + } +} + func TestWebTool_WebFetch_PrivateHostAllowedForTests(t *testing.T) { withPrivateWebFetchHostsAllowed(t) @@ -570,6 +644,69 @@ func TestWebFetch_RedirectToPrivateBlocked(t *testing.T) { } } +func TestNewSafeDialContext_BlocksPrivateDNSResolutionWithoutWhitelist(t *testing.T) { + listener, err := net.Listen("tcp", "127.0.0.1:0") + if err != nil { + t.Fatalf("failed to listen on loopback: %v", err) + } + defer listener.Close() + + _, port, err := net.SplitHostPort(listener.Addr().String()) + if err != nil { + t.Fatalf("failed to split listener address: %v", err) + } + + dialContext := newSafeDialContext(&net.Dialer{Timeout: time.Second}, nil) + _, err = dialContext(context.Background(), "tcp", net.JoinHostPort("localhost", port)) + if err == nil { + t.Fatal("expected localhost DNS resolution to be blocked without whitelist") + } + if !strings.Contains(err.Error(), "private") && !strings.Contains(err.Error(), "whitelisted") { + t.Fatalf("unexpected error: %v", err) + } +} + +func TestNewSafeDialContext_AllowsWhitelistedPrivateDNSResolution(t *testing.T) { + listener, err := net.Listen("tcp", "127.0.0.1:0") + if err != nil { + t.Fatalf("failed to listen on loopback: %v", err) + } + defer listener.Close() + + accepted := make(chan struct{}, 1) + go func() { + conn, acceptErr := listener.Accept() + if acceptErr != nil { + return + } + conn.Close() + accepted <- struct{}{} + }() + + _, port, err := net.SplitHostPort(listener.Addr().String()) + if err != nil { + t.Fatalf("failed to split listener address: %v", err) + } + + whitelist, err := newPrivateHostWhitelist([]string{"127.0.0.0/8"}) + if err != nil { + t.Fatalf("failed to parse whitelist: %v", err) + } + + dialContext := newSafeDialContext(&net.Dialer{Timeout: time.Second}, whitelist) + conn, err := dialContext(context.Background(), "tcp", net.JoinHostPort("localhost", port)) + if err != nil { + t.Fatalf("expected localhost DNS resolution to succeed with whitelist, got %v", err) + } + conn.Close() + + select { + case <-accepted: + case <-time.After(time.Second): + t.Fatal("expected localhost listener to accept a connection") + } +} + // TestIsPrivateOrRestrictedIP_Table tests IP classification logic func TestIsPrivateOrRestrictedIP_Table(t *testing.T) { tests := []struct { @@ -660,6 +797,16 @@ func TestNewWebFetchToolWithProxy(t *testing.T) { } } +func TestNewWebFetchToolWithConfig_InvalidPrivateHostWhitelist(t *testing.T) { + _, err := NewWebFetchToolWithConfig(1024, "", testFetchLimit, []string{"not-an-ip-or-cidr"}) + if err == nil { + t.Fatal("expected invalid whitelist entry to fail") + } + if !strings.Contains(err.Error(), "invalid entry") { + t.Fatalf("unexpected error: %v", err) + } +} + func TestNewWebSearchTool_PropagatesProxy(t *testing.T) { t.Run("perplexity", func(t *testing.T) { tool, err := NewWebSearchTool(WebSearchToolOptions{ From c639e2c21677aaff50796d2b68af3183d6d61fb5 Mon Sep 17 00:00:00 2001 From: Alix-007 <llagy007@gmail.com> Date: Tue, 17 Mar 2026 23:31:56 +0800 Subject: [PATCH 54/56] feat(agent): include current sender in dynamic context (#1696) * feat(agent): include current sender in dynamic context * test(agent): keep current-sender regression ASCII-only --------- Co-authored-by: Alix-007 <267018309+Alix-007@users.noreply.github.com> --- pkg/agent/context.go | 25 +++++++++-- pkg/agent/context_cache_test.go | 68 ++++++++++++++++++++++++++++-- pkg/agent/loop.go | 42 ++++++++++-------- pkg/agent/loop_test.go | 75 +++++++++++++++++++++++++++++++++ 4 files changed, 186 insertions(+), 24 deletions(-) diff --git a/pkg/agent/context.go b/pkg/agent/context.go index 5a84c45e2..830edf875 100644 --- a/pkg/agent/context.go +++ b/pkg/agent/context.go @@ -458,7 +458,23 @@ func (cb *ContextBuilder) LoadBootstrapFiles() string { // // See: https://docs.anthropic.com/en/docs/build-with-claude/prompt-caching // See: https://platform.openai.com/docs/guides/prompt-caching -func (cb *ContextBuilder) buildDynamicContext(channel, chatID string) string { +func formatCurrentSenderLine(senderID, senderDisplayName string) string { + senderID = strings.TrimSpace(senderID) + senderDisplayName = strings.TrimSpace(senderDisplayName) + + switch { + case senderDisplayName != "" && senderID != "": + return fmt.Sprintf("Current sender: %s (ID: %s)", senderDisplayName, senderID) + case senderDisplayName != "": + return fmt.Sprintf("Current sender: %s", senderDisplayName) + case senderID != "": + return fmt.Sprintf("Current sender: %s", senderID) + default: + return "" + } +} + +func (cb *ContextBuilder) buildDynamicContext(channel, chatID, senderID, senderDisplayName string) string { now := time.Now().Format("2006-01-02 15:04 (Monday)") rt := fmt.Sprintf("%s %s, Go %s", runtime.GOOS, runtime.GOARCH, runtime.Version()) @@ -468,6 +484,9 @@ func (cb *ContextBuilder) buildDynamicContext(channel, chatID string) string { if channel != "" && chatID != "" { fmt.Fprintf(&sb, "\n\n## Current Session\nChannel: %s\nChat ID: %s", channel, chatID) } + if senderLine := formatCurrentSenderLine(senderID, senderDisplayName); senderLine != "" { + fmt.Fprintf(&sb, "\n\n## Current Sender\n%s", senderLine) + } return sb.String() } @@ -477,7 +496,7 @@ func (cb *ContextBuilder) BuildMessages( summary string, currentMessage string, media []string, - channel, chatID string, + channel, chatID, senderID, senderDisplayName string, ) []providers.Message { messages := []providers.Message{} @@ -493,7 +512,7 @@ func (cb *ContextBuilder) BuildMessages( staticPrompt := cb.BuildSystemPromptWithCache() // Build short dynamic context (time, runtime, session) — changes per request - dynamicCtx := cb.buildDynamicContext(channel, chatID) + dynamicCtx := cb.buildDynamicContext(channel, chatID, senderID, senderDisplayName) // Compose a single system message: static (cached) + dynamic + optional summary. // Keeping all system content in one message ensures every provider adapter can diff --git a/pkg/agent/context_cache_test.go b/pkg/agent/context_cache_test.go index 707510820..c26976c3c 100644 --- a/pkg/agent/context_cache_test.go +++ b/pkg/agent/context_cache_test.go @@ -82,7 +82,7 @@ func TestSingleSystemMessage(t *testing.T) { for _, tt := range tests { t.Run(tt.name, func(t *testing.T) { - msgs := cb.BuildMessages(tt.history, tt.summary, tt.message, nil, "test", "chat1") + msgs := cb.BuildMessages(tt.history, tt.summary, tt.message, nil, "test", "chat1", "", "") systemCount := 0 for _, m := range msgs { @@ -126,6 +126,68 @@ func TestSingleSystemMessage(t *testing.T) { } } +func TestBuildMessages_CurrentSenderDynamicContext(t *testing.T) { + tmpDir := setupWorkspace(t, map[string]string{ + "IDENTITY.md": "# Identity\nTest agent.", + }) + defer os.RemoveAll(tmpDir) + + cb := NewContextBuilder(tmpDir) + + tests := []struct { + name string + senderID string + senderDisplayName string + wantLine string + wantSection bool + }{ + { + name: "both id and display name", + senderID: "feishu:ou_xxx", + senderDisplayName: "Zhang San", + wantLine: "Current sender: Zhang San (ID: feishu:ou_xxx)", + wantSection: true, + }, + { + name: "display name only", + senderDisplayName: "Alice", + wantLine: "Current sender: Alice", + wantSection: true, + }, + { + name: "id only", + senderID: "discord:123", + wantLine: "Current sender: discord:123", + wantSection: true, + }, + { + name: "no sender info", + wantSection: false, + }, + } + + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + msgs := cb.BuildMessages(nil, "", "hello", nil, "discord", "chat1", tt.senderID, tt.senderDisplayName) + sys := msgs[0].Content + + if tt.wantSection { + if !strings.Contains(sys, "## Current Sender") { + t.Fatalf("system prompt missing Current Sender section:\n%s", sys) + } + if !strings.Contains(sys, tt.wantLine) { + t.Fatalf("system prompt missing sender line %q:\n%s", tt.wantLine, sys) + } + return + } + + if strings.Contains(sys, "## Current Sender") { + t.Fatalf("system prompt should omit Current Sender section:\n%s", sys) + } + }) + } +} + // TestMtimeAutoInvalidation verifies that the cache detects source file changes // via mtime without requiring explicit InvalidateCache(). // Fix: original implementation had no auto-invalidation — edits to bootstrap files, @@ -576,7 +638,7 @@ func TestConcurrentBuildSystemPromptWithCache(t *testing.T) { } // Also exercise BuildMessages concurrently - msgs := cb.BuildMessages(nil, "", "hello", nil, "test", "chat") + msgs := cb.BuildMessages(nil, "", "hello", nil, "test", "chat", "", "") if len(msgs) < 2 { errs <- "BuildMessages returned fewer than 2 messages" return @@ -664,6 +726,6 @@ func BenchmarkBuildMessagesWithCache(b *testing.B) { b.ResetTimer() for i := 0; i < b.N; i++ { - _ = cb.BuildMessages(history, "summary", "new message", nil, "cli", "test") + _ = cb.BuildMessages(history, "summary", "new message", nil, "cli", "test", "", "") } } diff --git a/pkg/agent/loop.go b/pkg/agent/loop.go index c25650201..00c9d913a 100644 --- a/pkg/agent/loop.go +++ b/pkg/agent/loop.go @@ -55,15 +55,17 @@ type AgentLoop struct { // processOptions configures how a message is processed type processOptions struct { - SessionKey string // Session identifier for history/context - Channel string // Target channel for tool execution - ChatID string // Target chat ID for tool execution - UserMessage string // User message content (may include prefix) - Media []string // media:// refs from inbound message - DefaultResponse string // Response when LLM returns empty - EnableSummary bool // Whether to trigger summarization - SendResponse bool // Whether to send response via bus - NoHistory bool // If true, don't load session history (for heartbeat) + SessionKey string // Session identifier for history/context + Channel string // Target channel for tool execution + ChatID string // Target chat ID for tool execution + SenderID string // Current sender ID for dynamic context + SenderDisplayName string // Current sender display name for dynamic context + UserMessage string // User message content (may include prefix) + Media []string // media:// refs from inbound message + DefaultResponse string // Response when LLM returns empty + EnableSummary bool // Whether to trigger summarization + SendResponse bool // Whether to send response via bus + NoHistory bool // If true, don't load session history (for heartbeat) } const ( @@ -746,14 +748,16 @@ func (al *AgentLoop) processMessage(ctx context.Context, msg bus.InboundMessage) }) opts := processOptions{ - SessionKey: sessionKey, - Channel: msg.Channel, - ChatID: msg.ChatID, - UserMessage: msg.Content, - Media: msg.Media, - DefaultResponse: defaultResponse, - EnableSummary: true, - SendResponse: false, + SessionKey: sessionKey, + Channel: msg.Channel, + ChatID: msg.ChatID, + SenderID: msg.SenderID, + SenderDisplayName: msg.Sender.DisplayName, + UserMessage: msg.Content, + Media: msg.Media, + DefaultResponse: defaultResponse, + EnableSummary: true, + SendResponse: false, } // context-dependent commands check their own Runtime fields and report @@ -893,6 +897,8 @@ func (al *AgentLoop) runAgentLoop( opts.Media, opts.Channel, opts.ChatID, + opts.SenderID, + opts.SenderDisplayName, ) // Resolve media:// refs: images→base64 data URLs, non-images→local paths in content @@ -1164,7 +1170,7 @@ func (al *AgentLoop) runLLMIteration( newSummary := agent.Sessions.GetSummary(opts.SessionKey) messages = agent.ContextBuilder.BuildMessages( newHistory, newSummary, "", - nil, opts.Channel, opts.ChatID, + nil, opts.Channel, opts.ChatID, opts.SenderID, opts.SenderDisplayName, ) continue } diff --git a/pkg/agent/loop_test.go b/pkg/agent/loop_test.go index a6604e87f..47c378771 100644 --- a/pkg/agent/loop_test.go +++ b/pkg/agent/loop_test.go @@ -30,6 +30,28 @@ func (f *fakeChannel) IsAllowed(string) bool { func (f *fakeChannel) IsAllowedSender(sender bus.SenderInfo) bool { return true } func (f *fakeChannel) ReasoningChannelID() string { return f.id } +type recordingProvider struct { + lastMessages []providers.Message +} + +func (r *recordingProvider) Chat( + ctx context.Context, + messages []providers.Message, + tools []providers.ToolDefinition, + model string, + opts map[string]any, +) (*providers.LLMResponse, error) { + r.lastMessages = append([]providers.Message(nil), messages...) + return &providers.LLMResponse{ + Content: "Mock response", + ToolCalls: []providers.ToolCall{}, + }, nil +} + +func (r *recordingProvider) GetDefaultModel() string { + return "mock-model" +} + func newTestAgentLoop( t *testing.T, ) (al *AgentLoop, cfg *config.Config, msgBus *bus.MessageBus, provider *mockProvider, cleanup func()) { @@ -54,6 +76,59 @@ func newTestAgentLoop( return al, cfg, msgBus, provider, func() { os.RemoveAll(tmpDir) } } +func TestProcessMessage_IncludesCurrentSenderInDynamicContext(t *testing.T) { + tmpDir, err := os.MkdirTemp("", "agent-test-*") + if err != nil { + t.Fatalf("Failed to create temp dir: %v", err) + } + defer os.RemoveAll(tmpDir) + + cfg := &config.Config{ + Agents: config.AgentsConfig{ + Defaults: config.AgentDefaults{ + Workspace: tmpDir, + Model: "test-model", + MaxTokens: 4096, + MaxToolIterations: 10, + }, + }, + } + + msgBus := bus.NewMessageBus() + provider := &recordingProvider{} + al := NewAgentLoop(cfg, msgBus, provider) + + response, err := al.processMessage(context.Background(), bus.InboundMessage{ + Channel: "discord", + SenderID: "discord:123", + Sender: bus.SenderInfo{ + DisplayName: "Alice", + }, + ChatID: "group-1", + Content: "hello", + }) + if err != nil { + t.Fatalf("processMessage() error = %v", err) + } + if response != "Mock response" { + t.Fatalf("processMessage() response = %q, want %q", response, "Mock response") + } + if len(provider.lastMessages) == 0 { + t.Fatal("provider did not receive any messages") + } + + systemPrompt := provider.lastMessages[0].Content + wantSender := "## Current Sender\nCurrent sender: Alice (ID: discord:123)" + if !strings.Contains(systemPrompt, wantSender) { + t.Fatalf("system prompt missing sender context %q:\n%s", wantSender, systemPrompt) + } + + lastMessage := provider.lastMessages[len(provider.lastMessages)-1] + if lastMessage.Role != "user" || lastMessage.Content != "hello" { + t.Fatalf("last provider message = %+v, want unchanged user message", lastMessage) + } +} + func TestRecordLastChannel(t *testing.T) { al, cfg, msgBus, provider, cleanup := newTestAgentLoop(t) defer cleanup() From f776611e291b71785132ffba9fb34556eaff6a96 Mon Sep 17 00:00:00 2001 From: juju <14191774+tong3jie@users.noreply.github.com> Date: Wed, 18 Mar 2026 00:02:51 +0800 Subject: [PATCH 55/56] feat(cron): refactor scheduler to event-driven model and add unit tests (#1313) * feat(cron): enhance CronService with wake channel and improve job scheduling logic * fix(cron): update file permission mode to use octal notation in test and fix some lint errors * fix(cron): improve wake channel handling and enhance concurrency in tests --- pkg/cron/service.go | 77 ++++++++++++--- pkg/cron/service_test.go | 199 +++++++++++++++++++++++++++++++++++++++ 2 files changed, 265 insertions(+), 11 deletions(-) diff --git a/pkg/cron/service.go b/pkg/cron/service.go index 04775ac42..77a413133 100644 --- a/pkg/cron/service.go +++ b/pkg/cron/service.go @@ -65,6 +65,7 @@ type CronService struct { mu sync.RWMutex running bool stopChan chan struct{} + wakeChan chan struct{} gronx *gronx.Gronx } @@ -73,6 +74,7 @@ func NewCronService(storePath string, onJob JobHandler) *CronService { storePath: storePath, onJob: onJob, gronx: gronx.New(), + wakeChan: make(chan struct{}), } // Initialize and load store on creation cs.loadStore() @@ -97,6 +99,9 @@ func (cs *CronService) Start() error { } cs.stopChan = make(chan struct{}) + if cs.wakeChan == nil { + cs.wakeChan = make(chan struct{}) + } cs.running = true go cs.runLoop(cs.stopChan) @@ -119,14 +124,47 @@ func (cs *CronService) Stop() { } func (cs *CronService) runLoop(stopChan chan struct{}) { - ticker := time.NewTicker(1 * time.Second) - defer ticker.Stop() + timer := time.NewTimer(time.Hour) + if !timer.Stop() { + <-timer.C + } + defer timer.Stop() for { + // every loop, recalculate the next wake time + cs.mu.RLock() + nextWake := cs.getNextWakeMS() + cs.mu.RUnlock() + + var delay time.Duration + now := time.Now().UnixMilli() + + if nextWake == nil { + // no jobs, sleep for a long time (or until a new job is added) + delay = time.Hour + } else { + diff := *nextWake - now + if diff <= 0 { + delay = 0 + } else { + delay = time.Duration(diff) * time.Millisecond + } + } + + timer.Reset(delay) + select { case <-stopChan: return - case <-ticker.C: + case <-cs.wakeChan: // wake on new job or update + if !timer.Stop() { + select { + case <-timer.C: + default: + } + } + continue + case <-timer.C: cs.checkJobs() } } @@ -264,22 +302,19 @@ func (cs *CronService) executeJobByID(jobID string) { } func (cs *CronService) computeNextRun(schedule *CronSchedule, nowMS int64) *int64 { - if schedule.Kind == "at" { + switch schedule.Kind { + case "at": if schedule.AtMS != nil && *schedule.AtMS > nowMS { return schedule.AtMS } return nil - } - - if schedule.Kind == "every" { + case "every": if schedule.EveryMS == nil || *schedule.EveryMS <= 0 { return nil } next := nowMS + *schedule.EveryMS return &next - } - - if schedule.Kind == "cron" { + case "cron": if schedule.Expr == "" { return nil } @@ -294,9 +329,19 @@ func (cs *CronService) computeNextRun(schedule *CronSchedule, nowMS int64) *int6 nextMS := nextTime.UnixMilli() return &nextMS + default: + log.Printf("[cron] unknown schedule kind '%s'", schedule.Kind) + return nil } +} - return nil +// wake up the loop to re-evaluate next wake time immediately (e.g. after add/update/remove jobs) +func (cs *CronService) notify() { + select { + case cs.wakeChan <- struct{}{}: + default: + // if the channel is full, it means the loop will wake up soon anyway, so we can skip sending + } } func (cs *CronService) recomputeNextRuns() { @@ -400,6 +445,8 @@ func (cs *CronService) AddJob( return nil, err } + cs.notify() + return &job, nil } @@ -411,6 +458,9 @@ func (cs *CronService) UpdateJob(job *CronJob) error { if cs.store.Jobs[i].ID == job.ID { cs.store.Jobs[i] = *job cs.store.Jobs[i].UpdatedAtMS = time.Now().UnixMilli() + + cs.notify() + return cs.saveStoreUnsafe() } } @@ -441,6 +491,8 @@ func (cs *CronService) removeJobUnsafe(jobID string) bool { } } + cs.notify() + return removed } @@ -463,6 +515,9 @@ func (cs *CronService) EnableJob(jobID string, enabled bool) *CronJob { if err := cs.saveStoreUnsafe(); err != nil { log.Printf("[cron] failed to save store after enable: %v", err) } + + cs.notify() + return job } } diff --git a/pkg/cron/service_test.go b/pkg/cron/service_test.go index 1a0dd1829..c55e62174 100644 --- a/pkg/cron/service_test.go +++ b/pkg/cron/service_test.go @@ -1,10 +1,13 @@ package cron import ( + "fmt" "os" "path/filepath" "runtime" + "sync" "testing" + "time" ) func TestSaveStore_FilePermissions(t *testing.T) { @@ -36,3 +39,199 @@ func TestSaveStore_FilePermissions(t *testing.T) { func int64Ptr(v int64) *int64 { return &v } + +func setupService(handler JobHandler) (*CronService, string) { + tmpFile := fmt.Sprintf("test_cron_%d.json", time.Now().UnixNano()) + cs := NewCronService(tmpFile, handler) + return cs, tmpFile +} + +func TestCronService_CRUD(t *testing.T) { + cs, path := setupService(nil) + defer os.Remove(path) + + // Test AddJob + at := time.Now().Add(time.Hour).UnixMilli() + job, err := cs.AddJob("Task1", CronSchedule{Kind: "at", AtMS: &at}, "msg", true, "ch", "to") + if err != nil || job.ID == "" { + t.Fatalf("AddJob failed: %v", err) + } + + // Test ListJobs + if len(cs.ListJobs(true)) != 1 { + t.Error("ListJobs should return 1 job") + } + + // Test UpdateJob + job.Name = "UpdatedName" + err = cs.UpdateJob(job) + if err != nil || cs.store.Jobs[0].Name != "UpdatedName" { + t.Error("UpdateJob failed") + } + + // Test EnableJob + cs.EnableJob(job.ID, false) + if cs.store.Jobs[0].Enabled != false || cs.store.Jobs[0].State.NextRunAtMS != nil { + t.Error("EnableJob(false) failed to clear state") + } + + // Test RemoveJob + removed := cs.RemoveJob(job.ID) + if !removed || len(cs.store.Jobs) != 0 { + t.Error("RemoveJob failed") + } +} + +// 2. Test Cron Expression Calculation Logic +func TestCronService_ComputeNextRun(t *testing.T) { + cs, path := setupService(nil) + defer os.Remove(path) + + now := time.Date(2024, 1, 1, 12, 0, 0, 0, time.UTC).UnixMilli() + + tests := []struct { + name string + schedule CronSchedule + wantNil bool + }{ + {"Valid Cron", CronSchedule{Kind: "cron", Expr: "0 * * * *"}, false}, + {"Invalid Cron", CronSchedule{Kind: "cron", Expr: "invalid"}, true}, + {"Every MS", CronSchedule{Kind: "every", EveryMS: int64Ptr(5000)}, false}, + {"At Future", CronSchedule{Kind: "at", AtMS: int64Ptr(now + 1000)}, false}, + {"At Past", CronSchedule{Kind: "at", AtMS: int64Ptr(now - 1000)}, true}, + } + + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + got := cs.computeNextRun(&tt.schedule, now) + if (got == nil) != tt.wantNil { + t.Errorf("%s: got %v, wantNil %v", tt.name, got, tt.wantNil) + } + }) + } +} + +// 3. Test Execution Flow +func TestCronService_ExecutionFlow(t *testing.T) { + var mu sync.Mutex + executedJobs := make(map[string]bool) + + handler := func(job *CronJob) (string, error) { + mu.Lock() + executedJobs[job.ID] = true + mu.Unlock() + return "ok", nil + } + + cs, path := setupService(handler) + defer os.Remove(path) + + // Start the service + if err := cs.Start(); err != nil { + t.Fatalf("Start failed: %v", err) + } + defer cs.Stop() + + // Add a job then runs 100ms from now + target := time.Now().Add(100 * time.Millisecond).UnixMilli() + job, _ := cs.AddJob("FastJob", CronSchedule{Kind: "at", AtMS: &target}, "", false, "", "") + + // Check for job execution with a timeout + success := false + for range 20 { + mu.Lock() + if executedJobs[job.ID] { + success = true + mu.Unlock() + break + } + mu.Unlock() + time.Sleep(100 * time.Millisecond) + } + + if !success { + t.Error("Job was not executed in time") + } + + // check that the job is removed after execution (DeleteAfterRun = true) + status := cs.Status() + if status["jobs"].(int) != 0 { + t.Errorf("Job should be deleted after run, got count: %v", status["jobs"]) + } +} + +func TestCronService_PersistenceIntegrity(t *testing.T) { + tmpFile := "persist_test.json" + defer os.Remove(tmpFile) + + // write a job and persist + cs1 := NewCronService(tmpFile, nil) + at := int64(2000000000000) + cs1.AddJob("PersistMe", CronSchedule{Kind: "at", AtMS: &at}, "payload", true, "ch1", "") + + // check file exists + if _, err := os.Stat(tmpFile); os.IsNotExist(err) { + t.Fatal("Store file was not created") + } + + // reload and check data integrity + cs2 := NewCronService(tmpFile, nil) + if err := cs2.Load(); err != nil { + t.Fatalf("Failed to load store: %v", err) + } + + jobs := cs2.ListJobs(true) + if len(jobs) != 1 || jobs[0].Name != "PersistMe" { + t.Errorf("Data corruption after reload. Got: %+v", jobs) + } + + // test loading invalid JSON + os.WriteFile(tmpFile, []byte("{invalid json}"), 0o644) + cs3 := NewCronService(tmpFile, nil) + err := cs3.loadStore() + if err == nil { + t.Error("Should return error when loading invalid JSON") + } +} + +func TestCronService_ConcurrentAccess(t *testing.T) { + cs, path := setupService(nil) + defer os.Remove(path) + + cs.Start() + defer cs.Stop() + + var wg sync.WaitGroup + workers := 10 + iterations := 50 + + wg.Add(workers * 2) + + // add jobs concurrently + for i := range workers { + go func(id int) { + defer wg.Done() + for j := range iterations { + at := time.Now().Add(time.Hour).UnixMilli() + cs.AddJob(fmt.Sprintf("Job-%d-%d", id, j), CronSchedule{Kind: "at", AtMS: &at}, "", false, "", "") + time.Sleep(100 * time.Microsecond) + } + }(i) + } + + // read and update jobs concurrently + for range workers { + go func() { + defer wg.Done() + for j := range iterations { + jobs := cs.ListJobs(true) + if len(jobs) > 0 { + cs.EnableJob(jobs[0].ID, j%2 == 0) + } + time.Sleep(100 * time.Microsecond) + } + }() + } + + wg.Wait() +} From 9c31b0ca958e94cdf081cd30ee61be1806c51013 Mon Sep 17 00:00:00 2001 From: juju <14191774+tong3jie@users.noreply.github.com> Date: Wed, 18 Mar 2026 00:12:12 +0800 Subject: [PATCH 56/56] fix: Fixed the bug where the bus was closed and consumers had unfinished messages. (#1179) * fix: Fixed the bug where the bus was closed and consumers had unfinished messages. * fix: remove unnecessary blank line in Close method * fix: refactor message bus and channel handling for improved performance and reliability * fix: improve message handling and bus closure logic for better reliability * fix: reduce sleep duration in agent loop for improved responsiveness * fix the test case --- pkg/agent/loop.go | 108 ++++++------- pkg/agent/loop_test.go | 111 ++++++++----- pkg/bus/bus.go | 153 +++++++----------- pkg/bus/bus_test.go | 52 ++++-- pkg/channels/manager.go | 60 +++---- pkg/channels/qq/qq_test.go | 20 ++- .../telegram/telegram_dispatch_test.go | 6 +- .../telegram_group_command_filter_test.go | 28 ++-- pkg/channels/telegram/telegram_test.go | 16 +- .../whatsapp/whatsapp_command_test.go | 6 +- .../whatsapp_native/whatsapp_command_test.go | 23 +-- 11 files changed, 301 insertions(+), 282 deletions(-) diff --git a/pkg/agent/loop.go b/pkg/agent/loop.go index 00c9d913a..5c6cb2fe9 100644 --- a/pkg/agent/loop.go +++ b/pkg/agent/loop.go @@ -267,67 +267,65 @@ func (al *AgentLoop) Run(ctx context.Context) error { select { case <-ctx.Done(): return nil - default: - msg, ok := al.bus.ConsumeInbound(ctx) + case msg, ok := <-al.bus.InboundChan(): if !ok { - continue + return nil + } + // Process message + // TODO: Re-enable media cleanup after inbound media is properly consumed by the agent. + // Currently disabled because files are deleted before the LLM can access their content. + // defer func() { + // if al.mediaStore != nil && msg.MediaScope != "" { + // if releaseErr := al.mediaStore.ReleaseAll(msg.MediaScope); releaseErr != nil { + // logger.WarnCF("agent", "Failed to release media", map[string]any{ + // "scope": msg.MediaScope, + // "error": releaseErr.Error(), + // }) + // } + // } + // }() + + response, err := al.processMessage(ctx, msg) + if err != nil { + response = fmt.Sprintf("Error processing message: %v", err) } - // Process message - func() { - // TODO: Re-enable media cleanup after inbound media is properly consumed by the agent. - // Currently disabled because files are deleted before the LLM can access their content. - // defer func() { - // if al.mediaStore != nil && msg.MediaScope != "" { - // if releaseErr := al.mediaStore.ReleaseAll(msg.MediaScope); releaseErr != nil { - // logger.WarnCF("agent", "Failed to release media", map[string]any{ - // "scope": msg.MediaScope, - // "error": releaseErr.Error(), - // }) - // } - // } - // }() - - response, err := al.processMessage(ctx, msg) - if err != nil { - response = fmt.Sprintf("Error processing message: %v", err) - } - - if response != "" { - // Check if the message tool already sent a response during this round. - // If so, skip publishing to avoid duplicate messages to the user. - // Use default agent's tools to check (message tool is shared). - alreadySent := false - defaultAgent := al.GetRegistry().GetDefaultAgent() - if defaultAgent != nil { - if tool, ok := defaultAgent.Tools.Get("message"); ok { - if mt, ok := tool.(*tools.MessageTool); ok { - alreadySent = mt.HasSentInRound() - } + if response != "" { + // Check if the message tool already sent a response during this round. + // If so, skip publishing to avoid duplicate messages to the user. + // Use default agent's tools to check (message tool is shared). + alreadySent := false + defaultAgent := al.GetRegistry().GetDefaultAgent() + if defaultAgent != nil { + if tool, ok := defaultAgent.Tools.Get("message"); ok { + if mt, ok := tool.(*tools.MessageTool); ok { + alreadySent = mt.HasSentInRound() } } - - if !alreadySent { - al.bus.PublishOutbound(ctx, bus.OutboundMessage{ - Channel: msg.Channel, - ChatID: msg.ChatID, - Content: response, - }) - logger.InfoCF("agent", "Published outbound response", - map[string]any{ - "channel": msg.Channel, - "chat_id": msg.ChatID, - "content_len": len(response), - }) - } else { - logger.DebugCF( - "agent", - "Skipped outbound (message tool already sent)", - map[string]any{"channel": msg.Channel}, - ) - } } - }() + + if !alreadySent { + al.bus.PublishOutbound(ctx, bus.OutboundMessage{ + Channel: msg.Channel, + ChatID: msg.ChatID, + Content: response, + }) + logger.InfoCF("agent", "Published outbound response", + map[string]any{ + "channel": msg.Channel, + "chat_id": msg.ChatID, + "content_len": len(response), + }) + } else { + logger.DebugCF( + "agent", + "Skipped outbound (message tool already sent)", + map[string]any{"channel": msg.Channel}, + ) + } + } + default: + time.Sleep(time.Microsecond * 200) } } diff --git a/pkg/agent/loop_test.go b/pkg/agent/loop_test.go index 47c378771..25ee6ab4d 100644 --- a/pkg/agent/loop_test.go +++ b/pkg/agent/loop_test.go @@ -997,10 +997,25 @@ func TestHandleReasoning(t *testing.T) { al, msgBus := newLoop(t) al.handleReasoning(context.Background(), "reasoning", "telegram", "") - ctx, cancel := context.WithTimeout(context.Background(), 20*time.Millisecond) + ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second) defer cancel() - if msg, ok := msgBus.SubscribeOutbound(ctx); ok { - t.Fatalf("expected no outbound message, got %+v", msg) + for { + select { + case msg, ok := <-msgBus.OutboundChan(): + if !ok { + t.Fatalf("expected no outbound message, got %+v", msg) + } + if msg.Content == "reasoning" { + t.Fatalf("expected no message for empty chatID, got %+v", msg) + } + return + case <-ctx.Done(): + t.Log("expected an outbound message, got none within timeout") + return + default: + // Continue to check for message + time.Sleep(5 * time.Millisecond) // Avoid busy loop + } } }) @@ -1008,9 +1023,7 @@ func TestHandleReasoning(t *testing.T) { al, msgBus := newLoop(t) al.handleReasoning(context.Background(), "hello reasoning", "slack", "channel-1") - ctx, cancel := context.WithTimeout(context.Background(), 200*time.Millisecond) - defer cancel() - msg, ok := msgBus.SubscribeOutbound(ctx) + msg, ok := <-msgBus.OutboundChan() if !ok { t.Fatal("expected an outbound message") } @@ -1024,35 +1037,52 @@ func TestHandleReasoning(t *testing.T) { reasoning := "hello telegram reasoning" al.handleReasoning(context.Background(), reasoning, "telegram", "tg-chat") - ctx, cancel := context.WithTimeout(context.Background(), 200*time.Millisecond) + ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second) defer cancel() - msg, ok := msgBus.SubscribeOutbound(ctx) - if !ok { - t.Fatal("expected outbound message") - } + for { + select { + case <-ctx.Done(): + t.Fatal("expected an outbound message, got none within timeout") + return + case msg, ok := <-msgBus.OutboundChan(): + if !ok { + t.Fatal("expected outbound message") + } - if msg.Channel != "telegram" { - t.Fatalf("expected telegram channel message, got %+v", msg) - } - if msg.ChatID != "tg-chat" { - t.Fatalf("expected chatID tg-chat, got %+v", msg) - } - if msg.Content != reasoning { - t.Fatalf("content mismatch: got %q want %q", msg.Content, reasoning) + if msg.Channel != "telegram" { + t.Fatalf("expected telegram channel message, got %+v", msg) + } + if msg.ChatID != "tg-chat" { + t.Fatalf("expected chatID tg-chat, got %+v", msg) + } + if msg.Content != reasoning { + t.Fatalf("content mismatch: got %q want %q", msg.Content, reasoning) + } + return + } } }) t.Run("expired ctx", func(t *testing.T) { al, msgBus := newLoop(t) reasoning := "hello telegram reasoning" - ctx, cancel := context.WithCancel(context.Background()) - cancel() - al.handleReasoning(ctx, reasoning, "telegram", "tg-chat") - ctx, cancel = context.WithTimeout(context.Background(), 200*time.Millisecond) - defer cancel() - msg, ok := msgBus.SubscribeOutbound(ctx) - if ok { - t.Fatalf("expected no outbound message, got %+v", msg) + al.handleReasoning(context.Background(), reasoning, "telegram", "tg-chat") + + consumeCtx, consumeCancel := context.WithTimeout(context.Background(), 2*time.Second) + defer consumeCancel() + + for { + select { + case msg, ok := <-msgBus.OutboundChan(): + if !ok { + t.Fatalf("expected no outbound message, but received: %+v", msg) + } + t.Logf("Received unexpected outbound message: %+v", msg) + return + case <-consumeCtx.Done(): + t.Fatalf("failed: no message received within timeout") + return + } } }) @@ -1092,20 +1122,23 @@ func TestHandleReasoning(t *testing.T) { // Drain the bus and verify the reasoning message was NOT published // (it should have been dropped due to timeout). - drainCtx, drainCancel := context.WithTimeout(context.Background(), 100*time.Millisecond) - defer drainCancel() - foundReasoning := false + timeer := time.After(1 * time.Second) for { - msg, ok := msgBus.SubscribeOutbound(drainCtx) - if !ok { - break + select { + case <-timeer: + t.Logf( + "no reasoning message received after draining bus for 1s, as expected,length=%d", + len(msgBus.OutboundChan()), + ) + return + case msg, ok := <-msgBus.OutboundChan(): + if !ok { + break + } + if msg.Content == "should timeout" { + t.Fatal("expected reasoning message to be dropped when bus is full, but it was published") + } } - if msg.Content == "should timeout" { - foundReasoning = true - } - } - if foundReasoning { - t.Fatal("expected reasoning message to be dropped when bus is full, but it was published") } }) } diff --git a/pkg/bus/bus.go b/pkg/bus/bus.go index f5ff9587d..3d08bda4f 100644 --- a/pkg/bus/bus.go +++ b/pkg/bus/bus.go @@ -3,6 +3,7 @@ package bus import ( "context" "errors" + "sync" "sync/atomic" "github.com/sipeed/picoclaw/pkg/logger" @@ -17,8 +18,11 @@ type MessageBus struct { inbound chan InboundMessage outbound chan OutboundMessage outboundMedia chan OutboundMediaMessage - done chan struct{} - closed atomic.Bool + + closeOnce sync.Once + done chan struct{} + closed atomic.Bool + wg sync.WaitGroup } func NewMessageBus() *MessageBus { @@ -30,128 +34,91 @@ func NewMessageBus() *MessageBus { } } -func (mb *MessageBus) PublishInbound(ctx context.Context, msg InboundMessage) error { +func publish[T any](ctx context.Context, mb *MessageBus, ch chan T, msg T) error { + // check bus closed before acquiring wg, to avoid unnecessary wg.Add and potential deadlock if mb.closed.Load() { return ErrBusClosed } - if err := ctx.Err(); err != nil { - return err - } + + // check again,before sending message, to avoid sending to closed channel select { - case mb.inbound <- msg: - return nil - case <-mb.done: - return ErrBusClosed case <-ctx.Done(): return ctx.Err() + case <-mb.done: + return ErrBusClosed + default: + } + + mb.wg.Add(1) + defer mb.wg.Done() + + select { + case ch <- msg: + return nil + case <-ctx.Done(): + return ctx.Err() + case <-mb.done: + return ErrBusClosed } } -func (mb *MessageBus) ConsumeInbound(ctx context.Context) (InboundMessage, bool) { - select { - case msg, ok := <-mb.inbound: - return msg, ok - case <-mb.done: - return InboundMessage{}, false - case <-ctx.Done(): - return InboundMessage{}, false - } +func (mb *MessageBus) PublishInbound(ctx context.Context, msg InboundMessage) error { + return publish(ctx, mb, mb.inbound, msg) +} + +func (mb *MessageBus) InboundChan() <-chan InboundMessage { + return mb.inbound } func (mb *MessageBus) PublishOutbound(ctx context.Context, msg OutboundMessage) error { - if mb.closed.Load() { - return ErrBusClosed - } - if err := ctx.Err(); err != nil { - return err - } - select { - case mb.outbound <- msg: - return nil - case <-mb.done: - return ErrBusClosed - case <-ctx.Done(): - return ctx.Err() - } + return publish(ctx, mb, mb.outbound, msg) } -func (mb *MessageBus) SubscribeOutbound(ctx context.Context) (OutboundMessage, bool) { - select { - case msg, ok := <-mb.outbound: - return msg, ok - case <-mb.done: - return OutboundMessage{}, false - case <-ctx.Done(): - return OutboundMessage{}, false - } +func (mb *MessageBus) OutboundChan() <-chan OutboundMessage { + return mb.outbound } func (mb *MessageBus) PublishOutboundMedia(ctx context.Context, msg OutboundMediaMessage) error { - if mb.closed.Load() { - return ErrBusClosed - } - if err := ctx.Err(); err != nil { - return err - } - select { - case mb.outboundMedia <- msg: - return nil - case <-mb.done: - return ErrBusClosed - case <-ctx.Done(): - return ctx.Err() - } + return publish(ctx, mb, mb.outboundMedia, msg) } -func (mb *MessageBus) SubscribeOutboundMedia(ctx context.Context) (OutboundMediaMessage, bool) { - select { - case msg, ok := <-mb.outboundMedia: - return msg, ok - case <-mb.done: - return OutboundMediaMessage{}, false - case <-ctx.Done(): - return OutboundMediaMessage{}, false - } +func (mb *MessageBus) OutboundMediaChan() <-chan OutboundMediaMessage { + return mb.outboundMedia } func (mb *MessageBus) Close() { - if mb.closed.CompareAndSwap(false, true) { + mb.closeOnce.Do(func() { + // notify all blocked publishers to exit close(mb.done) - // Drain buffered channels so messages aren't silently lost. - // Channels are NOT closed to avoid send-on-closed panics from concurrent publishers. + // because every publisher will check mb.closed before acquiring wg + // so we can be sure that new publishers will not be added new messages after this point + mb.closed.Store(true) + + // wait for all ongoing Publish calls to finish, ensuring all messages have been sent to channels or exited + mb.wg.Wait() + + // close channels safely + close(mb.inbound) + close(mb.outbound) + close(mb.outboundMedia) + + // clean up any remaining messages in channels drained := 0 - for { - select { - case <-mb.inbound: - drained++ - default: - goto doneInbound - } + for range mb.inbound { + drained++ } - doneInbound: - for { - select { - case <-mb.outbound: - drained++ - default: - goto doneOutbound - } + for range mb.outbound { + drained++ } - doneOutbound: - for { - select { - case <-mb.outboundMedia: - drained++ - default: - goto doneMedia - } + for range mb.outboundMedia { + drained++ } - doneMedia: + if drained > 0 { logger.DebugCF("bus", "Drained buffered messages during close", map[string]any{ "count": drained, }) } - } + }) } diff --git a/pkg/bus/bus_test.go b/pkg/bus/bus_test.go index e07b8c7fe..9b6324ca6 100644 --- a/pkg/bus/bus_test.go +++ b/pkg/bus/bus_test.go @@ -24,7 +24,7 @@ func TestPublishConsume(t *testing.T) { t.Fatalf("PublishInbound failed: %v", err) } - got, ok := mb.ConsumeInbound(ctx) + got, ok := <-mb.InboundChan() if !ok { t.Fatal("ConsumeInbound returned ok=false") } @@ -52,7 +52,7 @@ func TestPublishOutboundSubscribe(t *testing.T) { t.Fatalf("PublishOutbound failed: %v", err) } - got, ok := mb.SubscribeOutbound(ctx) + got, ok := <-mb.OutboundChan() if !ok { t.Fatal("SubscribeOutbound returned ok=false") } @@ -108,27 +108,48 @@ func TestPublishOutbound_BusClosed(t *testing.T) { func TestConsumeInbound_ContextCancel(t *testing.T) { mb := NewMessageBus() + defer mb.Close() - ctx, cancel := context.WithCancel(context.Background()) - cancel() + for i := range defaultBusBufferSize { + if err := mb.PublishInbound(context.Background(), InboundMessage{Content: "fill"}); err != nil { + t.Fatalf("fill failed at %d: %v", i, err) + } + } - _, ok := mb.ConsumeInbound(ctx) - if ok { - t.Fatal("expected ok=false when context is canceled") + ctx, cancel := context.WithTimeout(context.Background(), 100*time.Millisecond) + defer cancel() + mb.PublishInbound(ctx, InboundMessage{Content: "ContextCancel"}) + + select { + case <-ctx.Done(): + t.Log("context canceled, as expected") + + case msg, ok := <-mb.InboundChan(): + if !ok { + t.Fatal("expected ok=false when context is canceled") + } + if msg.Content == "ContextCancel" { + t.Fatalf("expected content 'ContextCancel', got %q", msg.Content) + } } } func TestConsumeInbound_BusClosed(t *testing.T) { mb := NewMessageBus() - mb.Close() - ctx, cancel := context.WithTimeout(context.Background(), 100*time.Millisecond) - defer cancel() + timer := time.AfterFunc(100*time.Millisecond, func() { + mb.Close() + }) - _, ok := mb.ConsumeInbound(ctx) - if ok { - t.Fatal("expected ok=false when bus is closed") + select { + case <-timer.C: + t.Log("context canceled, as expected") + + case _, ok := <-mb.InboundChan(): + if ok { + t.Fatal("expected ok=false when context is canceled") + } } } @@ -136,10 +157,7 @@ func TestSubscribeOutbound_BusClosed(t *testing.T) { mb := NewMessageBus() mb.Close() - ctx, cancel := context.WithTimeout(context.Background(), 100*time.Millisecond) - defer cancel() - - _, ok := mb.SubscribeOutbound(ctx) + _, ok := <-mb.OutboundChan() if ok { t.Fatal("expected ok=false when bus is closed") } diff --git a/pkg/channels/manager.go b/pkg/channels/manager.go index 7d49a0e30..aed815399 100644 --- a/pkg/channels/manager.go +++ b/pkg/channels/manager.go @@ -585,7 +585,7 @@ func (m *Manager) sendWithRetry(ctx context.Context, name string, w *channelWork func dispatchLoop[M any]( ctx context.Context, m *Manager, - subscribe func(context.Context) (M, bool), + ch <-chan M, getChannel func(M) string, enqueue func(context.Context, *channelWorker, M) bool, startMsg, stopMsg, unknownMsg, noWorkerMsg string, @@ -593,35 +593,41 @@ func dispatchLoop[M any]( logger.InfoC("channels", startMsg) for { - msg, ok := subscribe(ctx) - if !ok { + select { + case <-ctx.Done(): logger.InfoC("channels", stopMsg) return - } - channel := getChannel(msg) - - // Silently skip internal channels - if constants.IsInternalChannel(channel) { - continue - } - - m.mu.RLock() - _, exists := m.channels[channel] - w, wExists := m.workers[channel] - m.mu.RUnlock() - - if !exists { - logger.WarnCF("channels", unknownMsg, map[string]any{"channel": channel}) - continue - } - - if wExists && w != nil { - if !enqueue(ctx, w, msg) { + case msg, ok := <-ch: + if !ok { + logger.InfoC("channels", stopMsg) return } - } else if exists { - logger.WarnCF("channels", noWorkerMsg, map[string]any{"channel": channel}) + + channel := getChannel(msg) + + // Silently skip internal channels + if constants.IsInternalChannel(channel) { + continue + } + + m.mu.RLock() + _, exists := m.channels[channel] + w, wExists := m.workers[channel] + m.mu.RUnlock() + + if !exists { + logger.WarnCF("channels", unknownMsg, map[string]any{"channel": channel}) + continue + } + + if wExists && w != nil { + if !enqueue(ctx, w, msg) { + return + } + } else if exists { + logger.WarnCF("channels", noWorkerMsg, map[string]any{"channel": channel}) + } } } } @@ -629,7 +635,7 @@ func dispatchLoop[M any]( func (m *Manager) dispatchOutbound(ctx context.Context) { dispatchLoop( ctx, m, - m.bus.SubscribeOutbound, + m.bus.OutboundChan(), func(msg bus.OutboundMessage) string { return msg.Channel }, func(ctx context.Context, w *channelWorker, msg bus.OutboundMessage) bool { select { @@ -649,7 +655,7 @@ func (m *Manager) dispatchOutbound(ctx context.Context) { func (m *Manager) dispatchOutboundMedia(ctx context.Context) { dispatchLoop( ctx, m, - m.bus.SubscribeOutboundMedia, + m.bus.OutboundMediaChan(), func(msg bus.OutboundMediaMessage) string { return msg.Channel }, func(ctx context.Context, w *channelWorker, msg bus.OutboundMediaMessage) bool { select { diff --git a/pkg/channels/qq/qq_test.go b/pkg/channels/qq/qq_test.go index 3ceee0d09..b04cf5abd 100644 --- a/pkg/channels/qq/qq_test.go +++ b/pkg/channels/qq/qq_test.go @@ -34,11 +34,19 @@ func TestHandleC2CMessage_IncludesAccountIDMetadata(t *testing.T) { ctx, cancel := context.WithTimeout(context.Background(), time.Second) defer cancel() - inbound, ok := messageBus.ConsumeInbound(ctx) - if !ok { - t.Fatal("expected inbound message") - } - if inbound.Metadata["account_id"] != "7750283E123456" { - t.Fatalf("account_id metadata = %q, want %q", inbound.Metadata["account_id"], "7750283E123456") + for { + select { + case <-ctx.Done(): + t.Fatal("timeout waiting for inbound message") + return + case inbound, ok := <-messageBus.InboundChan(): + if !ok { + t.Fatal("expected inbound message") + } + if inbound.Metadata["account_id"] != "7750283E123456" { + t.Fatalf("account_id metadata = %q, want %q", inbound.Metadata["account_id"], "7750283E123456") + } + return + } } } diff --git a/pkg/channels/telegram/telegram_dispatch_test.go b/pkg/channels/telegram/telegram_dispatch_test.go index 1ea4a4824..0eb1de5ea 100644 --- a/pkg/channels/telegram/telegram_dispatch_test.go +++ b/pkg/channels/telegram/telegram_dispatch_test.go @@ -3,7 +3,6 @@ package telegram import ( "context" "testing" - "time" "github.com/mymmrac/telego" @@ -36,10 +35,7 @@ func TestHandleMessage_DoesNotConsumeGenericCommandsLocally(t *testing.T) { t.Fatalf("handleMessage error: %v", err) } - ctx, cancel := context.WithTimeout(context.Background(), time.Second) - defer cancel() - - inbound, ok := messageBus.ConsumeInbound(ctx) + inbound, ok := <-messageBus.InboundChan() if !ok { t.Fatal("expected inbound message to be forwarded") } diff --git a/pkg/channels/telegram/telegram_group_command_filter_test.go b/pkg/channels/telegram/telegram_group_command_filter_test.go index 0d5b985fe..614b2ca7f 100644 --- a/pkg/channels/telegram/telegram_group_command_filter_test.go +++ b/pkg/channels/telegram/telegram_group_command_filter_test.go @@ -108,22 +108,24 @@ func TestHandleMessage_GroupMentionOnly_BotCommandEntity(t *testing.T) { t.Fatalf("handleMessage error: %v", err) } - ctx, cancel := context.WithTimeout(context.Background(), 150*time.Millisecond) + ctx, cancel := context.WithTimeout(context.Background(), 200*time.Microsecond) defer cancel() - - inbound, ok := messageBus.ConsumeInbound(ctx) - if tc.wantForwarded { - if !ok { - t.Fatal("expected inbound message to be forwarded") + select { + case <-ctx.Done(): + if tc.wantForwarded { + t.Fatal("timeout waiting for message to be forwarded") + return } - if inbound.Content != tc.wantContent { - t.Fatalf("content=%q want=%q", inbound.Content, tc.wantContent) + case inbound, ok := <-messageBus.InboundChan(): + if tc.wantForwarded { + if !ok { + t.Fatal("expected inbound message to be forwarded") + } + if inbound.Content != tc.wantContent { + t.Fatalf("content=%q want=%q", inbound.Content, tc.wantContent) + } + return } - return - } - - if ok { - t.Fatalf("expected message to be filtered, got content=%q", inbound.Content) } }) } diff --git a/pkg/channels/telegram/telegram_test.go b/pkg/channels/telegram/telegram_test.go index c2186d0a3..52a2b046c 100644 --- a/pkg/channels/telegram/telegram_test.go +++ b/pkg/channels/telegram/telegram_test.go @@ -6,7 +6,6 @@ import ( "errors" "strings" "testing" - "time" "github.com/mymmrac/telego" ta "github.com/mymmrac/telego/telegoapi" @@ -355,10 +354,7 @@ func TestHandleMessage_ForumTopic_SetsMetadata(t *testing.T) { err := ch.handleMessage(context.Background(), msg) require.NoError(t, err) - ctx, cancel := context.WithTimeout(context.Background(), time.Second) - defer cancel() - - inbound, ok := messageBus.ConsumeInbound(ctx) + inbound, ok := <-messageBus.InboundChan() require.True(t, ok, "expected inbound message") // Composite chatID should include thread ID @@ -397,10 +393,7 @@ func TestHandleMessage_NoForum_NoThreadMetadata(t *testing.T) { err := ch.handleMessage(context.Background(), msg) require.NoError(t, err) - ctx, cancel := context.WithTimeout(context.Background(), time.Second) - defer cancel() - - inbound, ok := messageBus.ConsumeInbound(ctx) + inbound, ok := <-messageBus.InboundChan() require.True(t, ok) // Plain chatID without thread suffix @@ -443,10 +436,7 @@ func TestHandleMessage_ReplyThread_NonForum_NoIsolation(t *testing.T) { err := ch.handleMessage(context.Background(), msg) require.NoError(t, err) - ctx, cancel := context.WithTimeout(context.Background(), time.Second) - defer cancel() - - inbound, ok := messageBus.ConsumeInbound(ctx) + inbound, ok := <-messageBus.InboundChan() require.True(t, ok) // chatID should NOT include thread suffix for non-forum groups diff --git a/pkg/channels/whatsapp/whatsapp_command_test.go b/pkg/channels/whatsapp/whatsapp_command_test.go index ee8aa4a52..2d85d74f8 100644 --- a/pkg/channels/whatsapp/whatsapp_command_test.go +++ b/pkg/channels/whatsapp/whatsapp_command_test.go @@ -3,7 +3,6 @@ package whatsapp import ( "context" "testing" - "time" "github.com/sipeed/picoclaw/pkg/bus" "github.com/sipeed/picoclaw/pkg/channels" @@ -25,10 +24,7 @@ func TestHandleIncomingMessage_DoesNotConsumeGenericCommandsLocally(t *testing.T "content": "/help", }) - ctx, cancel := context.WithTimeout(context.Background(), time.Second) - defer cancel() - - inbound, ok := messageBus.ConsumeInbound(ctx) + inbound, ok := <-messageBus.InboundChan() if !ok { t.Fatal("expected inbound message to be forwarded") } diff --git a/pkg/channels/whatsapp_native/whatsapp_command_test.go b/pkg/channels/whatsapp_native/whatsapp_command_test.go index cc2dcb619..e51bec392 100644 --- a/pkg/channels/whatsapp_native/whatsapp_command_test.go +++ b/pkg/channels/whatsapp_native/whatsapp_command_test.go @@ -43,14 +43,19 @@ func TestHandleIncoming_DoesNotConsumeGenericCommandsLocally(t *testing.T) { ctx, cancel := context.WithTimeout(context.Background(), time.Second) defer cancel() - inbound, ok := messageBus.ConsumeInbound(ctx) - if !ok { - t.Fatal("expected inbound message to be forwarded") - } - if inbound.Channel != "whatsapp_native" { - t.Fatalf("channel=%q", inbound.Channel) - } - if inbound.Content != "/new" { - t.Fatalf("content=%q", inbound.Content) + select { + case <-ctx.Done(): + t.Fatal("timeout waiting for message to be forwarded") + return + case inbound, ok := <-messageBus.InboundChan(): + if !ok { + t.Fatal("expected inbound message to be forwarded") + } + if inbound.Channel != "whatsapp_native" { + t.Fatalf("channel=%q", inbound.Channel) + } + if inbound.Content != "/new" { + t.Fatalf("content=%q", inbound.Content) + } } }