@pilotoo/memory-protocol

Introduction

@pilotoo/memory-protocol is the contract of Brain: the request and response schemas of the HTTP API, the entity shapes and the definitions of the MCP tools, as zod schemas with their inferred types. The web app and the server both import it, so the two cannot drift. It depends on zod and @pilotoo/chat-protocol only.

Installation

@pilotoo/memory-protocol is at version 0.1.0, is marked private and is not published to a registry. It is also not part of the tarballs that pnpm release:check packs, so today it is used from the kit workspace:

pnpm install
pnpm --filter @pilotoo/memory-protocol build

Inside the workspace, depend on it with "@pilotoo/memory-protocol": "workspace:^". Its build first builds the kit packages it depends on.

Basic usage

The MCP tool definitions are data you can list:

import { MCP_TOOLS } from '@pilotoo/memory-protocol';

for (const tool of MCP_TOOLS) console.log(tool.name);

MCP_TOOLS lists memory_list, memory_search, memory_get, memory_remember, memory_forget and memory_add_source. See Use it from an agent for what each does and HTTP API for the routes.

Entry points

Import	Provides
@pilotoo/memory-protocol	The only entry point: common types, entity schemas, request schemas, the MCP tool definitions and the connector wire types.

Learn more

• Embed it in a host for how the Brain packages fit together.