@cerefox/memory 1.17.1 → 1.17.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENT_GUIDE.md +5 -5
- package/AGENT_QUICK_REFERENCE.md +1 -1
- package/dist/bin/cerefox.js +24 -23
- package/dist/frontend/assets/{index-C5878rMW.js → index-D7YyXio_.js} +27 -27
- package/dist/frontend/assets/{index-C5878rMW.js.map → index-D7YyXio_.js.map} +1 -1
- package/dist/frontend/index.html +1 -1
- package/dist/server-assets/_shared/ef-meta/index.ts +5 -5
- package/dist/server-assets/_shared/embeddings/index.ts +1 -1
- package/dist/server-assets/_shared/embeddings/onnx-embedder.ts +2 -2
- package/dist/server-assets/_shared/ingest/pipeline-helpers.ts +1 -1
- package/dist/server-assets/_shared/mcp-tools/_utils.ts +2 -2
- package/dist/server-assets/_shared/mcp-tools/audit-log.ts +1 -1
- package/dist/server-assets/_shared/mcp-tools/get-help-content.ts +2 -2
- package/dist/server-assets/_shared/mcp-tools/identity.ts +1 -1
- package/dist/server-assets/_shared/mcp-tools/ingest.ts +1 -1
- package/dist/server-assets/_shared/mcp-tools/relations.ts +3 -3
- package/dist/server-assets/_shared/mcp-tools/search.ts +2 -2
- package/dist/server-assets/_shared/partial-edits/index.ts +1 -1
- package/dist/server-assets/db/rpcs.sql +13 -5
- package/dist/server-assets/db/schema.sql +1 -1
- package/dist/server-assets/supabase/functions/cerefox-ingest/index.ts +1 -1
- package/dist/server-assets/supabase/functions/cerefox-mcp/index.ts +1 -1
- package/dist/server-assets/supabase/functions/cerefox-search/index.ts +1 -1
- package/docs/api/openapi.json +10 -3
- package/docs/guides/api.md +4 -4
- package/docs/guides/cli.md +2 -2
- package/docs/guides/configuration.md +5 -5
- package/docs/guides/connect-agents.md +3 -3
- package/docs/guides/ops-scripts.md +3 -3
- package/docs/guides/response-limits.md +3 -3
- package/docs/guides/staging-env.md +2 -2
- package/docs/guides/upgrading.md +2 -2
- package/package.json +1 -1
|
@@ -53,7 +53,7 @@ Three top-level paths plus a few special cases:
|
|
|
53
53
|
> ChatGPT becomes possible on the same server but is not yet documented.)
|
|
54
54
|
|
|
55
55
|
> **Perplexity** supports stdio-only MCP on macOS Desktop (via Helper App). Remote MCP is
|
|
56
|
-
> "coming soon." Perplexity's CTO has
|
|
56
|
+
> "coming soon." Perplexity's CTO has signaled a strategic shift away from MCP (March 2026),
|
|
57
57
|
> so API-based integration may be the long-term path. Not a priority.
|
|
58
58
|
>
|
|
59
59
|
> **Gemini web** (gemini.google.com) does not support custom MCP servers. No integration path.
|
|
@@ -174,7 +174,7 @@ set — as it is for a [staging environment](staging-env.md) — the name become
|
|
|
174
174
|
entry rather than replacing it, and an agent can hold both at once (v1.4.0, #168).
|
|
175
175
|
The command prints the name it used.
|
|
176
176
|
|
|
177
|
-
A
|
|
177
|
+
A labeled entry additionally carries `CEREFOX_CONFIG_DIR` and `CEREFOX_ENV_LABEL`
|
|
178
178
|
in its `env` block. That is what makes it actually reach the environment it is named
|
|
179
179
|
after: MCP clients spawn a stdio server with the **client's** environment, not the
|
|
180
180
|
shell you ran `configure-agent` in, and a desktop client launched from the dock has
|
|
@@ -344,7 +344,7 @@ https://<your-project-ref>.supabase.co/functions/v1/cerefox-mcp
|
|
|
344
344
|
|----------|--------|
|
|
345
345
|
| Default local agent (Claude Code, Cursor, Codex, Gemini, Claude Desktop) | Path A-Local -- preferred; `cerefox configure-agent`, zero Edge Function cost, no token to distribute |
|
|
346
346
|
| Multiple machines / cloud dev environments | Path A-Remote -- one hosted URL works everywhere (needs a Cerefox token) |
|
|
347
|
-
|
|
|
347
|
+
| Minimize Supabase Edge Function usage (free tier limits) | Path A-Local -- zero Edge Function invocations |
|
|
348
348
|
| Offline use or development on the cerefox codebase | Path A-Local -- no network dependency |
|
|
349
349
|
| Lowest latency (same machine, no HTTPS round-trip) | Path A-Local -- slightly faster |
|
|
350
350
|
|
|
@@ -277,7 +277,7 @@ it is off the field is absent from every other surface, and an export is not the
|
|
|
277
277
|
place to resurrect it.
|
|
278
278
|
|
|
279
279
|
Markdown rather than JSON so the sidecars are readable in the same editor as the
|
|
280
|
-
documents. Pass `--no-metadata` for the older content-only
|
|
280
|
+
documents. Pass `--no-metadata` for the older content-only behavior.
|
|
281
281
|
|
|
282
282
|
Two naming details worth knowing:
|
|
283
283
|
|
|
@@ -320,7 +320,7 @@ Two things worth knowing about what it does *not* claim:
|
|
|
320
320
|
|
|
321
321
|
- **Coverage is stated, not implied.** `x-cerefox-coverage` in the document lists
|
|
322
322
|
how many routes carry a response schema, which routes legitimately return
|
|
323
|
-
something other than JSON, and which are
|
|
323
|
+
something other than JSON, and which are unmodeled. An unmodeled route gets
|
|
324
324
|
**no** schema rather than a guessed one.
|
|
325
325
|
- **`info.version` is the API's, not the release's.** It moves when `/api/v1`
|
|
326
326
|
changes. Binding it to the package version made the committed artifact stale at
|
|
@@ -329,7 +329,7 @@ Two things worth knowing about what it does *not* claim:
|
|
|
329
329
|
|
|
330
330
|
## search_benchmark.ts — Search-calibration benchmark
|
|
331
331
|
|
|
332
|
-
Measures how search ranks against a
|
|
332
|
+
Measures how search ranks against a labeled query vocabulary
|
|
333
333
|
(`_shared/search-benchmark/vocabulary/`: a synthetic corpus, about 150 queries
|
|
334
334
|
in 13 categories, variant groups, no-answer queries) and compares alternative
|
|
335
335
|
scoring formulas and settings. It is how the v1.17.0 defaults were chosen. Design
|
|
@@ -19,13 +19,13 @@ raises or lowers it per call with `--max-bytes`.
|
|
|
19
19
|
> **Changed in v0.10.2.** The CLI originally returned everything, like the web UI. It now
|
|
20
20
|
> honours `CEREFOX_MAX_RESPONSE_BYTES` (200 000 default) and prints
|
|
21
21
|
> `(results truncated at N bytes; use --max-bytes to raise)` when results are dropped.
|
|
22
|
-
> This guide described the pre-v0.10.2
|
|
22
|
+
> This guide described the pre-v0.10.2 behavior until v1.14.4.
|
|
23
23
|
|
|
24
24
|
---
|
|
25
25
|
|
|
26
26
|
## How each access path handles response size
|
|
27
27
|
|
|
28
|
-
| Path | Limit
|
|
28
|
+
| Path | Limit behavior |
|
|
29
29
|
|------|----------------|
|
|
30
30
|
| Web UI (`/search`) | **No limit** — all results returned |
|
|
31
31
|
| CLI (`cerefox search`) | Defaults to `CEREFOX_MAX_RESPONSE_BYTES` (200 000); raise or lower per call with `--max-bytes`. Announces truncation. |
|
|
@@ -203,4 +203,4 @@ threshold (it is a SQL DEFAULT in `rpcs.sql`, changed via `cerefox server deploy
|
|
|
203
203
|
| Can an agent exceed the server ceiling? | No — always capped |
|
|
204
204
|
| Where is the ceiling configured? | `.env` for local MCP; TypeScript constant in Edge Functions |
|
|
205
205
|
| How are limits applied? | Whole-document drop; never mid-content truncation |
|
|
206
|
-
| Is truncation
|
|
206
|
+
| Is truncation signaled? | Yes — `truncated: true` in responses |
|
|
@@ -30,7 +30,7 @@ Three things, and the third turned out to matter most:
|
|
|
30
30
|
every legacy document (real spend, rewrites chunks). Proving it on a copy
|
|
31
31
|
first turns an act of faith into a measurement.
|
|
32
32
|
- **Development.** A store you are willing to break is the cheapest way to turn
|
|
33
|
-
a claim about runtime
|
|
33
|
+
a claim about runtime behavior into a measurement. During the 1.1.0 cycle this
|
|
34
34
|
found a retry loop executing 68,825 times per request, a `migrate-format` that
|
|
35
35
|
reported success while converting nothing, and a `backup create` that failed
|
|
36
36
|
against older servers — none visible from the code or the test suite. Keep it
|
|
@@ -276,7 +276,7 @@ read but nothing acts on it.
|
|
|
276
276
|
|
|
277
277
|
| Area | Problem |
|
|
278
278
|
|---|---|
|
|
279
|
-
| **Agent (MCP) config** | Safe since v1.4.0 ([#168](https://github.com/fstamatelopoulos/cerefox/issues/168)). `configure-agent` names the server after `CEREFOX_ENV_LABEL`, so a staging environment registers as **`cerefox-staging`** alongside your production `cerefox` entry rather than replacing it, and an agent can hold both. The
|
|
279
|
+
| **Agent (MCP) config** | Safe since v1.4.0 ([#168](https://github.com/fstamatelopoulos/cerefox/issues/168)). `configure-agent` names the server after `CEREFOX_ENV_LABEL`, so a staging environment registers as **`cerefox-staging`** alongside your production `cerefox` entry rather than replacing it, and an agent can hold both. The labeled entry also carries its own `CEREFOX_CONFIG_DIR` and `CEREFOX_ENV_LABEL` in the config it writes — without that the client would spawn the server with *its own* environment (a GUI client launched from the dock has none), `CEREFOX_CONFIG_DIR` would be absent, and an entry named `cerefox-staging` would quietly serve production. Before v1.4.0 it registered every environment as `cerefox` and running it from staging silently repointed all your agents. |
|
|
280
280
|
| **`doctor`'s `mcp clients` line** | It inspects your global agent configs, which point at production, and reports them even in staging mode. Informative, but easy to misread as "staging is wired to my agents". |
|
|
281
281
|
| **`doctor` remediation commands** | Environment-aware since v1.8.0: in a staging environment the remediations tell you to prefix `CEREFOX_CONFIG_DIR` (or use the alias). Before that, a staging `doctor` printed bare `cerefox …` remediations that act on production. |
|
|
282
282
|
|
package/docs/guides/upgrading.md
CHANGED
|
@@ -66,7 +66,7 @@ schema-requiring release.
|
|
|
66
66
|
> `pending_review`" decision out of the clients and into the
|
|
67
67
|
> `cerefox_ingest_document` RPC (#241). A v1.13.0 client no longer decides
|
|
68
68
|
> the status itself, so against an older server every agent write would
|
|
69
|
-
> silently land `approved` — a
|
|
69
|
+
> silently land `approved` — a behavior change, not a missing feature — and
|
|
70
70
|
> the new review-status search filter would fail outright. The **minimum
|
|
71
71
|
> supported schema is therefore `0.16.0`**: until you run `cerefox server
|
|
72
72
|
> deploy`, `cerefox web` refuses to start and `doctor` says exactly why.
|
|
@@ -84,7 +84,7 @@ schema-requiring release.
|
|
|
84
84
|
> `pending_review` regardless, so turning the workflow back on shows the
|
|
85
85
|
> statuses the store would have had all along. It is an RPC-only change —
|
|
86
86
|
> `cerefox server deploy` (or `--schema-only`) picks it up; nothing refuses
|
|
87
|
-
> to run until you do, but a 0.16.0 server keeps the v1.13.0 write
|
|
87
|
+
> to run until you do, but a 0.16.0 server keeps the v1.13.0 write behavior.
|
|
88
88
|
|
|
89
89
|
> ### Upgrading to v1.1.0 — `cerefox server deploy` is required
|
|
90
90
|
>
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cerefox/memory",
|
|
3
|
-
"version": "1.17.
|
|
3
|
+
"version": "1.17.3",
|
|
4
4
|
"description": "Cerefox \u2014 user-owned shared memory for AI agents. CLI + stdio MCP server + web UI + ingestion for a knowledge base on your own Supabase project (or fully self-hosted with Cerefox Local).",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"homepage": "https://github.com/fstamatelopoulos/cerefox",
|