Skip to content

The cross-harness, self-improving memory layer for AI agents. Join our community: https://discord.com/invite/zdNChS2fBu

fixes

Justin D'Souza5ef78331f4c1
diff --git a/cli/beacon/cmd/mcp.go b/cli/beacon/cmd/mcp.go
index 73c1543f..2496e002 100644
--- a/cli/beacon/cmd/mcp.go
+++ b/cli/beacon/cmd/mcp.go
@@ -1,6 +1,7 @@
package cmd
import (
+ "errors"
"fmt"
"net"
"net/http"
@@ -55,8 +56,8 @@ func init() {
c.Flags().BoolVar(&mcpOpts.userMode, "user", true, "Use per-user endpoint paths")
c.Flags().BoolVar(&mcpOpts.systemMode, "system", false, "Use system endpoint paths")
c.Flags().StringVar(&mcpOpts.logPath, "log-path", "", "Runtime JSONL log path")
- c.Flags().StringVar(&mcpOpts.transport, "transport", mcpserver.TransportStdio, "MCP transport: stdio or http")
- c.Flags().StringVar(&mcpOpts.addr, "addr", defaultMCPHTTPAddr, "Loopback HTTP listen address for --transport http")
+ c.Flags().StringVar(&mcpOpts.transport, "transport", mcpserver.TransportStdio, "MCP transport: stdio or http (HTTP JSON-RPC)")
+ c.Flags().StringVar(&mcpOpts.addr, "addr", defaultMCPHTTPAddr, "Loopback HTTP JSON-RPC listen address for --transport http")
}
}
@@ -65,7 +66,7 @@ func runMCPServe(cmd *cobra.Command, args []string) error {
return err
}
runtimeLog := resolveMCPRuntimeLog()
- server := mcpserver.New(mcpserver.Options{LogPath: runtimeLog.EffectiveLogPath, Stderr: os.Stderr})
+ server := mcpserver.New(mcpserver.Options{LogPath: runtimeLog.EffectiveLogPath})
switch normalizedTransport() {
case mcpserver.TransportStdio:
return server.ServeStdio(cmd.Context(), os.Stdin, os.Stdout)
@@ -113,12 +114,19 @@ func runMCPDoctor(cmd *cobra.Command, args []string) error {
fmt.Printf("Content retention: %s\n", cfg.ContentRetention)
sampled, malformed, archives, err := activity.InspectLog(runtimeLog.EffectiveLogPath)
if err != nil {
- return err
+ if errors.Is(err, os.ErrNotExist) {
+ fmt.Println("Runtime log check: no log file yet")
+ fmt.Println("Beacon MCP can still start, but activity answers will be empty until endpoint telemetry writes events.")
+ } else {
+ return err
+ }
+ } else {
+ fmt.Println("Runtime log check: ok")
}
fmt.Printf("Sampled events: %d\n", sampled)
fmt.Printf("Malformed lines: %d\n", malformed)
fmt.Printf("Readable archives: %d\n", len(archives))
- server := mcpserver.New(mcpserver.Options{LogPath: runtimeLog.EffectiveLogPath, Stderr: os.Stderr})
+ server := mcpserver.New(mcpserver.Options{LogPath: runtimeLog.EffectiveLogPath})
if err := server.HasExpectedTools(); err != nil {
return err
}
diff --git a/cli/beacon/internal/endpoint/activity/activity.go b/cli/beacon/internal/endpoint/activity/activity.go
index dfbb410d..da50a6f6 100644
--- a/cli/beacon/internal/endpoint/activity/activity.go
+++ b/cli/beacon/internal/endpoint/activity/activity.go
@@ -54,8 +54,8 @@ type SearchResult struct {
}
type SummaryResult struct {
- Meta ResultMeta `json:"meta"`
- Summary dashboard.Summary `json:"summary"`
+ Meta ResultMeta `json:"meta"`
+ Summary Summary `json:"summary"`
}
type EventResult struct {
@@ -73,6 +73,43 @@ type ValueCount struct {
Count int `json:"count"`
}
+type Count struct {
+ Name string `json:"name"`
+ Count int `json:"count"`
+}
+
+type Summary struct {
+ TotalEvents int `json:"total_events"`
+ LastEventTime string `json:"last_event_time,omitempty"`
+ ActiveSessions int `json:"active_sessions"`
+ MalformedLines int `json:"malformed_lines"`
+ CountsByAction map[string]int `json:"counts_by_action"`
+ CountsByHarness map[string]int `json:"counts_by_harness"`
+ CountsBySeverity map[string]int `json:"counts_by_severity"`
+ CountsByCategory map[string]int `json:"counts_by_category"`
+ CountsByApprovalDecision map[string]int `json:"counts_by_approval_decision"`
+ CountsByMCPServer map[string]int `json:"counts_by_mcp_server"`
+ CountsByRepository map[string]int `json:"counts_by_repository"`
+ CountsByModel map[string]int `json:"counts_by_model"`
+ PromptEvents int `json:"prompt_events"`
+ ToolEvents int `json:"tool_events"`
+ CommandEvents int `json:"command_events"`
+ FileEvents int `json:"file_events"`
+ MCPEvents int `json:"mcp_events"`
+ ApprovalEvents int `json:"approval_events"`
+ HighSeverityEvents int `json:"high_severity_events"`
+ CriticalSeverityEvents int `json:"critical_severity_events"`
+ NeedsReviewEvents int `json:"needs_review_events"`
+ FailedToolEvents int `json:"failed_tool_events"`
+ DeniedApprovalEvents int `json:"denied_approval_events"`
+ PolicyBlockedEvents int `json:"policy_blocked_events"`
+ TopActions []Count `json:"top_actions"`
+ TopHarnesses []Count `json:"top_harnesses"`
+ TopModels []Count `json:"top_models"`
+ TopRepositories []Count `json:"top_repositories"`
+ TopMCPServers []Count `json:"top_mcp_servers"`
+}
+
type EventSummary struct {
ID string `json:"id"`
Timestamp string `json:"timestamp"`
@@ -165,10 +202,13 @@ func Summarize(query Query) (SummaryResult, error) {
if err != nil {
return SummaryResult{}, err
}
- return SummaryResult{Meta: metaFromResult(result), Summary: dashboard.BuildSummary(result)}, nil
+ return SummaryResult{Meta: metaFromResult(result), Summary: activitySummary(dashboard.BuildSummary(result))}, nil
}
func GetEvent(logPath, id string) (EventResult, error) {
+ if logPath == "" {
+ return EventResult{}, fmt.Errorf("runtime log path is required")
+ }
record, ok, err := dashboard.FindEvent(logPath, id)
if err != nil {
return EventResult{}, err
@@ -228,7 +268,11 @@ func ListFilters(query Query) (FilterValuesResult, error) {
for name, values := range counts {
filters[name] = topValues(values, 20)
}
- return FilterValuesResult{Meta: metaFromResult(result), Filters: filters}, nil
+ meta := metaFromResult(result)
+ if result.Truncated {
+ meta.Caveats = append(meta.Caveats, "filter values are based on the returned event window")
+ }
+ return FilterValuesResult{Meta: meta, Filters: filters}, nil
}
func InspectLog(logPath string) (sampledEvents, malformedLines int, archives []string, err error) {
@@ -376,6 +420,48 @@ func contentCaveats(content *ContentSummary) []string {
return caveats
}
+func activitySummary(summary dashboard.Summary) Summary {
+ return Summary{
+ TotalEvents: summary.TotalEvents,
+ LastEventTime: summary.LastEventTime,
+ ActiveSessions: summary.ActiveSessions,
+ MalformedLines: summary.MalformedLines,
+ CountsByAction: summary.CountsByAction,
+ CountsByHarness: summary.CountsByHarness,
+ CountsBySeverity: summary.CountsBySeverity,
+ CountsByCategory: summary.CountsByCategory,
+ CountsByApprovalDecision: summary.CountsByApprovalDecision,
+ CountsByMCPServer: summary.CountsByMCPServer,
+ CountsByRepository: summary.CountsByRepository,
+ CountsByModel: summary.CountsByModel,
+ PromptEvents: summary.PromptEvents,
+ ToolEvents: summary.ToolEvents,
+ CommandEvents: summary.CommandEvents,
+ FileEvents: summary.FileEvents,
+ MCPEvents: summary.MCPEvents,
+ ApprovalEvents: summary.ApprovalEvents,
+ HighSeverityEvents: summary.HighSeverityEvents,
+ CriticalSeverityEvents: summary.CriticalSeverityEvents,
+ NeedsReviewEvents: summary.NeedsReviewEvents,
+ FailedToolEvents: summary.FailedToolEvents,
+ DeniedApprovalEvents: summary.DeniedApprovalEvents,
+ PolicyBlockedEvents: summary.PolicyBlockedEvents,
+ TopActions: activityCounts(summary.TopActions),
+ TopHarnesses: activityCounts(summary.TopHarnesses),
+ TopModels: activityCounts(summary.TopModels),
+ TopRepositories: activityCounts(summary.TopRepositories),
+ TopMCPServers: activityCounts(summary.TopMCPServers),
+ }
+}
+
+func activityCounts(counts []dashboard.Count) []Count {
+ out := make([]Count, 0, len(counts))
+ for _, count := range counts {
+ out = append(out, Count{Name: count.Name, Count: count.Count})
+ }
+ return out
+}
+
func add(counts map[string]int, value string) {
value = strings.TrimSpace(value)
if value != "" {
diff --git a/cli/beacon/internal/endpoint/activity/activity_test.go b/cli/beacon/internal/endpoint/activity/activity_test.go
index 7a8a5b49..99c85ea6 100644
--- a/cli/beacon/internal/endpoint/activity/activity_test.go
+++ b/cli/beacon/internal/endpoint/activity/activity_test.go
@@ -63,6 +63,27 @@ func TestGetEventReturnsNotFound(t *testing.T) {
}
}
+func TestGetEventRequiresLogPath(t *testing.T) {
+ if _, err := GetEvent("", "line-1"); err == nil {
+ t.Fatal("GetEvent accepted empty log path")
+ }
+}
+
+func TestListFiltersAddsWindowCaveatWhenTruncated(t *testing.T) {
+ path := filepath.Join(t.TempDir(), "runtime.jsonl")
+ writeLog(t, path,
+ testEvent("2026-05-13T01:00:00Z", "cursor", "prompt.submitted", "prompt"),
+ testEvent("2026-05-13T01:01:00Z", "claude", "prompt.submitted", "prompt"),
+ )
+ result, err := ListFilters(Query{LogPath: path, Limit: 1})
+ if err != nil {
+ t.Fatalf("ListFilters returned error: %v", err)
+ }
+ if !result.Meta.Truncated || len(result.Meta.Caveats) == 0 {
+ t.Fatalf("meta = %#v, want truncated caveat", result.Meta)
+ }
+}
+
func TestSearchReportsMalformedLines(t *testing.T) {
path := filepath.Join(t.TempDir(), "runtime.jsonl")
event := testEvent("2026-05-13T01:00:00Z", "cursor", "command.executed", "command")
diff --git a/cli/beacon/internal/mcpserver/server.go b/cli/beacon/internal/mcpserver/server.go
index 828222c5..91c8b3f7 100644
--- a/cli/beacon/internal/mcpserver/server.go
+++ b/cli/beacon/internal/mcpserver/server.go
@@ -1,3 +1,7 @@
+// Package mcpserver implements the small local MCP server surface Beacon needs
+// for activity querying. It intentionally supports the server methods exercised
+// by current desktop clients and tests: initialize, tools/list, tools/call, and
+// notifications without responses.
package mcpserver
import (
@@ -8,7 +12,6 @@ import (
"fmt"
"io"
"net/http"
- "os"
"strings"
"time"
@@ -23,14 +26,12 @@ const (
type Options struct {
LogPath string
- Stderr io.Writer
}
type Server struct {
logPath string
tools map[string]Tool
order []string
- stderr io.Writer
}
type Tool struct {
@@ -75,13 +76,9 @@ type textContent struct {
}
func New(opts Options) *Server {
- if opts.Stderr == nil {
- opts.Stderr = os.Stderr
- }
server := &Server{
logPath: opts.LogPath,
tools: map[string]Tool{},
- stderr: opts.Stderr,
}
server.registerTools()
return server