myagentmemory 0.4.16 → 0.4.17

package/LICENSE

@@ -1,6 +1,7 @@
 MIT License
 
 Copyright (c) 2026 Jay Zeng
+Copyright (c) 2026 jo-inc
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -28,9 +28,18 @@ Coding-agent sessions preserve activity. They do not decide which facts, decisio
 
 AgentMemory is free, open-source software under the MIT License. The core is a local Markdown store with a CLI, optional qmd search, and agent skills, and it remains fully usable without an account or commercial plugin. It does not automatically import every vendor transcript or silently decide what becomes durable. It is not a Python SDK, vector database, or knowledge graph. The Markdown files remain the source of truth.
 
-### Optional official plugins
+### AgentMemory Pro preview
 
-The MIT-licensed core can discover and host separately distributed, signed first-party plugins while remaining fully useful on its own. Optional plugins may use their own license and distribution terms; their implementation and browser assets are not part of the `myagentmemory` package. `agent-memory plugin list` and `plugin status` report local state. In an interactive terminal, `agent-memory plugin install` opens a nonce-bound loopback page for an email address, resumes the waiting command, verifies signed release metadata and the downloaded bundle, and installs atomically. The free plan uses a configurable daily agent-session allowance keyed by normalized email. D1 stores bounded activation metadata, a credential hash, and opaque SessionStart usage operations; it never receives memory, session content, queries, repository paths, raw agent session identifiers, IP addresses, or user-agent strings. Authentication and payment can extend this free activation flow later. See the [official plugin bootstrap and host contract](docs/official-plugin-bootstrap.md).
+**Core remembers what you save. Pro learns from what you do.** Core remains free, MIT-licensed, and useful forever. Pro is a separately distributed commercial bundle that recalls prior coding sessions, finds repeated corrections, and shows what it learned and why in a private local Memory Dashboard.
+
+```bash
+agent-memory pro install
+agent-memory recall "what did we decide about authentication?"
+agent-memory learn
+agent-memory dashboard
+```
+
+The preview requires no account, email, or payment method. It includes 10 useful recalls and one learning scan per local day; local indexing and the Memory Dashboard remain available. Coding history, memories, queries, repository paths, and raw session identifiers stay on the device. Installation sends only a random installation identifier plus bounded compatibility metadata to obtain the signed release. Paying will remove limits; it will not unlock access to the user's own local data. Low-level `agent-memory plugin` commands remain available for administration and scripting. See [how local privacy, signing, installation, and capability enforcement work](docs/official-plugin-bootstrap.md).
 
 ## Installation
 
