@hybridlabor-api/bdb-synapse 1.0.5 → 1.1.0

package/README.md

@@ -1,13 +1,27 @@
 # <img src="assets/logo.svg" alt="" width="30" /> BDB Synapse
 
+🌐 **Language / Sprache / Idioma**: **English**
 
 [![CI](https://github.com/hybridlabor-api/bdb-synapse/actions/workflows/ci.yml/badge.svg)](https://github.com/hybridlabor-api/bdb-synapse/actions)
 [![NPM Version](https://img.shields.io/npm/v/@hybridlabor-api/bdb-synapse.svg)](https://www.npmjs.com/package/@hybridlabor-api/bdb-synapse)
+[![Version](https://img.shields.io/badge/version-1.0.5-blue.svg)](https://github.com/hybridlabor-api/bdb-synapse)
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
 A visualization tool that replays coding-agent sessions on a 3D map of your codebase.
 
 **BDB Synapse** is an extended fork of the excellent [cosmtrek/mindwalk](https://github.com/cosmtrek/mindwalk) (MIT License), created to support the BDB ecosystem of agents. It adds support for the Antigravity (agy) CLI alongside the existing supported agents.
 
+---
+
+## 📚 Documentation Wiki
+
+Comprehensive developer manuals and design specifications are maintained in the project's **OpenWiki** directory:
+- 📐 **[System Architecture](.openwiki/ARCHITECTURE.md):** Go adapters, 3D citymap algorithms, and React/Three.js frontend structure.
+- 📋 **[Development Conventions](.openwiki/CONVENTIONS.md):** Go/TypeScript standards, schema contracts, and contribution rules.
+- 📜 **[Changelog](.openwiki/CHANGELOG.md):** Version highlights and release history.
+
+---
+
 ## The problem
 
 A session log records what an agent did, but not how it understood the task:

package/go.mod

@@ -1,7 +1,19 @@
 module github.com/hybridlabor-api/bdb-synapse
 
-go 1.25
+go 1.25.0
 
 require github.com/santhosh-tekuri/jsonschema/v6 v6.0.2
 
-require golang.org/x/text v0.14.0 // indirect
+require (
+	github.com/dustin/go-humanize v1.0.1 // indirect
+	github.com/google/uuid v1.6.0 // indirect
+	github.com/mattn/go-isatty v0.0.24 // indirect
+	github.com/ncruces/go-strftime v1.0.0 // indirect
+	github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec // indirect
+	golang.org/x/sys v0.47.0 // indirect
+	golang.org/x/text v0.14.0 // indirect
+	modernc.org/libc v1.74.4 // indirect
+	modernc.org/mathutil v1.7.1 // indirect
+	modernc.org/memory v1.11.0 // indirect
+	modernc.org/sqlite v1.57.0 // indirect
+)

package/go.sum

@@ -1,6 +1,26 @@
 github.com/dlclark/regexp2 v1.11.0 h1:G/nrcoOa7ZXlpoa/91N3X7mM3r8eIlMBBJZvsz/mxKI=
 github.com/dlclark/regexp2 v1.11.0/go.mod h1:DHkYz0B9wPfa6wondMfaivmHpzrQ3v9q8cnmRbL6yW8=
+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/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
+github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/mattn/go-isatty v0.0.24 h1:tGZZoVgT/KiqK1c8ocVLeDS8BSWMRd47J3Lbz7vsReI=
+github.com/mattn/go-isatty v0.0.24/go.mod h1:nMCL3Zebbrt45jsMDgnfIwz6ydEQApk5oEI3HqDio6A=
+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/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec h1:W09IVJc94icq4NjY3clb7Lk8O1qJ8BdBEF8z0ibU0rE=
+github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo=
 github.com/santhosh-tekuri/jsonschema/v6 v6.0.2 h1:KRzFb2m7YtdldCEkzs6KqmJw4nqEVZGK7IN2kJkjTuQ=
 github.com/santhosh-tekuri/jsonschema/v6 v6.0.2/go.mod h1:JXeL+ps8p7/KNMjDQk3TCwPpBy0wYklyWTfbkIzdIFU=
+golang.org/x/sys v0.47.0 h1:o7XGOvZQCADBQQ4Y7VNq2dRWQR7JmOUW8Kxx4ZsNgWs=
+golang.org/x/sys v0.47.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
 golang.org/x/text v0.14.0 h1:ScX5w1eTa3QqT8oi6+ziP7dTV1S2+ALU0bI+0zXKWiQ=
 golang.org/x/text v0.14.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU=
+modernc.org/libc v1.74.4 h1:fX1Omw4o2/1C2iRkkIsrQTasJQldLhRmuPreXLoWs9k=
+modernc.org/libc v1.74.4/go.mod h1:eeQAS9W3sZeKYMFubydxJpII9ybHWshk+7or7bLG9co=
+modernc.org/mathutil v1.7.1 h1:GCZVGXdaN8gTqB1Mf/usp1Y/hSqgI2vAGGP4jZMCxOU=
+modernc.org/mathutil v1.7.1/go.mod h1:4p5IwJITfppl0G4sUEDtCr4DthTaT47/N3aT6MhfgJg=
+modernc.org/memory v1.11.0 h1:o4QC8aMQzmcwCK3t3Ux/ZHmwFPzE6hf2Y5LbkRs+hbI=
+modernc.org/memory v1.11.0/go.mod h1:/JP4VbVC+K5sU2wZi9bHoq2MAkCnrt2r98UGeSK7Mjw=
+modernc.org/sqlite v1.57.0 h1:qNQP6xnx5M0ISNtlnxoOX0+cD5bJ0/gr9aMmndFczzg=
+modernc.org/sqlite v1.57.0/go.mod h1:yCJ2cmAaIkHQ25oXWrF8H4O1lIfPYPR26yCEDj2P3pQ=

package/internal/adapter/agy/adapter.go

@@ -1,10 +1,16 @@
 package agy
 
 import (
+	"bytes"
 	"encoding/json"
 	"fmt"
 	"os"
 	"path/filepath"
+	"regexp"
+	"sort"
+	"strings"
+	"sync"
+	"time"
 
 	"github.com/hybridlabor-api/bdb-synapse/internal/adapter"
 	"github.com/hybridlabor-api/bdb-synapse/internal/model"
@@ -31,11 +37,72 @@ func (a Adapter) SessionDir() string {
 	return DefaultDir()
 }
 
+var conversationIDRegex = regexp.MustCompile(`["\\]*conversationId["\\]*:\s*["\\]*([a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})`)
+
+var (
+	childIDsMu    sync.Mutex
+	childIDsCache = make(map[string]map[string]bool)
+	childIDsTime  = make(map[string]time.Time)
+)
+
+func scanChildIDs(dir string) map[string]bool {
+	childIDs := make(map[string]bool)
+	entries, err := os.ReadDir(dir)
+	if err != nil {
+		return childIDs
+	}
+	for _, entry := range entries {
+		if !entry.IsDir() {
+			continue
+		}
+		sid := entry.Name()
+		path := filepath.Join(dir, sid, ".system_generated", "logs", "transcript.jsonl")
+		f, err := os.Open(path)
+		if err != nil {
+			continue
+		}
+		adapter.ReadJSONLines(f, func(data []byte) {
+			if bytes.Contains(data, []byte("conversationId")) {
+				matches := conversationIDRegex.FindAllSubmatch(data, -1)
+				for _, m := range matches {
+					if len(m) > 1 {
+						cid := string(m[1])
+						if cid != sid {
+							childIDs[cid] = true
+						}
+					}
+				}
+			}
+		})
+		f.Close()
+	}
+	return childIDs
+}
+
+func getChildIDs(dir string) map[string]bool {
+	childIDsMu.Lock()
+	defer childIDsMu.Unlock()
+
+	if ids, ok := childIDsCache[dir]; ok {
+		if time.Since(childIDsTime[dir]) < 5*time.Second {
+			return ids
+		}
+	}
+
+	ids := scanChildIDs(dir)
+	childIDsCache[dir] = ids
+	childIDsTime[dir] = time.Now()
+	return ids
+}
+
 func (a Adapter) ListSessions() ([]model.SessionMeta, error) {
 	dir := a.SessionDir()
 	if info, err := os.Stat(dir); err != nil || !info.IsDir() {
 		return nil, nil
 	}
+
+	childIDs := getChildIDs(dir)
+
 	var metas []model.SessionMeta
 	entries, err := os.ReadDir(dir)
 	if err != nil {
@@ -45,13 +112,20 @@ func (a Adapter) ListSessions() ([]model.SessionMeta, error) {
 		if !entry.IsDir() {
 			continue
 		}
-		path := filepath.Join(dir, entry.Name(), ".system_generated", "logs", "transcript.jsonl")
+		sid := entry.Name()
+		path := filepath.Join(dir, sid, ".system_generated", "logs", "transcript.jsonl")
 		if _, err := os.Stat(path); err == nil {
 			if meta, err := a.Summarize(path); err == nil {
+				if childIDs[sid] {
+					meta.Auxiliary = true
+				}
 				metas = append(metas, meta)
 			}
 		}
 	}
+	sort.Slice(metas, func(i, j int) bool {
+		return metas[i].EndedAt > metas[j].EndedAt
+	})
 	return metas, nil
 }
 
@@ -60,16 +134,130 @@ type ToolCall struct {
 	Args map[string]string `json:"args"`
 }
 
+type StepState struct {
+	Cwd           string   `json:"cwd"`
+	WorkspaceUris []string `json:"workspace_uris"`
+}
+
 type Step struct {
-	StepIndex int        `json:"step_index"`
-	Source    string     `json:"source"`
-	Type      string     `json:"type"`
-	Status    string     `json:"status"`
-	CreatedAt string     `json:"created_at"`
-	Content   string     `json:"content"`
-	Thinking  string     `json:"thinking"`
-	ToolCalls []ToolCall `json:"tool_calls"`
-	ExitCode  *int       `json:"exit_code"`
+	StepIndex     int        `json:"step_index"`
+	Source        string     `json:"source"`
+	Type          string     `json:"type"`
+	Status        string     `json:"status"`
+	CreatedAt     string     `json:"created_at"`
+	Content       string     `json:"content"`
+	Thinking      string     `json:"thinking"`
+	ToolCalls     []ToolCall `json:"tool_calls"`
+	ExitCode      *int       `json:"exit_code"`
+	Cwd           string     `json:"cwd"`
+	WorkspaceUris []string   `json:"workspace_uris"`
+	State         StepState  `json:"state"`
+}
+
+func cleanWorkspacePath(p string) string {
+	if p == "" {
+		return ""
+	}
+	p = strings.Trim(p, "\"'\t \n\r")
+	p = strings.TrimPrefix(p, "file://")
+	p = filepath.Clean(p)
+	if p == "." || strings.Contains(p, "/.gemini/") {
+		return ""
+	}
+	return p
+}
+
+func extractWorkspaceFromToolCalls(toolCalls []ToolCall) string {
+	for _, tc := range toolCalls {
+		for _, k := range []string{"Cwd", "SearchDirectory", "DirectoryPath"} {
+			if v, ok := tc.Args[k]; ok {
+				if p := cleanWorkspacePath(v); p != "" && strings.HasPrefix(p, "/") {
+					return p
+				}
+			}
+		}
+	}
+	for _, tc := range toolCalls {
+		for _, k := range []string{"AbsolutePath", "TargetFile", "SearchPath"} {
+			if v, ok := tc.Args[k]; ok {
+				if p := cleanWorkspacePath(v); p != "" && strings.HasPrefix(p, "/") {
+					return filepath.Dir(p)
+				}
+			}
+		}
+	}
+	return ""
+}
+
+func (s Step) GetWorkspace() string {
+	if len(s.State.WorkspaceUris) > 0 && s.State.WorkspaceUris[0] != "" {
+		if p := cleanWorkspacePath(s.State.WorkspaceUris[0]); p != "" {
+			return p
+		}
+	}
+	if s.State.Cwd != "" {
+		if p := cleanWorkspacePath(s.State.Cwd); p != "" {
+			return p
+		}
+	}
+	if len(s.WorkspaceUris) > 0 && s.WorkspaceUris[0] != "" {
+		if p := cleanWorkspacePath(s.WorkspaceUris[0]); p != "" {
+			return p
+		}
+	}
+	if s.Cwd != "" {
+		if p := cleanWorkspacePath(s.Cwd); p != "" {
+			return p
+		}
+	}
+	if len(s.ToolCalls) > 0 {
+		if p := extractWorkspaceFromToolCalls(s.ToolCalls); p != "" {
+			return p
+		}
+	}
+	return ""
+}
+
+func truncateTitle(content string, length int) string {
+	runes := []rune(content)
+	if len(runes) > length {
+		return string(runes[:length-3]) + "..."
+	}
+	return content
+}
+
+var (
+	metadataRegex = regexp.MustCompile(`(?s)<ADDITIONAL_METADATA>.*?</ADDITIONAL_METADATA>`)
+	settingsRegex = regexp.MustCompile(`(?s)<USER_SETTINGS_CHANGE>.*?</USER_SETTINGS_CHANGE>`)
+	xmlTagRegex   = regexp.MustCompile(`(?s)<[^>]+>`)
+)
+
+func cleanPromptTitle(raw string) string {
+	cleaned := metadataRegex.ReplaceAllString(raw, "")
+	cleaned = settingsRegex.ReplaceAllString(cleaned, "")
+	cleaned = xmlTagRegex.ReplaceAllString(cleaned, "")
+	lines := strings.Split(cleaned, "\n")
+	var validLines []string
+	for _, l := range lines {
+		l = strings.TrimSpace(l)
+		if l == "" {
+			continue
+		}
+		if (strings.HasPrefix(l, "/var/folders") || strings.HasPrefix(l, "/Users/")) &&
+			(strings.HasSuffix(l, ".png") || strings.HasSuffix(l, ".jpg") || strings.HasSuffix(l, ".jpeg") || strings.HasSuffix(l, ".webp") || strings.Contains(l, "/TemporaryItems/")) {
+			continue
+		}
+		validLines = append(validLines, l)
+	}
+	cleaned = strings.Join(validLines, " ")
+	cleaned = strings.TrimSpace(cleaned)
+	if cleaned == "" {
+		cleaned = strings.TrimSpace(xmlTagRegex.ReplaceAllString(raw, ""))
+	}
+	if cleaned == "" {
+		return "Antigravity Session"
+	}
+	return truncateTitle(cleaned, 60)
 }
 
 func (a Adapter) SummaryInputs(path string) []string {
@@ -85,15 +273,25 @@ func (a Adapter) Summarize(path string) (model.SessionMeta, error) {
 
 	id := filepath.Base(filepath.Dir(filepath.Dir(filepath.Dir(path))))
 	meta := model.SessionMeta{
+		Key:     adapter.SessionKey(a.Harness(), path),
 		ID:      id,
 		Harness: "agy",
 		Path:    path,
 		Title:   id,
 	}
 
+	var titleSet bool
+
 	adapter.ReadJSONLines(f, func(data []byte) {
 		var step Step
 		if json.Unmarshal(data, &step) == nil {
+			if meta.Cwd == "" {
+				meta.Cwd = step.GetWorkspace()
+			}
+			if !titleSet && step.Source == "USER_EXPLICIT" && step.Type == "USER_INPUT" && step.Content != "" {
+				meta.Title = cleanPromptTitle(step.Content)
+				titleSet = true
+			}
 			if meta.StartedAt == "" && step.CreatedAt != "" {
 				meta.StartedAt = step.CreatedAt
 			}
@@ -108,6 +306,19 @@ func (a Adapter) Summarize(path string) (model.SessionMeta, error) {
 			}
 		}
 	})
+
+	if meta.Cwd == "" {
+		if home, err := os.UserHomeDir(); err == nil && home != "" {
+			meta.Cwd = home
+		}
+	}
+
+	brainDir := filepath.Dir(filepath.Dir(filepath.Dir(filepath.Dir(path))))
+	childIDs := getChildIDs(brainDir)
+	if childIDs[id] || meta.UserTurns == 0 {
+		meta.Auxiliary = true
+	}
+
 	return meta, nil
 }
 
@@ -131,12 +342,22 @@ func (a Adapter) Parse(path string) (*model.Trace, error) {
 		Marks:  []model.Mark{},
 	}
 
+	var titleSet bool
+
 	adapter.ReadJSONLines(f, func(data []byte) {
 		var step Step
 		if json.Unmarshal(data, &step) != nil {
 			return
 		}
 
+		if trace.Session.Cwd == "" {
+			trace.Session.Cwd = step.GetWorkspace()
+		}
+		if !titleSet && step.Source == "USER_EXPLICIT" && step.Type == "USER_INPUT" && step.Content != "" {
+			trace.Session.Title = cleanPromptTitle(step.Content)
+			titleSet = true
+		}
+
 		if trace.Session.StartedAt == "" && step.CreatedAt != "" {
 			trace.Session.StartedAt = step.CreatedAt
 		}
@@ -184,6 +405,12 @@ func (a Adapter) Parse(path string) (*model.Trace, error) {
 		}
 	})
 
+	if trace.Session.Cwd == "" {
+		if home, err := os.UserHomeDir(); err == nil && home != "" {
+			trace.Session.Cwd = home
+		}
+	}
+
 	for i := range trace.Events {
 		trace.Events[i].Seq = i
 	}

package/internal/adapter/opencode/adapter.go

@@ -0,0 +1,304 @@
+package opencode
+
+import (
+	"database/sql"
+	"encoding/json"
+	"os"
+	"path/filepath"
+	"sort"
+	"time"
+
+	"github.com/hybridlabor-api/bdb-synapse/internal/adapter"
+	"github.com/hybridlabor-api/bdb-synapse/internal/model"
+	_ "modernc.org/sqlite"
+)
+
+type Adapter struct {
+	Dir string
+}
+
+func DefaultDir() string {
+	home, err := os.UserHomeDir()
+	if err != nil {
+		return ""
+	}
+	return filepath.Join(home, ".local", "share", "opencode")
+}
+
+func (a Adapter) Harness() string { return "opencode" }
+
+func (a Adapter) SessionDir() string {
+	if a.Dir != "" {
+		return a.Dir
+	}
+	return DefaultDir()
+}
+
+func (a Adapter) dbPath() string {
+	return filepath.Join(a.SessionDir(), "opencode.db")
+}
+
+func (a Adapter) openDB() (*sql.DB, error) {
+	dbPath := a.dbPath()
+	if _, err := os.Stat(dbPath); err != nil {
+		return nil, err
+	}
+	return sql.Open("sqlite", "file:"+dbPath+"?mode=ro")
+}
+
+func (a Adapter) ListSessions() ([]model.SessionMeta, error) {
+	db, err := a.openDB()
+	if err != nil {
+		return nil, nil
+	}
+	defer db.Close()
+
+	rows, err := db.Query(`
+		SELECT id, title, directory, parent_id, time_created, time_updated
+		FROM session
+		ORDER BY time_updated DESC
+	`)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	var metas []model.SessionMeta
+	for rows.Next() {
+		var (
+			id          string
+			title       string
+			directory   string
+			parentID    sql.NullString
+			timeCreated int64
+			timeUpdated int64
+		)
+		if err := rows.Scan(&id, &title, &directory, &parentID, &timeCreated, &timeUpdated); err != nil {
+			continue
+		}
+
+		startedAt := time.UnixMilli(timeCreated).UTC().Format(time.RFC3339)
+		endedAt := time.UnixMilli(timeUpdated).UTC().Format(time.RFC3339)
+		sessionPath := filepath.Join(a.SessionDir(), id)
+
+		meta := model.SessionMeta{
+			Key:       adapter.SessionKey(a.Harness(), sessionPath),
+			ID:        id,
+			Harness:   "opencode",
+			Path:      sessionPath,
+			Title:     title,
+			Cwd:       directory,
+			StartedAt: startedAt,
+			EndedAt:   endedAt,
+		}
+
+		if parentID.Valid && parentID.String != "" {
+			meta.Auxiliary = true
+		}
+
+		var eventCount, userTurns int
+		_ = db.QueryRow(`
+			SELECT 
+				COUNT(CASE WHEN data LIKE '%"type":"tool"%' THEN 1 END),
+				COUNT(CASE WHEN data LIKE '%"type":"text"%' THEN 1 END)
+			FROM part 
+			WHERE session_id = ?
+		`, id).Scan(&eventCount, &userTurns)
+
+		meta.EventCount = eventCount
+		meta.UserTurns = userTurns
+
+		metas = append(metas, meta)
+	}
+
+	sort.Slice(metas, func(i, j int) bool {
+		return metas[i].EndedAt > metas[j].EndedAt
+	})
+	return metas, nil
+}
+
+func (a Adapter) SummaryInputs(path string) []string {
+	return []string{a.dbPath()}
+}
+
+func (a Adapter) Summarize(path string) (model.SessionMeta, error) {
+	id := filepath.Base(path)
+	db, err := a.openDB()
+	if err != nil {
+		return model.SessionMeta{}, err
+	}
+	defer db.Close()
+
+	var (
+		title       string
+		directory   string
+		parentID    sql.NullString
+		timeCreated int64
+		timeUpdated int64
+	)
+	err = db.QueryRow(`
+		SELECT title, directory, parent_id, time_created, time_updated
+		FROM session
+		WHERE id = ?
+	`, id).Scan(&title, &directory, &parentID, &timeCreated, &timeUpdated)
+	if err != nil {
+		return model.SessionMeta{}, err
+	}
+
+	startedAt := time.UnixMilli(timeCreated).UTC().Format(time.RFC3339)
+	endedAt := time.UnixMilli(timeUpdated).UTC().Format(time.RFC3339)
+
+	meta := model.SessionMeta{
+		Key:       adapter.SessionKey(a.Harness(), path),
+		ID:        id,
+		Harness:   "opencode",
+		Path:      path,
+		Title:     title,
+		Cwd:       directory,
+		StartedAt: startedAt,
+		EndedAt:   endedAt,
+	}
+
+	if parentID.Valid && parentID.String != "" {
+		meta.Auxiliary = true
+	}
+
+	var eventCount, userTurns int
+	_ = db.QueryRow(`
+		SELECT 
+			COUNT(CASE WHEN data LIKE '%"type":"tool"%' THEN 1 END),
+			COUNT(CASE WHEN data LIKE '%"type":"text"%' THEN 1 END)
+		FROM part 
+		WHERE session_id = ?
+	`, id).Scan(&eventCount, &userTurns)
+
+	meta.EventCount = eventCount
+	meta.UserTurns = userTurns
+	return meta, nil
+}
+
+type toolPart struct {
+	Type   string `json:"type"`
+	Tool   string `json:"tool"`
+	CallID string `json:"callID"`
+	State  struct {
+		Status string         `json:"status"`
+		Input  map[string]any `json:"input"`
+		Output any            `json:"output"`
+	} `json:"state"`
+	Title string `json:"title"`
+	Time  struct {
+		Start int64 `json:"start"`
+		End   int64 `json:"end"`
+	} `json:"time"`
+}
+
+type textPart struct {
+	Type string `json:"type"`
+	Text string `json:"text"`
+}
+
+func (a Adapter) Parse(path string) (*model.Trace, error) {
+	id := filepath.Base(path)
+	db, err := a.openDB()
+	if err != nil {
+		return nil, err
+	}
+	defer db.Close()
+
+	var (
+		title       string
+		directory   string
+		timeCreated int64
+		timeUpdated int64
+	)
+	err = db.QueryRow(`
+		SELECT title, directory, time_created, time_updated
+		FROM session
+		WHERE id = ?
+	`, id).Scan(&title, &directory, &timeCreated, &timeUpdated)
+	if err != nil {
+		return nil, err
+	}
+
+	startedAt := time.UnixMilli(timeCreated).UTC().Format(time.RFC3339)
+	endedAt := time.UnixMilli(timeUpdated).UTC().Format(time.RFC3339)
+
+	trace := &model.Trace{
+		Version: 1,
+		Session: model.TraceSession{
+			ID:        id,
+			Harness:   "opencode",
+			Path:      path,
+			Title:     title,
+			Cwd:       directory,
+			StartedAt: startedAt,
+			EndedAt:   endedAt,
+		},
+		Events: []model.Event{},
+		Marks:  []model.Mark{},
+	}
+
+	rows, err := db.Query(`
+		SELECT data, time_created
+		FROM part
+		WHERE session_id = ?
+		ORDER BY time_created ASC, id ASC
+	`, id)
+	if err != nil {
+		return trace, nil
+	}
+	defer rows.Close()
+
+	for rows.Next() {
+		var rawData string
+		var partTime int64
+		if err := rows.Scan(&rawData, &partTime); err != nil {
+			continue
+		}
+
+		var tp toolPart
+		if err := json.Unmarshal([]byte(rawData), &tp); err == nil && tp.Type == "tool" {
+			ts := time.UnixMilli(partTime).UTC().Format(time.RFC3339)
+			call := adapter.ToolCall{
+				ID:        tp.CallID,
+				Name:      tp.Tool,
+				Input:     tp.State.Input,
+				Timestamp: ts,
+			}
+			outStr := ""
+			if s, ok := tp.State.Output.(string); ok {
+				outStr = s
+			} else if tp.State.Output != nil {
+				b, _ := json.Marshal(tp.State.Output)
+				outStr = string(b)
+			}
+			result := adapter.ToolResult{
+				Content:      outStr,
+				OutcomeKnown: tp.State.Status != "",
+				IsError:      tp.State.Status == "error",
+			}
+			event := adapter.BuildEvent(trace, call, result)
+			trace.Events = append(trace.Events, event)
+			continue
+		}
+
+		var txt textPart
+		if err := json.Unmarshal([]byte(rawData), &txt); err == nil && txt.Type == "text" && txt.Text != "" {
+			if !adapter.InjectedUserMessage(txt.Text) {
+				trace.Marks = append(trace.Marks, model.Mark{
+					Seq:  len(trace.Events),
+					Type: "user-message",
+					Note: adapter.UserMessageNote(txt.Text),
+				})
+			}
+		}
+	}
+
+	for i := range trace.Events {
+		trace.Events[i].Seq = i
+	}
+	trace.Session.EventCount = len(trace.Events)
+	trace.Stats = model.ComputeStats(trace, 0, model.ObservabilityExact)
+	return trace, nil
+}