Walk the graph from one entity

curl --request GET \
  --url http://127.0.0.1:4319/memory/entities/related

import requests

url = "http://127.0.0.1:4319/memory/entities/related"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('http://127.0.0.1:4319/memory/entities/related', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "http://127.0.0.1:4319/memory/entities/related"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "4319",
  CURLOPT_URL => "http://127.0.0.1:4319/memory/entities/related",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

require 'uri'
require 'net/http'

url = URI("http://127.0.0.1:4319/memory/entities/related")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

HttpResponse<String> response = Unirest.get("http://127.0.0.1:4319/memory/entities/related")
  .asString();

using RestSharp;


var options = new RestClientOptions("http://127.0.0.1:4319/memory/entities/related");
var client = new RestClient(options);
var request = new RestRequest("");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

{
  "entity": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "PostgreSQL",
    "entityType": "technology",
    "mentions": 123,
    "memories": 123,
    "documents": 123,
    "aliases": [
      "Opus 4.8"
    ]
  },
  "matchedAlias": "Bob",
  "related": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "memloom",
      "entityType": "project",
      "mentions": 123,
      "aliases": [
        "<string>"
      ],
      "links": [
        {
          "relation": "works_on",
          "confidence": 123
        }
      ],
      "sharedSources": 123
    }
  ],
  "truncated": 123
}

Schema & entities

Walk the graph from one entity

Everything connected to one entity. The target may be an id, a name, or a spelling that was folded away; an alias resolves to its canonical entity and matchedAlias reports which spelling was asked for.

Two kinds of connection come back separately and are never blended into one score. Stated links are typed predicate edges extraction asserted, with their direction from the asked-about end. Co-mention is entities named by the same sources, which is weaker evidence and never outranks a stated link.

The target is matched exactly, not by meaning. This is a graph lookup, not a search.

GET

memory

entities

Walk the graph from one entity

curl --request GET \
  --url http://127.0.0.1:4319/memory/entities/related

import requests

url = "http://127.0.0.1:4319/memory/entities/related"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('http://127.0.0.1:4319/memory/entities/related', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "http://127.0.0.1:4319/memory/entities/related"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "4319",
  CURLOPT_URL => "http://127.0.0.1:4319/memory/entities/related",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

require 'uri'
require 'net/http'

url = URI("http://127.0.0.1:4319/memory/entities/related")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

HttpResponse<String> response = Unirest.get("http://127.0.0.1:4319/memory/entities/related")
  .asString();

using RestSharp;


var options = new RestClientOptions("http://127.0.0.1:4319/memory/entities/related");
var client = new RestClient(options);
var request = new RestRequest("");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

{
  "entity": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "PostgreSQL",
    "entityType": "technology",
    "mentions": 123,
    "memories": 123,
    "documents": 123,
    "aliases": [
      "Opus 4.8"
    ]
  },
  "matchedAlias": "Bob",
  "related": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "memloom",
      "entityType": "project",
      "mentions": 123,
      "aliases": [
        "<string>"
      ],
      "links": [
        {
          "relation": "works_on",
          "confidence": 123
        }
      ],
      "sharedSources": 123
    }
  ],
  "truncated": 123
}

Query Parameters

string

required

An entity id, name, or known alias.

type

string

Only return neighbours of this entity type.

limit

integer

default:50

Response

The entity and its neighbourhood.

entity

object

An entity with its usage counts.

Hide child attributes

entity.id

string<uuid>

entity.name

string

Example:

"PostgreSQL"

entity.entityType

string

Example:

"technology"

entity.mentions

integer

Active mention edges pointing at this entity.

entity.memories

integer

Distinct active memories that mention it.

entity.documents

integer

Distinct context documents whose chunks mention it.

entity.aliases

string[]

Spellings folded into this entity. Empty when nothing was merged in.

Example:

["Opus 4.8"]

matchedAlias

string | null

The spelling asked for, when it was an alias rather than the entity's name.

Example:

"Bob"

Hide child attributes

Example:

"memloom"

Example:

"project"

Active mention edges pointing at this entity, so you can weigh it.

Stated relationships between the two. Empty means the connection is co-mention only: they turn up in the same memories without the graph asserting how they relate.

Hide child attributes

Example:

"works_on"

out when the asked-about entity is the subject, in when it is the object.

Available options:

out,

in

Distinct memories and chunks that mention both.

truncated

integer

Neighbours beyond limit, so a cut answer never reads as a complete one.

List entities with usage counts Find and fold duplicate entity spellings

⌘I