@@ -149,6 +158,10 @@ The memory directory defaults to `~/.agent-memory/`. Override with `AGENT_MEMORY
 | `agent-memory uninstall-hooks [--only <agents>]` | Remove only hooks managed by AgentMemory |
 | `agent-memory init` | Create dirs, detect qmd, setup collection |
 | `agent-memory status` | Show config, qmd status, file counts |
+| `agent-memory pro <install\|status\|upgrade\|manage>` | Install and manage the no-account AgentMemory Pro preview |
+| `agent-memory recall <query>` | Recall decisions and context from prior coding sessions with Pro |
+| `agent-memory learn` | Find repeated corrections worth remembering with Pro |
+| `agent-memory dashboard` | Open the private local Memory Dashboard |
 | `agent-memory plugin <list\|status\|install\|update\|uninstall\|manage>` | Discover and manage optional signed first-party plugins |
 
 Global flags: `--dir <path>` (override directory), `--json` (machine output)
@@ -284,7 +297,7 @@ agent-memory install-skills
 
 ## Publishing (maintainers)
 
-Publication is tag-driven through `.github/workflows/publish-npm.yml`. Configure `jayzeng/agentmemory` and `publish-npm.yml` as the npm trusted publisher for `myagentmemory`, merge a versioned changelog/package update, and push the matching `v<version>` tag. The workflow uses short-lived OIDC credentials, runs the complete release gate, and publishes the public package with provenance. Do not publish this package from the private plugin workspace.
+Publication is tag-driven through `.github/workflows/publish-npm.yml`. Configure the repository's `NPM_TOKEN` secret with publish access to `myagentmemory`, merge a versioned changelog/package update, and push the matching `v<version>` tag. The workflow runs the complete release gate and publishes the public package. Do not publish this package from the private plugin workspace.
 
 ### Repository assets (maintainers)
 
@@ -294,7 +307,7 @@ Publication is tag-driven through `.github/workflows/publish-npm.yml`. Configure
 
 ## Acknowledgments
 
-Inspired by [skyfallsin/pi-mem](https://github.com/skyfallsin/pi-mem). Semantic search is powered by [qmd](https://github.com/tobi/qmd).
+AgentMemory contains portions adapted from [pi-mem](https://github.com/jo-inc/pi-mem), used under its MIT License; the upstream copyright notice is preserved in [LICENSE](LICENSE). Semantic search is powered by [qmd](https://github.com/tobi/qmd).
 
 ## Changelog
 

package/dist/cli-spec.d.ts

@@ -6,7 +6,7 @@ export interface CliOptionSpec {
         kind: CliValueKind;
     };
 }
-export declare const COMMANDS: readonly ["context", "write", "read", "scratchpad", "search", "distil", "sync", "init", "status", "install-skills", "uninstall-skills", "install-hooks", "uninstall-hooks", "completion", "plugin", "version", "help"];
+export declare const COMMANDS: readonly ["context", "write", "read", "scratchpad", "search", "distil", "sync", "init", "status", "install-skills", "uninstall-skills", "install-hooks", "uninstall-hooks", "completion", "pro", "recall", "learn", "dashboard", "plugin", "version", "help"];
 export declare const PLUGIN_COMMANDS: readonly ["list", "status", "install", "update", "uninstall", "manage"];
 export declare const WORKER_ACTIONS: readonly [];
 export declare const SCRATCHPAD_ACTIONS: readonly ["add", "done", "undo", "clear_done", "list"];

package/dist/cli-spec.js

@@ -13,6 +13,10 @@ export const COMMANDS = [
     "install-hooks",
     "uninstall-hooks",
     "completion",
+    "pro",
+    "recall",
+    "learn",
+    "dashboard",
     "plugin",
     "version",
     "help",
@@ -35,9 +39,13 @@ export const COMMAND_DESCRIPTIONS = {
     "install-hooks": "install automatic SessionStart indexing and context hooks",
     "uninstall-hooks": "remove only SessionStart hooks managed by agent-memory",
     completion: "install or print Bash, Zsh, Fish, or PowerShell completion",
-    plugin: "index, recall, learn from, and evaluate prior agent sessions",
+    pro: "install, inspect, or upgrade AgentMemory Pro",
+    recall: "recall decisions and context from prior coding sessions with Pro",
+    learn: "find repeated corrections worth remembering with Pro",
+    dashboard: "open the private local Memory Dashboard",
+    plugin: "discover, install, update, or remove optional official plugins",
     version: "print the installed agent-memory version",
-    help: "show top-level, command, or nested plugin help",
+    help: "show this command overview",
 };
 export const PLUGIN_COMMAND_DESCRIPTIONS = {
     list: "list optional official plugins and local availability",
@@ -71,6 +79,10 @@ export const COMMAND_OPTIONS = {
     "install-hooks": ["--yes", "--all", "--only"],
     "uninstall-hooks": ["--only"],
     completion: ["--stdout"],
+    pro: [],
+    recall: ["--scope", "--cwd", "--limit", "--context"],
+    learn: [],
+    dashboard: ["--no-browser"],
     version: [],
     help: [],
 };

package/dist/cli.js

@@ -23,6 +23,7 @@
  */
 import { spawn } from "node:child_process";
 import * as fs from "node:fs";
+import { COMMAND_DESCRIPTIONS, COMMANDS } from "./cli-spec.js";
 import { detectCompletionShell, generateCompletion, installCompletion } from "./completions.js";
 import { _setBaseDir, buildMemoryContext, checkCollection, dailyPath, detectQmd, distilMemories, ensureDirs, ensureQmdAvailableForSync, ensureQmdAvailableForUpdate, getCollectionName, getDailyDir, getMemoryDir, getMemoryFile, getQmdEmbedMode, getQmdHealth, getQmdResultPath, getQmdResultText, getScratchpadFile, getTopicsDir, installSkills, memoryWrite, nowTimestamp, parseScratchpad, probeEmbeddings, readFileSafe, redactSecrets, runQmdEmbedDetached, runQmdSearch, runQmdSync, runQmdUpdateNow, scheduleQmdUpdate, searchRelevantMemories, serializeScratchpad, setupQmdCollection, slugifyTopic, todayStr, topicPath, uninstallSkills, } from "./core.js";
 import { detectHookAgents, installHooks, uninstallHooks } from "./hooks.js";
@@ -120,22 +121,24 @@ function openExternalUrl(url) {
 }
 function printProOverview(installed) {
     console.log("");
-    console.log("AgentMemory Pro includes:");
-    console.log("  Session Intelligence  Recall decisions and context across Pi, Codex, and Claude Code sessions.");
-    console.log("  Guided Learning       Turn repeated corrections into reviewable, reversible memory.");
-    console.log("  Local Web Console     Inspect memories, activity, health, and settings in your browser.");
+    console.log("Core remembers what you save. Pro learns from what you do.");
     console.log("");
-    console.log("Your session content stays on this device.");
+    console.log("AgentMemory Pro:");
+    console.log("  Recall coding history       Find decisions and context across Pi, Codex, and Claude Code sessions.");
+    console.log("  Learn from corrections      Turn repeated fixes into reviewable, reversible memory.");
+    console.log("  See and control learning    Inspect what AgentMemory remembers and why in the Memory Dashboard.");
+    console.log("");
+    console.log("No account is required for the free preview. Your coding history stays on this device.");
     console.log("");
     if (installed) {
         console.log("Try it:");
         console.log('  agent-memory recall "what did we decide about authentication?"');
         console.log("  agent-memory learn");
-        console.log("  agent-memory web");
+        console.log("  agent-memory dashboard");
     }
     else {
-        console.log("Start your Pro beta:");
-        console.log("  agent-memory plugin install");
+        console.log("Start your free Pro preview:");
+        console.log("  agent-memory pro install");
     }
 }
 function printPluginResult(result, json, allowBrowser) {
@@ -175,10 +178,10 @@ function printPluginResult(result, json, allowBrowser) {
                 break;
             case "not_installed":
                 console.log("AgentMemory Pro is not installed.");
-                console.log("Run: agent-memory plugin install");
+                console.log("Run: agent-memory pro install");
                 break;
             case "auth_required":
-                console.log("Run this command in an interactive terminal to enter an email and activate free daily access.");
+                console.log("Run agent-memory pro install to activate the free preview.");
                 break;
             case "renewal_required":
                 console.log("Renew AgentMemory Pro to continue using paid capabilities.");
@@ -214,9 +217,23 @@ async function cmdContext(flags) {
     if (!noSearch && query)
         await ensureQmdAvailableForSync();
     const searchResults = noSearch ? "" : await searchRelevantMemories(query);
-    const context = buildMemoryContext(searchResults);
+    const coreContext = buildMemoryContext(searchResults);
+    let pluginSections = [];
+    try {
+        pluginSections = await new InstalledPluginRuntimeV1({ coreVersion: VERSION }).provideContext({
+            host: "agent-memory-cli",
+            cwd: process.cwd(),
+            query: query || undefined,
+            signal: new AbortController().signal,
+        });
+    }
+    catch {
+        // Optional Pro context must never make public-core context unavailable.
+    }
+    const pluginContext = pluginSections.map((section) => `${section.label}\n\n${section.content}`).join("\n\n");
+    const context = [coreContext, pluginContext].filter(Boolean).join("\n\n");
     if (json) {
-        output({ context, directory: getMemoryDir() }, true);
+        output({ context, directory: getMemoryDir(), ...(pluginSections.length ? { pluginSections } : {}) }, true);
     }
     else {
         if (context) {
@@ -709,8 +726,8 @@ async function cmdInit(flags) {
                 const plugin = await createDefaultPluginBootstrap(VERSION).list();
                 if (plugin.result === "not_installed") {
                     console.log("");
-                    console.log("Optional: AgentMemory Pro adds session recall and a local Web Console.");
-                    console.log("Run: agent-memory plugin install");
+                    console.log("Optional: Pro recalls coding history and learns from repeated corrections.");
+                    console.log("Try it without an account: agent-memory pro install");
                 }
             }
             catch {
@@ -853,8 +870,8 @@ async function cmdStatus(flags) {
         }
         if (!officialPlugin.installed) {
             console.log("");
-            console.log("Optional official plugins: not installed");
-            console.log("  run: agent-memory plugin install");
+            console.log("AgentMemory Pro: not installed");
+            console.log("  try without an account: agent-memory pro install");
         }
     }
 }
@@ -892,9 +909,10 @@ Usage:
   agent-memory plugin uninstall --yes
   agent-memory plugin manage [--no-browser]
 
-The public core remains fully usable without AgentMemory Pro. Interactive install
-opens a loopback website for email activation and a configurable free daily
-agent-session allowance. Memory and session content stay on this device.`);
+The public core remains fully usable without AgentMemory Pro. Install uses a random
+installation identifier and requires no account or email. The free preview includes
+10 recalls and one learning scan per local day; indexing and the Memory Dashboard
+remain available. Memory and session content stay on this device.`);
 }
 function pluginCommandFailure(command, error) {
     return {
@@ -922,12 +940,13 @@ async function cmdPlugin(flags, positional) {
     const subcommand = positional[0] ?? "list";
     if (subcommand === "help" || hasFlag(flags, "help")) {
         printPluginUsage();
-        return;
+        return null;
     }
     const channel = getFlag(flags, "channel") ?? "stable";
     if (channel !== "stable") {
-        printPluginResult(pluginCommandFailure(subcommand, new PluginBootstrapFailure("channel_invalid", "--channel supports only 'stable'")), json, false);
-        return;
+        const failure = pluginCommandFailure(subcommand, new PluginBootstrapFailure("channel_invalid", "--channel supports only 'stable'"));
+        printPluginResult(failure, json, false);
+        return failure;
     }
     const allowBrowser = !json && !hasFlag(flags, "no-browser") && Boolean(process.stdin.isTTY && process.stdout.isTTY);
     const manager = createDefaultPluginBootstrap(VERSION);
@@ -974,33 +993,73 @@ async function cmdPlugin(flags, positional) {
         result = pluginCommandFailure(subcommand, error);
     }
     printPluginResult(result, json, allowBrowser && (subcommand === "install" || subcommand === "manage"));
+    return result;
+}
+async function printFirstRunProof() {
+    try {
+        const result = await new InstalledPluginRuntimeV1({ coreVersion: VERSION }).run("index", {
+            args: [],
+            flags: {},
+            signal: new AbortController().signal,
+        });
+        if (!result?.ok || !result.data || typeof result.data !== "object")
+            return;
+        const stats = result.data.stats;
+        if (!stats?.discovered)
+            return;
+        const hosts = [
+            ["Claude Code", stats.discovered.claude ?? 0],
+            ["Codex", stats.discovered.codex ?? 0],
+            ["Pi", stats.discovered.pi ?? 0],
+        ];
+        console.log("");
+        console.log("Found local coding history:");
+        for (const [label, count] of hosts)
+            console.log(`  ${label.padEnd(13)} ${count} sessions`);
+        console.log("");
+        console.log(`${stats.selected ?? 0} sessions available for local recall. Nothing was uploaded.`);
+        console.log("");
+        console.log('Try: agent-memory recall "what did we decide about authentication?"');
+        console.log("Open: agent-memory dashboard");
+    }
+    catch {
+        // Personalized proof is helpful but must never turn a successful install into a failure.
+    }
+}
+async function cmdPro(flags, positional) {
+    const subcommand = positional[0];
+    if (!subcommand) {
+        await cmdPlugin(flags, ["list"]);
+        return;
+    }
+    const mapped = subcommand === "upgrade" ? "update" : subcommand;
+    if (!["install", "status", "update", "manage"].includes(mapped)) {
+        const json = hasFlag(flags, "json");
+        const message = `Unknown Pro command: ${subcommand}. Available commands: install, status, upgrade, manage.`;
+        if (json)
+            console.log(JSON.stringify({ error: message }));
+        else
+            console.error(`Error: ${message}`);
+        process.exitCode = 1;
+        return;
+    }
+    const result = await cmdPlugin(flags, [mapped]);
+    if (!hasFlag(flags, "json") && mapped === "install" && ["installed", "upgraded"].includes(result?.result ?? ""))
+        await printFirstRunProof();
 }
 // ---------------------------------------------------------------------------
 // Usage
 // ---------------------------------------------------------------------------
 function printUsage() {
+    const commandWidth = Math.max(...COMMANDS.map((command) => command.length));
+    const commandList = COMMANDS.map((command) => `  ${command.padEnd(commandWidth)}  ${COMMAND_DESCRIPTIONS[command]}`).join("\n");
     console.log(`agent-memory — persistent memory for coding agents
 
 Usage:
   agent-memory <command> [options]
 
 Commands:
