@gamaze/hicortex 0.12.0 → 0.13.0

package/dist/lessons-context.js

@@ -23,30 +23,27 @@
  * CC session, and a broken /context fetch must never blank the whole output.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.titleCaseSection = titleCaseSection;
+exports.orderSectionNames = orderSectionNames;
+exports.renderContextBlock = renderContextBlock;
+exports.gateAndRenderContext = gateAndRenderContext;
 exports.fetchLessonsContext = fetchLessonsContext;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-const node_os_1 = require("node:os");
+const context_store_js_1 = require("./context-store.js");
 const features_js_1 = require("./features.js");
 const extensions_js_1 = require("./extensions.js");
 const state_js_1 = require("./state.js");
+const paths_js_1 = require("./paths.js");
 const DEFAULT_PORT = 8787;
 /** Harness name this hook injects for — used to self-gate on GET /context `clients`. */
 const THIS_HARNESS = "cc";
-/**
- * Resolve the Hicortex home. Honors HICORTEX_HOME (matches the HICORTEX_DB_PATH
- * env convention in db.ts) so headless/scratch installs can point elsewhere;
- * defaults to ~/.hicortex. Resolved per-call so tests and env changes apply.
- */
-function hicortexHome() {
-    return process.env.HICORTEX_HOME ?? (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
-}
 /**
  * Read ~/.hicortex/config.json and resolve the server URL + auth token, or
  * null when there is no usable config (server not set up yet — fail soft).
  */
 function resolveConfig() {
-    const home = hicortexHome();
+    const home = (0, paths_js_1.hicortexHome)();
     let config;
     try {
         config = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(home, "config.json"), "utf-8"));
@@ -58,7 +55,13 @@ function resolveConfig() {
     const serverUrl = config.mode === "client" && typeof config.serverUrl === "string"
         ? config.serverUrl.replace(/\/+$/, "")
         : `http://127.0.0.1:${config.port ?? DEFAULT_PORT}`;
-    return { serverUrl, authToken: config.authToken, home };
+    // Per-agent context id (0.13) via the shared resolver, so the id sent here
+    // always matches what `hicortex status` reports. No configured agentName →
+    // agentId null → NO ?agent= (bare fetch): CC's default is the shared global
+    // context. A configured agentName that sanitizes to null → agentId null too
+    // (NO ?agent=), never a 400 that the fail-soft hook would silently swallow.
+    const agentName = (0, context_store_js_1.resolveAgentIdentity)(config).agentId;
+    return { serverUrl, authToken: config.authToken, home, agentName };
 }
 function authHeaders(authToken) {
     return authToken ? { "Authorization": `Bearer ${authToken}` } : {};
@@ -120,6 +123,8 @@ async function fetchLessonsBlock(cfg) {
 /**
  * Title-case a section name for its heading: split on `-`/`_`, capitalize each
  * word ("user" → "User", "my_notes" → "My Notes").
+ * Exported so the OC plugin (index.ts) renders the `## Context` block
+ * identically to the CC hook rather than duplicating the logic.
  */
 function titleCaseSection(name) {
     return name
@@ -132,7 +137,7 @@ function titleCaseSection(name) {
  * Stable section ordering: `user` first, then `rules` (the seeded primary
  * sections, spec §8), then every other section alphabetically. Server-side
  * enumeration order (readdirSync) is FS-dependent, so we sort here for a
- * deterministic injection block.
+ * deterministic injection block. Exported for reuse by the OC plugin.
  */
 function orderSectionNames(names) {
     const primaries = ["user", "rules"].filter((p) => names.includes(p));
@@ -140,23 +145,13 @@ function orderSectionNames(names) {
     return [...primaries, ...rest];
 }
 /**
- * Fetch /context and build the `## Context` block, or null when nothing should
- * be injected: non-2xx, this harness not in `clients`, no sections, or all
- * sections empty. Throws propagate to the caller's fail-soft catch.
+ * Render the `## Context` block from a resolved section map, or null when there
+ * is nothing to inject (no sections, or every section blank after trimming).
+ * Pure — no gating, no I/O. Shared verbatim by the CC hook and the OC plugin so
+ * both harnesses emit an identical block. Sections are ordered (user, rules,
+ * then alphabetical) and rendered under title-cased `###` headings.
  */
-async function fetchContextBlock(cfg) {
-    const resp = await fetch(`${cfg.serverUrl}/context`, {
-        headers: authHeaders(cfg.authToken),
-        signal: AbortSignal.timeout(3000),
-    });
-    if (!resp.ok)
-        return null;
-    const data = await resp.json();
-    // Self-gate: only inject when this harness is in the server-resolved list.
-    const clients = Array.isArray(data.clients) ? data.clients : [];
-    if (!clients.includes(THIS_HARNESS))
-        return null;
-    const sections = data.sections;
+function renderContextBlock(sections) {
     if (!sections || typeof sections !== "object" || Array.isArray(sections))
         return null;
     const names = orderSectionNames(Object.keys(sections));
@@ -171,6 +166,62 @@ async function fetchContextBlock(cfg) {
         return null;
     return ["## Context", "", ...bodyParts].join("\n");
 }
+/**
+ * Gate a GET /context response and render the `## Context` block, or null when
+ * nothing should be injected: `harness` not in the server-resolved `clients`,
+ * an empty/blank section set, or — when `requireAgentEcho` — a response that
+ * does not echo `agent`. The SINGLE gate used by both CC and OC so the two can
+ * never drift (the Python Hermes plugin `provider.py::_context_block` mirrors
+ * this logic — keep them in sync).
+ *
+ * `requireAgentEcho` is the old-server guard, and it is the CALLER's decision:
+ *   - OC passes `agentId !== null` — when it actually sent an id, a 0.12 server
+ *     that ignores `?agent=` (200 global, no echo) must NOT leak global context
+ *     into every persona; on a bare fetch (no id) the guard is off (amendment
+ *     A2).
+ *   - CC passes `false` ALWAYS and deliberately (see the call site): a thin CC
+ *     client auto-upgrades via npx BEFORE bedrock does, so during the upgrade
+ *     window it talks to a 0.12 server that cannot hold ANY per-agent config —
+ *     global IS the operator's intended state there, and a guard would instead
+ *     blank ALL context for every CC session in that window.
+ */
+function gateAndRenderContext(data, harness, opts) {
+    if (!data || typeof data !== "object")
+        return null;
+    const clients = Array.isArray(data.clients) ? data.clients : [];
+    if (!clients.includes(harness))
+        return null;
+    if (opts.requireAgentEcho && typeof data.agent !== "string")
+        return null;
+    return renderContextBlock(data.sections ?? {});
+}
+/**
+ * Fetch /context and build the `## Context` block, or null when nothing should
+ * be injected: non-2xx, this harness not in `clients`, no sections, or all
+ * sections empty. Throws propagate to the caller's fail-soft catch.
+ */
+async function fetchContextBlock(cfg) {
+    // Send ?agent= only when we have a valid id; the server does the merge and
+    // returns the resolved sections, so the hook stays dumb (no client-side mode
+    // logic). A null id (CC's default: no configured agentName, or a configured
+    // value that sanitizes to nothing) → bare /context → the shared global set.
+    const url = cfg.agentName
+        ? `${cfg.serverUrl}/context?agent=${encodeURIComponent(cfg.agentName)}`
+        : `${cfg.serverUrl}/context`;
+    const resp = await fetch(url, {
+        headers: authHeaders(cfg.authToken),
+        signal: AbortSignal.timeout(3000),
+    });
+    if (!resp.ok)
+        return null;
+    const data = await resp.json();
+    // CC deliberately passes requireAgentEcho: false (NOT the OC/Hermes old-server
+    // guard). A thin CC client auto-upgrades via npx BEFORE bedrock does, so
+    // mid-upgrade it may hit a 0.12 server that returns global context with no
+    // `agent` echo — and a 0.12 server cannot hold per-agent config, so global is
+    // the intended state. Guarding here would blank ALL CC context in that window.
+    return gateAndRenderContext(data, THIS_HARNESS, { requireAgentEcho: false });
+}
 /**
  * Fetch context + lessons concurrently and return the combined Markdown block,
  * or null when neither yields anything (nothing to inject; caller prints

package/dist/mcp-server.js

@@ -81,6 +81,10 @@ let stateDir = "";
 // Resolved contextClients list (spec §2) — the harness names allowed to inject
 // the standing context layer. Echoed by GET /context so each hook self-gates.
 let contextClients = ["cc"];
+// Resolved contextAgents map (0.13) — agent id → mode (override/global/off).
+// Read once at boot (like contextClients); the drop-in-a-dir presence path is
+// per-request, so only explicit config entries need a daemon restart to apply.
+let contextAgents = {};
 // Cache detectChunkSize results keyed by "<provider>/<model>@<baseUrl>" so we
 // probe each endpoint once per server boot rather than once per /distill request.
 const chunkSizeCache = new Map();
@@ -122,7 +126,7 @@ function createMcpServer() {
         if (!db)
             return { content: [{ type: "text", text: "Hicortex not initialized" }], isError: true };
         try {
-            const results = retrieval.searchContext(db, { project, limit });
+            const results = retrieval.searchRecent(db, { project, limit });
             return { content: [{ type: "text", text: formatResults(results) }] };
         }
         catch (err) {
@@ -436,6 +440,16 @@ async function startServer(options = {}) {
         console.warn(`[hicortex] Ignoring unknown contextClients: ${resolvedClients.dropped.join(", ")} ` +
             `(known: cc, hermes, oc)`);
     }
+    // Per-agent context (0.13): resolve the config-declared modes. Warn once per
+    // boot on dropped entries (bad key or bad mode) so typos surface. NOTE: this
+    // map is boot-time; editing contextAgents needs a daemon restart. Dropping an
+    // agents/<id> dir onto disk takes effect immediately (per-request presence).
+    const resolvedAgents = (0, context_store_js_1.resolveContextAgents)(savedConfig?.contextAgents);
+    contextAgents = resolvedAgents.agents;
+    if (resolvedAgents.dropped.length > 0) {
+        console.warn(`[hicortex] Ignoring invalid contextAgents entries: ${resolvedAgents.dropped.join(", ")} ` +
+            `(keys must match ^[a-z0-9][a-z0-9_-]*$; modes must be override|global|off)`);
+    }
     // Express app
     const app = (0, express_1.default)();
     // Raise the body limit — whole-session denoised transcripts exceed the 100 kB default.
@@ -593,7 +607,7 @@ async function startServer(options = {}) {
             ? req.query.privacy.split(",").map((s) => s.trim()).filter(Boolean)
             : undefined;
         try {
-            const results = retrieval.searchContext(db, { project, limit, privacy });
+            const results = retrieval.searchRecent(db, { project, limit, privacy });
             res.json({ results });
         }
         catch (err) {
@@ -620,7 +634,7 @@ async function startServer(options = {}) {
     // which the tests exercise directly — no mirror-app drift.
     app.get("/context", (req, res) => {
         try {
-            const r = (0, context_store_js_1.handleContextGet)((0, node_path_1.join)(stateDir, "context"), contextClients, req.query);
+            const r = (0, context_store_js_1.handleContextGet)((0, node_path_1.join)(stateDir, "context"), contextClients, req.query, contextAgents);
             res.status(r.status).json(r.body);
         }
         catch (err) {
@@ -629,7 +643,7 @@ async function startServer(options = {}) {
     });
     app.put("/context", (req, res) => {
         try {
-            const r = (0, context_store_js_1.handleContextPut)((0, node_path_1.join)(stateDir, "context"), req.body);
+            const r = (0, context_store_js_1.handleContextPut)((0, node_path_1.join)(stateDir, "context"), req.body, req.query, contextAgents);
             if (r.warn)
                 console.warn(`[hicortex] ${r.warn}`);
             res.status(r.status).json(r.body);

package/dist/nightly-status.js

@@ -11,13 +11,14 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.showNightlyStatus = showNightlyStatus;
+const paths_js_1 = require("./paths.js");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const node_os_1 = require("node:os");
 const node_child_process_1 = require("node:child_process");
 const db_js_1 = require("./db.js");
 const state_js_1 = require("./state.js");
-const HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const HICORTEX_HOME = (0, paths_js_1.hicortexHome)();
 const CONFIG_PATH = (0, node_path_1.join)(HICORTEX_HOME, "config.json");
 async function showNightlyStatus() {
     console.log("Hicortex Nightly Pipeline Status");

package/dist/nightly.js

@@ -46,9 +46,9 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runNightly = runNightly;
+const paths_js_1 = require("./paths.js");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-const node_os_1 = require("node:os");
 let VERSION = "0.0.0";
 try {
     VERSION = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, "..", "package.json"), "utf-8")).version;
@@ -69,7 +69,7 @@ const oc_transcript_reader_js_1 = require("./oc-transcript-reader.js");
 const features_js_1 = require("./features.js");
 const state_js_1 = require("./state.js");
 const telemetry_js_1 = require("./telemetry.js");
-const HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const HICORTEX_HOME = (0, paths_js_1.hicortexHome)();
 function readNightlyConfig(stateDir) {
     try {
         const configPath = (0, node_path_1.join)(stateDir, "config.json");

package/dist/paths.d.ts

@@ -0,0 +1 @@
+export declare function hicortexHome(): string;

package/dist/paths.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hicortexHome = hicortexHome;
+/**
+ * Canonical Hicortex home resolution — the single source of truth (#174).
+ *
+ * Honors the HICORTEX_HOME env override (a headless/test seam, mirroring the
+ * HICORTEX_DB_PATH convention in db.ts); otherwise defaults to ~/.hicortex.
+ * Every module that needs the home dir routes through here, so the override
+ * behaves consistently across all commands instead of being honored by some
+ * (context-cli, lessons-context) and hardcoded away by others.
+ */
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+function hicortexHome() {
+    return process.env.HICORTEX_HOME ?? (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+}

package/dist/relink.js

@@ -74,14 +74,14 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getStoredEmbedding = getStoredEmbedding;
 exports.runRelink = runRelink;
+const paths_js_1 = require("./paths.js");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-const node_os_1 = require("node:os");
 const db_js_1 = require("./db.js");
 const storage = __importStar(require("./storage.js"));
 const consolidate_js_1 = require("./consolidate.js");
 const state_js_1 = require("./state.js");
-const HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const HICORTEX_HOME = (0, paths_js_1.hicortexHome)();
 function readConfig(stateDir) {
     try {
         return JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(stateDir, "config.json"), "utf-8"));

package/dist/retrieval.d.ts

@@ -55,7 +55,7 @@ export declare function retrieve(db: Database.Database, embedFn: EmbedFn, query:
 /**
  * Get recent context, optionally filtered by project and privacy.
  */
-export declare function searchContext(db: Database.Database, options?: {
+export declare function searchRecent(db: Database.Database, options?: {
     project?: string | null;
     limit?: number;
     privacy?: string[];

package/dist/retrieval.js

@@ -52,7 +52,7 @@ exports.l2ToCosine = l2ToCosine;
 exports.effectiveStrength = effectiveStrength;
 exports.computeScore = computeScore;
 exports.retrieve = retrieve;
-exports.searchContext = searchContext;
+exports.searchRecent = searchRecent;
 const storage = __importStar(require("./storage.js"));
 const BASE_DECAY = 0.0005;
 /**
@@ -315,7 +315,7 @@ async function retrieve(db, embedFn, query, options) {
 /**
  * Get recent context, optionally filtered by project and privacy.
  */
-function searchContext(db, options) {
+function searchRecent(db, options) {
     const limit = options?.limit ?? 10;
     const project = options?.project;
     const privacy = options?.privacy;

package/dist/state.js

@@ -23,10 +23,10 @@ exports.saveState = saveState;
 exports.updateState = updateState;
 exports.migrateLegacyState = migrateLegacyState;
 exports.describeLastNightly = describeLastNightly;
+const paths_js_1 = require("./paths.js");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-const node_os_1 = require("node:os");
-const HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const HICORTEX_HOME = (0, paths_js_1.hicortexHome)();
 const STATE_FILE = "state.json";
 /**
  * Load the state file. Returns an empty state if the file is missing

package/dist/status.d.ts

@@ -1,4 +1,13 @@
 /**
  * Hicortex status — show current configuration and stats.
  */
+/**
+ * The value shown after "Agent name:" in `hicortex status` (#179, A3). Reports
+ * EXACTLY what the CC hook resolves (shared `resolveAgentIdentity`), so the
+ * operator never keys `contextAgents`/`agents/<id>/` on an id the install does
+ * not actually send. Unset → the install sends no `?agent=` and shares the
+ * global context (CC default). A configured-but-unsanitizable value is called
+ * out as invalid (the hook sends none) rather than silently accepted.
+ */
+export declare function statusAgentLine(config: Record<string, unknown>): string;
 export declare function runStatus(): Promise<void>;

package/dist/status.js

@@ -3,7 +3,9 @@
  * Hicortex status — show current configuration and stats.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.statusAgentLine = statusAgentLine;
 exports.runStatus = runStatus;
+const paths_js_1 = require("./paths.js");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const node_os_1 = require("node:os");
@@ -11,9 +13,29 @@ const node_child_process_1 = require("node:child_process");
 const db_js_1 = require("./db.js");
 const features_js_1 = require("./features.js");
 const state_js_1 = require("./state.js");
-const HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const context_store_js_1 = require("./context-store.js");
+const HICORTEX_HOME = (0, paths_js_1.hicortexHome)();
 const CC_SETTINGS = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "settings.json");
 const OC_CONFIG = (0, node_path_1.join)((0, node_os_1.homedir)(), ".openclaw", "openclaw.json");
+/**
+ * The value shown after "Agent name:" in `hicortex status` (#179, A3). Reports
+ * EXACTLY what the CC hook resolves (shared `resolveAgentIdentity`), so the
+ * operator never keys `contextAgents`/`agents/<id>/` on an id the install does
+ * not actually send. Unset → the install sends no `?agent=` and shares the
+ * global context (CC default). A configured-but-unsanitizable value is called
+ * out as invalid (the hook sends none) rather than silently accepted.
+ */
+function statusAgentLine(config) {
+    const id = (0, context_store_js_1.resolveAgentIdentity)(config);
+    switch (id.source) {
+        case "configured":
+            return id.agentId;
+        case "invalid-config":
+            return `(invalid configured value "${id.rawConfigured}" — fix config.agentName; hook sends none)`;
+        default: // unset
+            return "(not set — global context)";
+    }
+}
 async function runStatus() {
     console.log("Hicortex Status");
     console.log("─".repeat(40));
@@ -41,11 +63,12 @@ async function runStatus() {
     let licenseKey = "";
     let savedAuthToken = "";
     let isClientMode = false;
+    let parsedConfig = {};
     try {
-        const config = JSON.parse((0, node_fs_1.readFileSync)(configPath, "utf-8"));
-        licenseKey = config.licenseKey ?? "";
-        savedAuthToken = config.authToken ?? "";
-        isClientMode = config.mode === "client";
+        parsedConfig = JSON.parse((0, node_fs_1.readFileSync)(configPath, "utf-8"));
+        licenseKey = parsedConfig.licenseKey ?? "";
+        savedAuthToken = parsedConfig.authToken ?? "";
+        isClientMode = parsedConfig.mode === "client";
     }
     catch { /* no config */ }
     const validated = (0, features_js_1.getValidatedLicense)();
@@ -64,6 +87,9 @@ async function runStatus() {
     else if (!isClientMode && !savedAuthToken) {
         console.log(`Auth token:   not configured (run: npx @gamaze/hicortex init)`);
     }
+    // Per-agent context id (#179) — the id this install sends as ?agent= and the
+    // key operators use for contextAgents / agents/<id>/ dirs.
+    console.log(`Agent name:   ${statusAgentLine(parsedConfig)}`);
     console.log();
     // Adapters
     console.log("Adapters:");

package/dist/uninstall.js

@@ -5,13 +5,14 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runUninstall = runUninstall;
+const paths_js_1 = require("./paths.js");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const node_os_1 = require("node:os");
 const node_child_process_1 = require("node:child_process");
 const node_readline_1 = require("node:readline");
 const claude_md_js_1 = require("./claude-md.js");
-const HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const HICORTEX_HOME = (0, paths_js_1.hicortexHome)();
 const CC_SETTINGS = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "settings.json");
 const CC_COMMANDS_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "commands");
 const CLAUDE_MD = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "CLAUDE.md");

package/hermes-plugin/hicortex/README.md

@@ -14,11 +14,24 @@ Gives [Hermes](https://github.com/nousresearch/hermes-agent) agents self-learnin
 |---|---|---|
 | `prefetch(query)` | recall relevant memories before each turn | `GET /search` |
 | `queue_prefetch(query)` | background recall for the next turn | `GET /search` |
-| `system_prompt_block()` | inject distilled lessons + memory index | `GET /lessons` |
+| `system_prompt_block()` | inject per-agent standing context + distilled lessons + memory index | `GET /context`, `GET /lessons` |
 | `get_tool_schemas()` | exposes the 8 unified tools | see tool table below |
 
 That's the whole surface. No `sync_turn`, no compaction/session-end capture — those are intentionally absent.
 
+### Per-agent standing context (0.13)
+
+`system_prompt_block()` also injects the hand-edited **standing context layer** (`## Context`, above the lessons block) — "who you are + how to work", distinct from episodic memory. The server resolves it **per agent**: this profile's own sections override the global set (`override`), or it can be `global` or `off`. See the main repo's `/context` layer docs.
+
+The plugin sends its **profile name** as `?agent=`, resolved in this order:
+
+1. `agent_name` in the plugin config (explicit override);
+2. the `HERMES_PROFILE` environment variable;
+3. a `HERMES_HOME` ending in `profiles/<name>` (the per-profile install path);
+4. none → the global context (backward compatible).
+
+Leave `agent_name` blank to auto-derive (2–4). Context injection needs a Hicortex server **≥ 0.13**; against an older server the plugin detects the missing per-agent support and injects no context (lessons are unaffected). Context and lessons fail soft independently — a context failure never costs the lessons block.
+
 ### Tools (unified 8)
 
 | Tool | REST call | Description |
@@ -57,7 +70,7 @@ hermes memory setup   # select "hicortex", enter the server URL/token when promp
 
 Run it once per profile if you use Hermes profiles. Hermes allows **one** external memory provider at a time, so disable Honcho (or any other) first, then restart the gateway.
 
-Config fields (`hicortex_url`, `default_project`, `recall_limit`, `privacy_filter`) can also be written to `$HERMES_HOME/plugins/hicortex/config.json` directly. The auth token is a **secret** — set it via env, not the JSON file:
+Config fields (`hicortex_url`, `default_project`, `recall_limit`, `privacy_filter`, `agent_name`) can also be written to `$HERMES_HOME/plugins/hicortex/config.json` directly. `agent_name` pins the per-agent context id for this profile (leave blank to auto-derive — see [Per-agent standing context](#per-agent-standing-context-013)). The auth token is a **secret** — set it via env, not the JSON file:
 
 ```bash
 export HICORTEX_AUTH_TOKEN=hctx-default-token   # or your custom token

package/hermes-plugin/hicortex/client.py

@@ -96,6 +96,13 @@ class HicortexClient:
     def lessons(self) -> dict[str, Any]:
         return self._get("/lessons")
 
+    def context(self, agent: Optional[str] = None) -> dict[str, Any]:
+        """Standing context layer (L2). When ``agent`` is set, the server
+        resolves the per-agent scope and echoes ``agent``/``mode`` (0.13); a
+        pre-0.13 server ignores the param and returns the global set with no
+        echo — the caller uses that echo as an old-server guard."""
+        return self._get("/context", {"agent": agent})
+
     def index(self) -> dict[str, Any]:
         return self._get("/index")
 

package/hermes-plugin/hicortex/config.py

@@ -57,6 +57,16 @@ CONFIG_SCHEMA: list[dict[str, Any]] = [
         "default": "WORK,PERSONAL",
         "required": False,
     },
+    {
+        "key": "agent_name",
+        "label": "Agent name (per-agent context)",
+        "description": (
+            "Identity sent as ?agent= when fetching the standing context layer, "
+            "so this profile gets its own context (0.13). Leave blank to "
+            "auto-derive from the running profile (HERMES_PROFILE / HERMES_HOME)."
+        ),
+        "required": False,
+    },
     # NOTE: recall-only plugin — no capture config. Capture is handled by the
     # nightly server-side reader of each agent's session store.
 ]

package/hermes-plugin/hicortex/plugin.yaml

@@ -1,6 +1,6 @@
 name: hicortex
-version: 0.5.0
-description: "Self-learning memory for Hermes agents — every session is distilled into lessons overnight, and your agent wakes up wiser. Injects fresh lessons each turn and exposes the full 8-tool memory surface (search, recent, ingest, lessons, index, graph, update, delete) via a shared Hicortex server. Stdlib-only."
+version: 0.6.0
+description: "Self-learning memory for Hermes agents — every session is distilled into lessons overnight, and your agent wakes up wiser. Injects fresh lessons each turn plus a per-agent standing context block, and exposes the full 8-tool memory surface (search, recent, ingest, lessons, index, graph, update, delete) via a shared Hicortex server. Stdlib-only."
 pip_dependencies: []
 hooks: []
 requires_env: