@smartergpt/lex-mcp 2.8.0 → 2.10.0

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.
Files changed (2) hide show
  1. package/README.md +19 -7
  2. package/package.json +3 -3
package/README.md CHANGED
@@ -4,6 +4,14 @@ Thin MCP stdio wrapper for [@smartergpt/lex](https://github.com/Guffawaffle/lex)
4
4
 
5
5
  Lex owns all capabilities. This package owns delivery over [Model Context Protocol](https://modelcontextprotocol.io/).
6
6
 
7
+ ## Release Contract
8
+
9
+ `@smartergpt/lex-mcp` is a coordinated release of Lex core, not a floating
10
+ compatibility layer. Each wrapper release pins `@smartergpt/lex` to the same
11
+ exact version, reports that version through MCP `serverInfo`, and supports the
12
+ same Node range as Lex (`>=20 <25`). Publish the matching Lex release before
13
+ publishing this wrapper.
14
+
7
15
  ## Quick Start
8
16
 
9
17
  ```bash
@@ -53,16 +61,20 @@ echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | npx @smarter
53
61
 
54
62
  ## Environment Variables
55
63
 
56
- | Variable | Description | Default |
57
- |----------|-------------|---------|
58
- | `LEX_WORKSPACE_ROOT` | Project root directory (compat env var name) | Current directory |
59
- | `LEX_DB_PATH` | SQLite database path (canonical) | `.smartergpt/lex/memory.db` |
60
- | `LEX_MEMORY_DB` | Alias for `LEX_DB_PATH` (compat only) | — |
61
- | `LEX_DEBUG` | Enable debug logging to stderr | Off |
64
+ | Variable | Description | Default |
65
+ | ----------------------- | ------------------------------------------------ | --------------------------- |
66
+ | `LEX_WORKSPACE_ROOT` | Project root directory (compat env var name) | Current directory |
67
+ | `LEX_STORE` | Frame backend (`sqlite` or `postgres`) | `sqlite` |
68
+ | `LEX_DATABASE_URL` | PostgreSQL URL; required for PostgreSQL | — |
69
+ | `LEX_POSTGRES_PASSWORD` | Optional password for a credential-free URL | |
70
+ | `LEX_POSTGRES_POOL_MAX` | Maximum PostgreSQL connection-pool size | `10` |
71
+ | `LEX_DB_PATH` | SQLite database path; ignored by PostgreSQL | `.smartergpt/lex/memory.db` |
72
+ | `LEX_MEMORY_DB` | Alias for `LEX_DB_PATH` (compat only) | — |
73
+ | `LEX_DEBUG` | Enable debug logging to stderr | Off |
62
74
 
63
75
  When both `LEX_DB_PATH` and `LEX_MEMORY_DB` are set, `LEX_DB_PATH` wins.
64
76
 
65
- For multi-root workspaces, set the same absolute `LEX_DB_PATH` for direct Lex, this MCP wrapper, and AXF-routed Lex. The wrapper delegates `.lex.config.json`, environment, and default-store resolution to Lex core, so installed launches now honor caller-project config files. Use `system_introspect` to compare canonical store paths and `path-v1` identities across launch paths.
77
+ For multi-root workspaces using SQLite, set the same absolute `LEX_DB_PATH` for direct Lex, this MCP wrapper, and AXF-routed Lex. For shared cross-host storage, set `LEX_STORE=postgres` and the same `LEX_DATABASE_URL` on every surface; keep credentials in the host environment or secret configuration. The wrapper delegates `.lex.config.json`, environment, and store resolution to Lex core, so installed launches honor caller-project config files. Use `system_introspect` to compare `path-v1` SQLite or credential-free `postgres-v1` identities across launch paths.
66
78
 
67
79
  ## Tools
68
80
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@smartergpt/lex-mcp",
3
- "version": "2.8.0",
3
+ "version": "2.10.0",
4
4
  "description": "MCP server for Lex episodic memory - stdio transport wrapper",
5
5
  "mcpName": "dev.smartergpt/lex",
6
6
  "type": "module",
@@ -22,7 +22,7 @@
22
22
  "link:local": "rm -rf node_modules/@smartergpt/lex && mkdir -p node_modules/@smartergpt && ln -s /srv/lex-mcp/lex node_modules/@smartergpt/lex"
23
23
  },
24
24
  "dependencies": {
25
- "@smartergpt/lex": "^2.8.0"
25
+ "@smartergpt/lex": "2.10.0"
26
26
  },
27
27
  "publishConfig": {
28
28
  "access": "public",
@@ -42,7 +42,7 @@
42
42
  "author": "Guffawaffle",
43
43
  "license": "MIT",
44
44
  "engines": {
45
- "node": ">=18"
45
+ "node": ">=20 <25"
46
46
  },
47
47
  "homepage": "https://github.com/Guffawaffle/lex#readme",
48
48
  "bugs": {