-  version     Show binary version
-  install-skills  Install (or --uninstall) bundled skills
-  uninstall-skills  Uninstall bundled skills
-  context     Build context; optionally retrieve memories with --query
-  write       Write to memory files (default: daily; optional --source-uri)
-  read        Read memory files
-  scratchpad  Manage checklist items
-  search      Search across memory files (requires qmd)
-  distil      Generate compact MEMORY.md index from daily logs + topics
-  sync        Re-index and embed all files (requires qmd)
-  init        Initialize memory directory and qmd collection
-  status      Show configuration and status (--probe for a live embeddings check)
-  completion  Install or print shell completion
-  install-hooks  Install managed SessionStart hooks
-  uninstall-hooks  Remove only managed SessionStart hooks
-  plugin      Discover, install, update, or remove optional official plugins
+${commandList}
 
 Global flags:
   --dir <path>   Override memory directory
@@ -1026,8 +1085,10 @@ Examples:
   agent-memory status --json
   agent-memory completion zsh
   agent-memory install-hooks --yes
-  agent-memory plugin status
-  agent-memory plugin install`);
+  agent-memory pro status
+  agent-memory pro install
+  agent-memory recall "what did we decide about authentication?"
+  agent-memory dashboard`);
 }
 // ---------------------------------------------------------------------------
 // Main
