Schema

This section outlines the required data structures for submitting Location Timeline Data, Browser History Contribution Data, and Bookmarks Data to SecondBrainDAO. Each type has specific fields to ensure consistency and validation.

We support:

• Browser History submissions (Multiple CSV files)

• Bookmark submission (single HTML netscape file)

• Location timeline data (single JSON file)

---

Location Timeline Data

Location Timeline Data captures a user's movement and activities over time. Each entry must include the following fields:

Required Fields

• Start Time:

  • An ISO 8601 formatted timestamp (e.g., 2025-03-10T14:30:00Z) marking the start of the recorded activity.

• End Time:

  • An ISO 8601 formatted timestamp (e.g., 2025-03-10T15:00:00Z) marking the end of the recorded activity.

Optional Fields for Location Data

1) Activity

• Probability:

  • A string (e.g., "0.85") representing the likelihood of the activity occurring.

• Start:

  • Geolocation of the activity’s starting point in "geo:latitude,longitude" format (e.g., geo:37.7749,-122.4194).

• End:

  • Geolocation of the activity’s endpoint in "geo:latitude,longitude" format (e.g., geo:37.7859,-122.4364).

2) Top Candidate

• Type:

  • The most probable activity type (e.g., "in passenger vehicle").

• Probability:

  • Likelihood of this activity type (e.g., "0.92").

• Distance Meters:

  • Total distance covered during the activity, in meters (e.g., 1200).

3) Visits

• Hierarchy Level:

  • The hierarchical level of the visit (e.g., a numerical or categorical value).

• Top Candidate:

  • Probability: Likelihood of the visit location (e.g., "0.78").

  • Semantic Type: Category of the location (e.g., "Unknown", "Restaurant").

  • Place ID: Unique identifier for the place (e.g., "ChIJD7fiBh9u5kcRYJSMaMOCCwQ").

  • Place Location: Geolocation in "geo:latitude,longitude" format (e.g., geo:40.7128,-74.0060).

• Probability:

  • Overall likelihood of the visit event (e.g., "0.95").

4) Timeline Paths

• Point:

  • A geolocation point along the path in "geo:latitude,longitude" format (e.g., geo:34.0522,-118.2437).

• Duration Minutes Offset From Start Time:

  • Time elapsed from the start time, in minutes (e.g., 15).

---

Browser History Contribution Data

Browser History Contribution Data records a user’s web browsing activity. Each entry must include:

• DateTime:

  • The timestamp when the webpage was visited (e.g., 2025-03-10T09:15:23Z).

• URL:

  • The web address of the visited page (e.g., https://example.com).

• Title:

  • The title of the webpage (e.g., "Example Domain").

---

Bookmarks Data

Bookmarks Data captures a user’s saved web links. Each bookmark entry must include:

Required Fields

• Name:

  • The name of the bookmark (e.g., "My Favorite Site").

• Add Date:

  • The timestamp when the bookmark was added (e.g., 2025-03-01T12:00:00Z).

Optional Fields for Bookmarks Data

• Last Modified:

  • The timestamp of the last modification (e.g., 2025-03-05T14:20:00Z).

• Personal Toolbar Folder (optional):

  • A boolean (true or false) indicating if the bookmark is in the personal toolbar.

Children (Nested Bookmarks)

If the bookmark contains sub-entries (e.g., in a folder), each child includes:

• Title:

  • The title of the bookmark (e.g., "Subpage").

• URL:

  • The web address of the bookmarked page (e.g., https://example.com/subpage).

• Add Date:

  • The timestamp when the bookmark was added (e.g., 2025-03-02T10:30:00Z).