@@ -1116,12 +1177,16 @@ async function main() {
         case "plugin":
             await cmdPlugin(flags, positional);
             break;
+        case "pro":
+            await cmdPro(flags, positional);
+            break;
         default: {
             const controller = new AbortController();
             const abort = () => controller.abort();
             process.once("SIGINT", abort);
             try {
-                const result = await new InstalledPluginRuntimeV1({ coreVersion: VERSION }).run(command, {
+                const pluginCommand = command === "dashboard" ? "web" : command;
+                const result = await new InstalledPluginRuntimeV1({ coreVersion: VERSION }).run(pluginCommand, {
                     args: positional,
                     flags,
                     signal: controller.signal,
@@ -1129,7 +1194,7 @@ async function main() {
                 if (!result)
                     exitError(`Unknown command: ${command}. Run 'agent-memory help' for usage.`, json);
                 if (!result.ok)
-                    exitError(result.error?.message ?? `Plugin command ${command} failed`, json);
+                    exitError(result.error?.message ?? `Plugin command ${pluginCommand} failed`, json);
                 output(result.data ?? { ok: true }, json);
             }
             finally {

package/dist/plugin-bootstrap.js

@@ -14,8 +14,8 @@ const MISSING_ENTITLEMENT = {
     reason: "No signed AgentMemory commercial entitlement is installed",
 };
 const OFFICIAL_PLUGINS = [
-    { id: OFFICIAL_PLUGIN_IDS[0], name: "Session Intelligence" },
-    { id: OFFICIAL_PLUGIN_IDS[1], name: "Web Console" },
+    { id: OFFICIAL_PLUGIN_IDS[0], name: "Coding History Recall" },
+    { id: OFFICIAL_PLUGIN_IDS[1], name: "Memory Dashboard" },
 ];
 const PACKAGE_MAX_BYTES = 64 * 1024 * 1024;
 const PACKAGE_MAX_EXPANDED_BYTES = 128 * 1024 * 1024;

package/dist/plugin-host.d.ts

@@ -103,11 +103,29 @@ export interface PluginStructuredErrorV1 {
     message: string;
     retryable?: boolean;
 }
+export interface PluginContextSectionV1 {
+    id: string;
+    label: string;
+    content: string;
+    artifactPath?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface PluginContextProviderV1 {
+    name: string;
+    requiredCapability: string;
+    provide(context: {
+        host: string;
+        cwd?: string;
+        query?: string;
+        signal: AbortSignal;
+    }): Promise<PluginContextSectionV1[]>;
+}
 export interface AgentMemoryPluginHostV1 {
     apiVersion: 1;
     coreVersion: string;
     registerCommand(command: PluginCommandV1): void;
     registerSessionStartHook(hook: PluginSessionStartHookV1): void;
+    registerContextProvider?(provider: PluginContextProviderV1): void;
     getStateDirectory(): string;
     getMemoryDirectory(): string;
     getEntitlement(): Promise<PluginEntitlementStatusV1>;

package/dist/plugin-runtime.d.ts

@@ -1,5 +1,5 @@
 import { type PluginBootstrapBackendV1, type PluginInstallStoreV1, type PluginSessionUsageDecisionV1, type SignedPluginReleaseV1 } from "./plugin-bootstrap.js";
-import { type PluginCommandContextV1, type PluginCommandResultV1, type PluginSessionStartHookV1 } from "./plugin-host.js";
+import { type PluginCommandContextV1, type PluginCommandResultV1, type PluginContextSectionV1, type PluginSessionStartHookV1 } from "./plugin-host.js";
 export interface PluginRuntimeOptionsV1 {
     coreVersion: string;
     store?: PluginInstallStoreV1;
@@ -11,11 +11,18 @@ export declare class InstalledPluginRuntimeV1 {
     private readonly backend;
     private readonly commands;
     private readonly hooks;
+    private readonly contextProviders;
     private loaded;
     constructor(options: PluginRuntimeOptionsV1);
     load(): Promise<boolean>;
     run(name: string, context: PluginCommandContextV1): Promise<PluginCommandResultV1 | null>;
     runSessionStart(context: Parameters<PluginSessionStartHookV1["run"]>[0]): Promise<PluginSessionUsageDecisionV1 | null>;
+    provideContext(context: {
+        host: string;
+        cwd?: string;
+        query?: string;
+        signal: AbortSignal;
+    }): Promise<PluginContextSectionV1[]>;
     private createHost;
     private refreshEntitlement;
 }

package/dist/plugin-runtime.js

@@ -61,6 +61,7 @@ export class InstalledPluginRuntimeV1 {
     backend;
     commands = new Map();
     hooks = [];
+    contextProviders = [];
     loaded = false;
     constructor(options) {
         this.options = options;
@@ -132,6 +133,37 @@ export class InstalledPluginRuntimeV1 {
             throw error;
         }
     }
+    async provideContext(context) {
+        if (!(await this.load()) || this.contextProviders.length === 0)
+            return [];
+        const entitlement = await this.refreshEntitlement();
+        const sections = [];
+        for (const registered of this.contextProviders) {
+            if (!isPluginCapabilityEnabled(entitlement, registered.provider.requiredCapability))
+                continue;
+            const provided = await registered.provider.provide(context);
+            if (!Array.isArray(provided) || provided.length > 16)
+                throw new PluginBootstrapFailure("plugin_context_invalid", `Plugin ${registered.pluginId} returned invalid context sections`);
+            for (const section of provided) {
+                if (!section ||
+                    typeof section.id !== "string" ||
+                    section.id.length === 0 ||
+                    section.id.length > 256 ||
+                    typeof section.label !== "string" ||
+                    section.label.length === 0 ||
+                    section.label.length > 256 ||
+                    typeof section.content !== "string" ||
+                    Buffer.byteLength(section.content, "utf-8") > 64 * 1024 ||
+                    (section.artifactPath !== undefined &&
+                        (typeof section.artifactPath !== "string" || section.artifactPath.length > 4_096)) ||
+                    (section.metadata !== undefined &&
+                        (!section.metadata || typeof section.metadata !== "object" || Array.isArray(section.metadata))))
+                    throw new PluginBootstrapFailure("plugin_context_invalid", `Plugin ${registered.pluginId} returned an invalid context section`);
+                sections.push(structuredClone(section));
+            }
+        }
+        return sections;
+    }
     createHost(manifest) {
         const descriptors = new Map(manifest.commands.map((command) => [command.name, command]));
         const stateRoot = path.join(this.store.root, "state");
@@ -165,6 +197,13 @@ export class InstalledPluginRuntimeV1 {
                     throw new PluginBootstrapFailure("plugin_hook_invalid", `Plugin ${manifest.id} registered a hook with an undeclared capability`);
                 this.hooks.push(hook);
             },
+            registerContextProvider: (provider) => {
+                if (!(manifest.capabilities ?? []).includes(provider.requiredCapability))
+                    throw new PluginBootstrapFailure("plugin_context_invalid", `Plugin ${manifest.id} registered a context provider with an undeclared capability`);
+                if (!provider.name || this.contextProviders.some((item) => item.provider.name === provider.name))
+                    throw new PluginBootstrapFailure("plugin_context_invalid", `Plugin context provider ${provider.name || "(unnamed)"} is invalid or already registered`);
+                this.contextProviders.push({ provider, pluginId: manifest.id });
+            },
             getStateDirectory: () => stateDirectory,
             getMemoryDirectory: () => {
                 assertPermission(manifest, "memory:read");