@hasna/mementos 0.14.88 → 0.16.0

package/README.md

@@ -1,9 +1,8 @@
 # @hasna/mementos
 
 Persistent memory for AI agents, available as a CLI, MCP server, REST service,
-and TypeScript library. Mementos stores memories in local SQLite by default and
-can route clients to a self-hosted PostgreSQL-backed service over an authenticated
-HTTP API.
+and TypeScript library. Hosted clients use the authenticated Mementos HTTP API;
+local SQLite is available only through an explicit local-mode opt-in.
 
 [![npm](https://img.shields.io/npm/v/@hasna/mementos)](https://www.npmjs.com/package/@hasna/mementos)
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
@@ -24,14 +23,15 @@ The package installs three binaries:
 | --- | --- |
 | `mementos` | Memory, agent, project, graph, session, and maintenance CLI |
 | `mementos-mcp` | MCP server; Streamable HTTP by default, stdio on request |
-| `mementos-serve` | REST API and dashboard server |
+| `mementos-serve` | REST API server |
 
 ## Quick start
 
-Local mode needs no service or database configuration. The first command creates
+Local mode must be selected explicitly. The first command after the opt-in creates
 and migrates `~/.hasna/mementos/mementos.db`.
 
 ```bash
+export HASNA_MEMENTOS_LOCAL=1
 mementos save project-stack "Bun, TypeScript, SQLite" \
   --scope shared --category fact
 mementos recall project-stack
@@ -51,6 +51,28 @@ Memory scopes are `global`, `shared`, `private`, and `working`. `working` is
 transient session scratch space and defaults to a one-hour lifetime. Categories
 are `preference`, `fact`, `knowledge`, `history`, `procedural`, and `resource`.
 
+For CLI `context` and `inject`, an explicit `--project` must resolve to a registered
+project and restricts every included scope to that exact project. SDK
+`getContext({ project_id })` uses the same exact-project rule. Unknown explicit
+projects fail before memories are selected or touched; omitting the project keeps
+the existing scope selection.
+
+The library and MCP injection strategies retain unassigned agent-private context
+alongside the selected project's private memories. They exclude private memories
+assigned to another project. Their existing global/shared policies remain:
+library strategies include global memories across projects and project-scoped
+shared memories; direct MCP injection also scopes global memories to the project,
+while its full smart pipeline uses the library policy.
+
+Injection project references may be a stable project ID, registered name, or
+registered path. Library, MCP, and HTTP/SDK injection resolve that reference once
+and use the stable project ID for every downstream profile, search, filter, hook,
+and touch path.
+
+The list API and SDK expose `include_unassigned_project: true` with `project_id`
+for this union. The filter applies before pagination and also governs `total`;
+without a project it has no effect. Omitting it keeps an exact project match.
+
 ## CLI
 
 ```bash
@@ -60,13 +82,28 @@ mementos <command> --help
 
 Human-readable list and search commands are compact and paginated by default.
 Use `--limit` with `--cursor` or `--offset`, `--verbose` for wider snippets, and
-`mementos show <id>` for a full record. Use global `--json` or a supported
-`--format json|csv|yaml` option for structured output.
+`mementos show <id>` for a full record.
+
+Historical `--json` and `--format json` collection reads remain compatible:
+they emit full bare arrays and, without `--limit`, traverse the complete result.
+Use explicit `--agent-json` when a token-bounded page receipt is wanted. Agent
+JSON defaults to 20 compact list rows or 10 compact history rows, includes
+`_meta.next_cursor`, and has a 32 KiB byte budget. `--full`, `--all`, and
+`--max-bytes` are receipt-mode controls and require `--agent-json`; exhaustive
+mode fails closed above 5,000 rows or 1 MiB.
+
+Agent JSON uses offset pagination. Stable ID tie-breakers prevent overlap for
+equal timestamps and importance while the result set is unchanged; writes
+between page requests can shift offsets, so restart traversal when a stable
+snapshot is required.
 
 ```bash
-mementos list --limit 20 --cursor 20
+mementos list --json                         # compatible full bare array
+mementos list --agent-json                   # bounded receipt page
+mementos list --agent-json --cursor 20
+mementos list --agent-json --full --limit 5
+mementos history --agent-json --all
 mementos search "deploy" --verbose
-mementos --json list
 mementos storage mode --json
 ```
 
@@ -95,11 +132,19 @@ mementos-mcp --stdio
 Cursor, Codex, Claude, and other command-based MCP host entries should use
 `command = "mementos-mcp"` with `args = ["--stdio"]`.
 
-The server exposes its live tools plus `mementos://memories`,
-`mementos://agents`, and `mementos://projects`. MCP `tools/list` is the complete
-schema source; the convenience `search_tools` and `describe_tools` calls cover
-the smaller registered utility discovery catalog. See the [MCP
-reference](docs/MCP.md) for installation examples and the full tool inventory.
+The default `core` MCP profile exposes a bounded 23-tool agent surface. Select
+additional comma-separated profiles with `--mcp-profile`,
+`HASNA_MEMENTOS_MCP_PROFILE`, or the compatibility alias
+`MEMENTOS_MCP_PROFILE`: `search`, `graph`, `automation`, `admin`, `storage`,
+`hooks`, and `full`. The explicit `full` profile preserves all 124 tools and the
+legacy unpaged `mementos://memories`, `mementos://agents`, and
+`mementos://projects` resources; reduced profiles omit those resources and use
+bounded list/get tools instead.
+
+MCP `tools/list` remains the authoritative schema source. `search_tools` returns
+a bounded names-only page for active-profile tools, and `describe_tools`
+requires one to ten explicit names. See the [MCP reference](docs/MCP.md) for
+profile membership and compatibility details.
 
 ## REST API
 
@@ -123,17 +168,26 @@ API routes use bearer/API-key authentication when configured. See the
 
 ## Storage
 
-### Local clients
+### Client storage selection
 
-SQLite is authoritative by default. Database selection order is:
+The hosted Mementos API is the ordinary client default. The CLI, MCP server,
+and SDK resolve the hosted credential and authority chain described below; if
+no hosted credential resolves, client data commands fail closed rather than
+opening or creating SQLite automatically.
 
-1. `HASNA_MEMENTOS_DB_PATH` or `MEMENTOS_DB_PATH`.
-2. The nearest existing `.mementos/mementos.db` walking up from the current directory.
-3. Git-root `.mementos/mementos.db` when `MEMENTOS_DB_SCOPE=project`.
-4. `~/.hasna/mementos/mementos.db`.
+SQLite is available only through an explicit local opt-in:
 
-Legacy `~/.mementos` data is copied to `~/.hasna/mementos` when the new directory
-does not yet exist.
+```bash
+# Use the standard local data root (~/.hasna/mementos/mementos.db).
+export HASNA_MEMENTOS_LOCAL=1
+
+# Or select one exact SQLite file explicitly.
+export HASNA_MEMENTOS_DB_PATH=/absolute/path/to/mementos.db
+```
+
+`MEMENTOS_LOCAL=1` and `MEMENTOS_DB_PATH` are compatibility aliases. Legacy
+`~/.mementos` data is considered for migration only after local mode has been
+selected explicitly; it is never an automatic client fallback.
 
 ### Server backend and HTTP clients
 
@@ -152,11 +206,47 @@ HASNA_MEMENTOS_API_URL=https://mementos.example.com
 HASNA_MEMENTOS_API_KEY=...
 ```
 
-Both API variables must be present to select the HTTP client transport, and
-exactly one of them set is an error naming the missing variable.
+### Hosted clients — one credential chain
+
+The CLI, the MCP server and the `./sdk` client resolve their credential and
+service authority through the ONE resolver in `@hasna/contracts`
+(`@hasna/contracts/client`), fresh on every call so a key rotation heals a
+long-lived shell or MCP server without a restart:
+
+| Tier | Source |
+| --- | --- |
+| 1 | explicit arguments (`--api-key` / `--profile`, or `baseUrl` / `apiKey` in the SDK) |
+| 2 | deliberate env pointer: `HASNA_MEMENTOS_API_KEY_OVERRIDE`, `HASNA_PROFILE`, `HASNA_MEMENTOS_API_KEY_REF` (a secrets-vault item key, never a value) |
+| 3 | macOS Keychain: generic password `hasna.credentials.mementos.api-key`, account `HASNA_STATION` → `hostname -s` → `USER` |
+| 4 | disk: `~/.hasna/mementos/config/credentials`, owner-only `0400`/`0600` (`HASNA_HOME` / `HASNA_CONFIG_HOME` move the root) |
+| 5 | environment: `HASNA_MEMENTOS_API_KEY` |
+
+The authority follows `HASNA_MEMENTOS_API_URL`, the Keychain `api-url` item,
+the credentials file, and finally the fleet gateway
+`https://api.hasna.com/mementos` — a credential ALONE is a complete
+configuration. The legacy unprefixed `MEMENTOS_API_URL` / `MEMENTOS_API_KEY`
+spellings survive only as the resolver's silent alias fallback for one
+release. Writing a key to the disk tier:
+
+```bash
+mkdir -p ~/.hasna/mementos/config
+printf 'HASNA_MEMENTOS_API_KEY=%s\n' "$KEY" > ~/.hasna/mementos/config/credentials
+chmod 600 ~/.hasna/mementos/config/credentials
+```
+
+FAIL LOUD (owner ruling 2026-09-04): a hosted run with no credential anywhere
+exits non-zero naming every tier it consulted; there is no SQLite fallback and
+no local-fallback event. The on-box SQLite store is reachable ONLY through the
+deliberate opt-ins `HASNA_MEMENTOS_DB_PATH` / `MEMENTOS_DB_PATH` (an explicit
+file) or `HASNA_MEMENTOS_LOCAL=1` (alias `MEMENTOS_LOCAL=1`, honoured only when
+nothing configures an authority) — and every local run prints one line saying
+it is local on stderr. Retired locations (`~/.hasna/fleet-env/`,
+`~/.hasna/cloud/`, `~/.config/hasna/`, `$XDG_CONFIG_HOME`) and retired
+`*_MODE` / `*_STORAGE_MODE` variables are inputs nowhere.
+
 `mementos storage mode` reports the chosen transport without opening a
-database or making a network request. Any retired storage-mode variable
-(`HASNA_MEMENTOS_STORAGE_MODE` or an alias) is an error: delete it.
+database or making a network request; `mementos status` prints the resolved
+`API:` line (hasna/apps#1588).
 
 The old `storage push`, `pull`, and `sync` commands remain for compatibility;
 they are not the cutover architecture. See [Configuration and
@@ -165,10 +255,9 @@ storage](docs/CONFIGURATION.md) and the [cloud cutover runbook](docs/CUTOVER-RUN
 ## TypeScript APIs
 
 The main package exports the synchronous database/domain API from
-`@hasna/mementos` and an authenticated fetch client from `@hasna/mementos/sdk`.
-The repository also contains the separately published zero-dependency
-`@hasna/mementos-sdk` client. See [Library and SDK APIs](docs/LIBRARY.md) and
-the [standalone SDK README](sdk/README.md).
+`@hasna/mementos` and an authenticated fetch client from `@hasna/mementos/sdk`
+— one package carries every surface (CLI, MCP server, REST server, SDK); there
+is no separate `-sdk` or `-mcp` package. See [Library and SDK APIs](docs/LIBRARY.md).
 
 ## Shared event webhooks
 

package/bun.lock

@@ -8,9 +8,8 @@
         "@ai-sdk/anthropic": "^3.0.82",
         "@ai-sdk/openai": "^3.0.69",
         "@ai-sdk/openai-compatible": "^2.0.48",
-        "@hasna/contracts": "0.10.6",
+        "@hasna/contracts": "1.0.2",
         "@hasna/events": "0.1.6",
-        "@hasna/paths": "0.1.0",
         "@modelcontextprotocol/sdk": "^1.12.1",
         "ai": "^6.0.199",
         "chalk": "^5.4.1",
@@ -23,7 +22,7 @@
         "zod": "^3.24.2",
       },
       "devDependencies": {
-        "@types/bun": "^1.2.4",
+        "@types/bun": "1.3.14",
         "@types/pg": "^8.11.11",
         "@types/react": "^18.3.18",
         "bun-types": "1.3.14",
@@ -47,52 +46,12 @@
 
     "@alcalzone/ansi-tokenize": ["@alcalzone/ansi-tokenize@0.1.3", "", { "dependencies": { "ansi-styles": "^6.2.1", "is-fullwidth-code-point": "^4.0.0" } }, "sha512-3yWxPTq3UQ/FY9p1ErPxIyfT64elWaMvM9lIHnaqpyft63tkxodF5aUElYHrdisWve5cETkh1+KBw1yJuW0aRw=="],
 
-    "@aws-sdk/client-secrets-manager": ["@aws-sdk/client-secrets-manager@3.1110.0", "", { "dependencies": { "@aws-sdk/core": "^3.977.7", "@aws-sdk/credential-provider-node": "^3.972.79", "@aws-sdk/types": "^3.974.3", "@smithy/core": "^3.31.1", "@smithy/fetch-http-handler": "^5.6.13", "@smithy/node-http-handler": "^4.9.13", "@smithy/types": "^4.16.1", "tslib": "^2.6.2" } }, "sha512-MqiRAhiFa9Ywqb7RP1Mtd34iOGpSIbvnCyzsG3qDyvP+txrrtAaSW3P/R7Plm6a+n3oE0GYIYpKh1OrSyAnbEw=="],
-
-    "@aws-sdk/core": ["@aws-sdk/core@3.977.7", "", { "dependencies": { "@aws-sdk/types": "^3.974.3", "@aws-sdk/xml-builder": "^3.972.38", "@aws/lambda-invoke-store": "^0.3.0", "@smithy/core": "^3.31.1", "@smithy/signature-v4": "^5.6.12", "@smithy/types": "^4.16.1", "bowser": "^2.11.0", "tslib": "^2.6.2" } }, "sha512-I88Iov89NVmjSmJLKSv7Cn9M2J+a2942OkA8nZCbz+sl4ZeY4zEOcoLOrbt1GRfQ8zEQKnjAJdXixA3J/p1fDQ=="],
-
-    "@aws-sdk/credential-provider-cognito-identity": ["@aws-sdk/credential-provider-cognito-identity@3.972.67", "", { "dependencies": { "@aws-sdk/nested-clients": "^3.997.42", "@aws-sdk/types": "^3.974.3", "@smithy/core": "^3.31.1", "@smithy/types": "^4.16.1", "tslib": "^2.6.2" } }, "sha512-0NKxn0U3I9qAxou30RlaezVnrhOzCYOkBqBethp8PmHJ7f1dep6AVMQVTrGUchB8bRjubi3MiVVql9+lyDOzBQ=="],
-
-    "@aws-sdk/credential-provider-env": ["@aws-sdk/credential-provider-env@3.972.68", "", { "dependencies": { "@aws-sdk/core": "^3.977.7", "@aws-sdk/types": "^3.974.3", "@smithy/core": "^3.31.1", "@smithy/types": "^4.16.1", "tslib": "^2.6.2" } }, "sha512-2a20A/IdNOwUvaDq91iqqS7BA0XlNMfW3iLGZGZLJv0EbUqhSxB0PIx4rQQqssvWj1uXImb3/UCCdHz/+1dOiA=="],
-
-    "@aws-sdk/credential-provider-http": ["@aws-sdk/credential-provider-http@3.972.70", "", { "dependencies": { "@aws-sdk/core": "^3.977.7", "@aws-sdk/types": "^3.974.3", "@smithy/core": "^3.31.1", "@smithy/fetch-http-handler": "^5.6.13", "@smithy/node-http-handler": "^4.9.13", "@smithy/types": "^4.16.1", "tslib": "^2.6.2" } }, "sha512-0yRem2Fs52r/Nn6UAqIlpjexfaYj8ziEozOe9tamtAVT/5bzFLKx8O2r7MaRqgS3hGKHIa1Jij9nKHSsNnb04A=="],
-
-    "@aws-sdk/credential-provider-ini": ["@aws-sdk/credential-provider-ini@3.973.13", "", { "dependencies": { "@aws-sdk/core": "^3.977.7", "@aws-sdk/credential-provider-env": "^3.972.68", "@aws-sdk/credential-provider-http": "^3.972.70", "@aws-sdk/credential-provider-login": "^3.972.75", "@aws-sdk/credential-provider-process": "^3.972.68", "@aws-sdk/credential-provider-sso": "^3.973.12", "@aws-sdk/credential-provider-web-identity": "^3.972.74", "@aws-sdk/nested-clients": "^3.997.42", "@aws-sdk/types": "^3.974.3", "@smithy/core": "^3.31.1", "@smithy/credential-provider-imds": "^4.4.16", "@smithy/types": "^4.16.1", "tslib": "^2.6.2" } }, "sha512-2M39DE02XpYYaSWYk/4AsImXYUU/1L2xmTMLUpMMWq7DfLv191/vCRy3baKtdr45AkJQyVgSjmuVOLm15SwrRQ=="],
-
-    "@aws-sdk/credential-provider-login": ["@aws-sdk/credential-provider-login@3.972.75", "", { "dependencies": { "@aws-sdk/core": "^3.977.7", "@aws-sdk/nested-clients": "^3.997.42", "@aws-sdk/types": "^3.974.3", "@smithy/core": "^3.31.1", "@smithy/types": "^4.16.1", "tslib": "^2.6.2" } }, "sha512-jaTESuJlQsoUZ44f/i2puyPt8VlF/dMMJ9HM3cStYtk7eKX4N9UWi83OLixUkoOJH3BwWlPLCq9YIK9nfWhVBg=="],
-
-    "@aws-sdk/credential-provider-node": ["@aws-sdk/credential-provider-node@3.972.79", "", { "dependencies": { "@aws-sdk/credential-provider-env": "^3.972.68", "@aws-sdk/credential-provider-http": "^3.972.70", "@aws-sdk/credential-provider-ini": "^3.973.13", "@aws-sdk/credential-provider-process": "^3.972.68", "@aws-sdk/credential-provider-sso": "^3.973.12", "@aws-sdk/credential-provider-web-identity": "^3.972.74", "@aws-sdk/types": "^3.974.3", "@smithy/core": "^3.31.1", "@smithy/credential-provider-imds": "^4.4.16", "@smithy/types": "^4.16.1", "tslib": "^2.6.2" } }, "sha512-RIw5dof1EHkWubrZzPC941CDtnFG1iAXsxbFgLkhdYZXHc4icU13c/uxSMI0J5eUx9bxa7LjfpdjfClBB1QsDA=="],
-
-    "@aws-sdk/credential-provider-process": ["@aws-sdk/credential-provider-process@3.972.68", "", { "dependencies": { "@aws-sdk/core": "^3.977.7", "@aws-sdk/types": "^3.974.3", "@smithy/core": "^3.31.1", "@smithy/types": "^4.16.1", "tslib": "^2.6.2" } }, "sha512-nLP3Pda2MQTFJ25hKBMmUuB9Uv+bTZQNlufbeCwklP549Vwnkd8bRLJoCKp5k6xjmdyptrPrOfGOhN0mKuca8A=="],
-
-    "@aws-sdk/credential-provider-sso": ["@aws-sdk/credential-provider-sso@3.973.12", "", { "dependencies": { "@aws-sdk/core": "^3.977.7", "@aws-sdk/nested-clients": "^3.997.42", "@aws-sdk/token-providers": "3.1108.0", "@aws-sdk/types": "^3.974.3", "@smithy/core": "^3.31.1", "@smithy/types": "^4.16.1", "tslib": "^2.6.2" } }, "sha512-EmgyyHn+f9WCcelp3L/vci+LGbX8GigWaVphRArjVo5Pktkr9YnLy/mQ6VDkDyBD72dtfRNTgHmD2ts4rTDXKQ=="],
-
-    "@aws-sdk/credential-provider-web-identity": ["@aws-sdk/credential-provider-web-identity@3.972.74", "", { "dependencies": { "@aws-sdk/core": "^3.977.7", "@aws-sdk/nested-clients": "^3.997.42", "@aws-sdk/types": "^3.974.3", "@smithy/core": "^3.31.1", "@smithy/types": "^4.16.1", "tslib": "^2.6.2" } }, "sha512-0YfczxGXF3RjGj8z7QG/Ho2HnLGKDHfPSHiTs47UU1U/+mmwISDN+rvGKt2zh+3FX8NdT4xd95LGBGyhQw2dgQ=="],
-
-    "@aws-sdk/credential-providers": ["@aws-sdk/credential-providers@3.1110.0", "", { "dependencies": { "@aws-sdk/core": "^3.977.7", "@aws-sdk/credential-provider-cognito-identity": "^3.972.67", "@aws-sdk/credential-provider-env": "^3.972.68", "@aws-sdk/credential-provider-http": "^3.972.70", "@aws-sdk/credential-provider-ini": "^3.973.13", "@aws-sdk/credential-provider-login": "^3.972.75", "@aws-sdk/credential-provider-node": "^3.972.79", "@aws-sdk/credential-provider-process": "^3.972.68", "@aws-sdk/credential-provider-sso": "^3.973.12", "@aws-sdk/credential-provider-web-identity": "^3.972.74", "@aws-sdk/nested-clients": "^3.997.42", "@aws-sdk/types": "^3.974.3", "@smithy/core": "^3.31.1", "@smithy/credential-provider-imds": "^4.4.16", "@smithy/types": "^4.16.1", "tslib": "^2.6.2" } }, "sha512-3OTthomq7fDGRAYW8wbidTAkkKUOk9WQaXi3b16Lawy/pOGC0Dlg+vha5S99SV/hP48MJzXxiIGrRcE/ShaFIA=="],
-
-    "@aws-sdk/nested-clients": ["@aws-sdk/nested-clients@3.997.42", "", { "dependencies": { "@aws-sdk/core": "^3.977.7", "@aws-sdk/signature-v4-multi-region": "^3.996.44", "@aws-sdk/types": "^3.974.3", "@smithy/core": "^3.31.1", "@smithy/fetch-http-handler": "^5.6.13", "@smithy/node-http-handler": "^4.9.13", "@smithy/types": "^4.16.1", "tslib": "^2.6.2" } }, "sha512-XWRyon2MTHXD/zMoo0Mbge6Vwf+iE0qQaM/RyGO6NfZ9WukCFiQL27nQVZjYy2JwSIg+iXZxKOX95OBXqlSM4w=="],
-
-    "@aws-sdk/signature-v4-multi-region": ["@aws-sdk/signature-v4-multi-region@3.996.44", "", { "dependencies": { "@aws-sdk/types": "^3.974.3", "@smithy/signature-v4": "^5.6.12", "@smithy/types": "^4.16.1", "tslib": "^2.6.2" } }, "sha512-ZSfQ35Qn4MhSY+A0Whyr+KBx+wJKZUyBsOrjB2pSHOafRzbFe47T8XcXM8hZqUAC69qnqIy0C9ArxTuud0CC2w=="],
-
-    "@aws-sdk/token-providers": ["@aws-sdk/token-providers@3.1108.0", "", { "dependencies": { "@aws-sdk/core": "^3.977.7", "@aws-sdk/nested-clients": "^3.997.42", "@aws-sdk/types": "^3.974.3", "@smithy/core": "^3.31.1", "@smithy/types": "^4.16.1", "tslib": "^2.6.2" } }, "sha512-rI80zxDxGJ6904eC/YbjkdjY6JdaZvQ01kOmrMvw7cFQGIHo27fhnIVbMSVDS4T6foQImjxYSRoOu/uSJscXDw=="],
-
-    "@aws-sdk/types": ["@aws-sdk/types@3.974.3", "", { "dependencies": { "@smithy/types": "^4.16.1", "tslib": "^2.6.2" } }, "sha512-ECAqfpNsef+7MO8qtR0h9KcFIBAygaE7Cm6UOiQl+ft+uVap+1G7bNEjs4mdJE2OnA4m6k7i8peH8uGIAsOMGw=="],
-
-    "@aws-sdk/xml-builder": ["@aws-sdk/xml-builder@3.972.38", "", { "dependencies": { "@smithy/types": "^4.16.1", "tslib": "^2.6.2" } }, "sha512-grf7mzfVxBS5AlsuTvBN7uDpzqohFww9fRPCO+EBSUdvtsYMcPSKdz54h/7XiscqNcUM1Ae1MF7JLHmiYYuzbQ=="],
-
-    "@aws/lambda-invoke-store": ["@aws/lambda-invoke-store@0.3.0", "", {}, "sha512-sl4Bm6yiMNYrZKkqqDFWN0UfnWhlS8ivKxrYl+6t0gCLrqr8y3B2IqZZbFRkfaVVp7C/baApyh71P+LeE1A2sQ=="],
-
     "@gar/promise-retry": ["@gar/promise-retry@1.0.3", "", {}, "sha512-GmzA9ckNokPypTg10pgpeHNQe7ph+iIKKmhKu3Ob9ANkswreCx7R3cKmY781K8QK3AqVL3xVh9A42JvIAbkkSA=="],
 
-    "@hasna/contracts": ["@hasna/contracts@0.10.6", "", { "dependencies": { "@hasna/secrets": "^0.2.22", "commander": "^13.1.0", "zod": "^3.25.76", "zod-to-json-schema": "^3.24.6" }, "bin": { "contracts": "dist/cli/index.js", "contracts-cli": "dist/cli/contracts-cli.js" } }, "sha512-lHGwSjCAJof2868o3xAHbWbq8WR675MNQMnRVaRPHvX0LeSLsEWfV5nqE4KjhDJfDRhXhiSo4pmvI03AW4cMnQ=="],
+    "@hasna/contracts": ["@hasna/contracts@1.0.2", "", { "dependencies": { "commander": "^13.1.0", "zod": "^3.25.76", "zod-to-json-schema": "^3.24.6" }, "peerDependencies": { "@hasna/secrets": "^0.3.10 || ^0.4.0" }, "optionalPeers": ["@hasna/secrets"], "bin": { "contracts": "dist/cli/index.js", "contracts-cli": "dist/cli/contracts-cli.js" } }, "sha512-Wq6ma5qR+ozmMabPZ1EyHb3TVRi37jYkrjiEmIpd6ZpTQY5H2gRept/e8kxlA/xOyxFN6bPhKcFQ7FmhuCpnwQ=="],
 
     "@hasna/events": ["@hasna/events@0.1.6", "", { "dependencies": { "commander": "^13.1.0" }, "bin": { "events": "dist/cli/index.js", "hasna-events": "dist/cli/index.js" } }, "sha512-rKLxjBIat45UxciUwh9hKM63l/mcurJXAhgVkYHvrsGnOK9HwExrwgOlylNzDBDb+huiQw9DWdLb31q5oWDfIw=="],
 
-    "@hasna/paths": ["@hasna/paths@0.1.0", "", { "bin": { "paths": "dist/cli/index.js" } }, "sha512-ZBoj/h8zJ5t0JRMp19SfbiACdIsEi952UXmK7QwvIcsD4OhN4dONuuDslw+FE80rM1PVApdhMzoaHp+XEW189Q=="],
-
-    "@hasna/secrets": ["@hasna/secrets@0.2.22", "", { "dependencies": { "@aws-sdk/client-secrets-manager": "^3.1008.0", "@aws-sdk/credential-providers": "^3.1008.0", "@hasna/events": "^0.1.13", "@modelcontextprotocol/sdk": "^1.27.1", "@smithy/core": "^3.25.1", "commander": "^13.1.0", "pg": "^8.20.0" }, "bin": { "secrets": "dist/index.js", "secrets-mcp": "dist/mcp-server.js", "secrets-serve": "dist/server/index.js" } }, "sha512-WMX9dstmNmbjkN49WH9kh1TPApAIsTz2qU9wwX8I0Sy7zrpJJvTTyHU41Ih8P5NIi8AU/Bo1g4T1Z7VU2b5gjQ=="],
-
     "@hono/node-server": ["@hono/node-server@1.19.11", "", { "peerDependencies": { "hono": "^4" } }, "sha512-dr8/3zEaB+p0D2n/IUrlPF1HZm586qgJNXK1a9fhg/PzdtkK7Ksd5l312tJX2yBuALqDYBlG20QEbayqPyxn+g=="],
 
     "@modelcontextprotocol/sdk": ["@modelcontextprotocol/sdk@1.27.1", "", { "dependencies": { "@hono/node-server": "^1.19.9", "ajv": "^8.17.1", "ajv-formats": "^3.0.1", "content-type": "^1.0.5", "cors": "^2.8.5", "cross-spawn": "^7.0.5", "eventsource": "^3.0.2", "eventsource-parser": "^3.0.0", "express": "^5.2.1", "express-rate-limit": "^8.2.1", "hono": "^4.11.4", "jose": "^6.1.3", "json-schema-typed": "^8.0.2", "pkce-challenge": "^5.0.0", "raw-body": "^3.0.0", "zod": "^3.25 || ^4.0", "zod-to-json-schema": "^3.25.1" }, "peerDependencies": { "@cfworker/json-schema": "^4.1.1" }, "optionalPeers": ["@cfworker/json-schema"] }, "sha512-sr6GbP+4edBwFndLbM60gf07z0FQ79gaExpnsjMGePXqFcSSb7t6iscpjk9DhFhwd+mTEQrzNafGP8/iGGFYaA=="],
@@ -117,25 +76,13 @@
 
     "@sigstore/verify": ["@sigstore/verify@4.1.0", "", { "dependencies": { "@sigstore/bundle": "^5.0.0", "@sigstore/core": "^4.0.1", "@sigstore/protobuf-specs": "^0.5.0" } }, "sha512-p/s720RiWxLG8XtmfdPfEJOlATA6H/2knFqmtQbFkHKN3IrhWGUwPfpQAf1UnQIEES9IaH6zzhfjkrhTfeSdZw=="],
 
-    "@smithy/core": ["@smithy/core@3.33.0", "", { "dependencies": { "@smithy/types": "^4.17.0", "tslib": "^2.6.2" } }, "sha512-uKbkxgqLyepQDZoq8aRSdUqD1ID//rOqG96ixBhp++O7vBtmwYM6fwldGhr9HJP0iYrdc7GP/AlgzPWEZIrNRg=="],
-
-    "@smithy/credential-provider-imds": ["@smithy/credential-provider-imds@4.5.0", "", { "dependencies": { "@smithy/core": "^3.32.0", "@smithy/types": "^4.17.0", "tslib": "^2.6.2" } }, "sha512-2jsPi+7Zv2hSzD9IXR9D7DTqSn7mv4XalzRm+bESh53jiaUS3NKEUbpQFTJP0HhQy9qzZvluxQ3yS24zdRrqsA=="],
-
-    "@smithy/fetch-http-handler": ["@smithy/fetch-http-handler@5.7.0", "", { "dependencies": { "@smithy/core": "^3.32.0", "@smithy/types": "^4.17.0", "tslib": "^2.6.2" } }, "sha512-W/exA8T0LEzCQtJ02w4IzaEQPIspgarqZprb7W8FwnYiDowgCrjl2fTQ6FvuSSUnJORuepBF81abmBJwqh+0XQ=="],
-
-    "@smithy/node-http-handler": ["@smithy/node-http-handler@4.11.0", "", { "dependencies": { "@smithy/core": "^3.33.0", "@smithy/types": "^4.17.0", "tslib": "^2.6.2" } }, "sha512-ssHIZsadPUA3lGdnoByxfnjtb9xPYQLvdfJRLKIwxOoa6tO1suG4sLFSsgd7D/CsvYd8QbBIuKTImuJha5l6aQ=="],
-
-    "@smithy/signature-v4": ["@smithy/signature-v4@5.7.0", "", { "dependencies": { "@smithy/core": "^3.32.0", "@smithy/types": "^4.17.0", "tslib": "^2.6.2" } }, "sha512-hCynhm22wMJ8wTF9crcwu8mxggtUrSLLJgDcGUvYFBqpofxycYJCGKOMYg4xtPPFtgNiDJSYmhsWLTrcU/g59Q=="],
-
-    "@smithy/types": ["@smithy/types@4.17.0", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-Aw4joiM0ZdErpo39lCj8phT2lxoiKZV+KZzBxnnQhWVtU2Is/WffQSL04uUWRcXUse9Ln8vXZK6V/FwqRVnQpg=="],
-
     "@standard-schema/spec": ["@standard-schema/spec@1.1.0", "", {}, "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w=="],
 
     "@tufjs/canonical-json": ["@tufjs/canonical-json@2.0.0", "", {}, "sha512-yVtV8zsdo8qFHe+/3kw81dSLyF7D576A5cCFCi4X7B39tWT7SekaEFUnvnWJHz+9qO7qJTah1JbrDjWKqFtdWA=="],
 
     "@tufjs/models": ["@tufjs/models@5.0.0", "", { "dependencies": { "@tufjs/canonical-json": "2.0.0", "minimatch": "^10.2.1" } }, "sha512-U4mVcdFGOi6pt8n38LdWZp67Svn7ppnU1Pj8SGOVaBi1X4gm+G4ztQlLfkoJbKSHfjA6WeaiJp2A4V83AJF6nQ=="],
 
-    "@types/bun": ["@types/bun@1.3.10", "", { "dependencies": { "bun-types": "1.3.10" } }, "sha512-0+rlrUrOrTSskibryHbvQkDOWRJwJZqZlxrUs1u4oOoTln8+WIXBPmAuCF35SWB2z4Zl3E84Nl/D0P7803nigQ=="],
+    "@types/bun": ["@types/bun@1.3.14", "", { "dependencies": { "bun-types": "1.3.14" } }, "sha512-h1hFqFVcvAvD9j9K7ZW7vd82aSA+rTdznZa+5bwvCwqSB1jmmfLcbIWhOLx1/+boy/xmjgCs/OMUL8hRJSmnPw=="],
 
     "@types/node": ["@types/node@25.4.0", "", { "dependencies": { "undici-types": "~7.18.0" } }, "sha512-9wLpoeWuBlcbBpOY3XmzSTG3oscB6xjBEEtn+pYXTfhyXhIxC5FsBer2KTopBlvKEiW9l13po9fq+SJY/5lkhw=="],
 
@@ -171,8 +118,6 @@
 
     "body-parser": ["body-parser@2.2.2", "", { "dependencies": { "bytes": "^3.1.2", "content-type": "^1.0.5", "debug": "^4.4.3", "http-errors": "^2.0.0", "iconv-lite": "^0.7.0", "on-finished": "^2.4.1", "qs": "^6.14.1", "raw-body": "^3.0.1", "type-is": "^2.0.1" } }, "sha512-oP5VkATKlNwcgvxi0vM0p/D3n2C3EReYVX+DNYs5TjZFn/oQt2j+4sVJtSMr18pdRr8wjTcBl6LoV+FUwzPmNA=="],
 
-    "bowser": ["bowser@2.14.1", "", {}, "sha512-tzPjzCxygAKWFOJP011oxFHs57HzIhOEracIgAePE4pqB3LikALKnSzUyU4MGs9/iCEUuHlAJTjTc5M+u7YEGg=="],
-
     "brace-expansion": ["brace-expansion@5.0.9", "", { "dependencies": { "balanced-match": "^4.0.2" } }, "sha512-ScQ4IuvIEF1TMlP7Zt+vjJ//9zlPb2SDcxWxM3bk8s6t6GGdJ7KO1dCcTidOPJKePW30LE/2cT7wCyPho9/Wxg=="],
 
     "bun-types": ["bun-types@1.3.14", "", { "dependencies": { "@types/node": "*" } }, "sha512-4N0ig0fEomHt5R0KCFWjovxow98rIoRwKolrYdCcknNwMekCXRnWEUvgu5soYV8QXtVsrUD8B95MBOZGPvr6KQ=="],
@@ -497,8 +442,6 @@
 
     "tr46": ["tr46@0.0.3", "", {}, "sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw=="],
 
-    "tslib": ["tslib@2.8.1", "", {}, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
-
     "tuf-js": ["tuf-js@6.0.0", "", { "dependencies": { "@gar/promise-retry": "^1.0.3", "@tufjs/models": "5.0.0", "debug": "^4.4.3" } }, "sha512-zlJVOIO68hmgo1//X4ENEcTGfuOTAtDPi8PsTsG+FyxD85E/ww1ZnwBbWo/yCEExGpI+Kilg7Z3qCdHX2BoJTQ=="],
 
     "type-fest": ["type-fest@4.41.0", "", {}, "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA=="],
@@ -543,10 +486,6 @@
 
     "@ai-sdk/provider-utils/eventsource-parser": ["eventsource-parser@3.1.0", "", {}, "sha512-kJezFj9YFAMLeORyi7aCLxLbD5/qWMQnoMVlVPyHIll7lgRJCc3JVln9Vgl9nwQi0YkMnhdGTMNn7CkRRAptMg=="],
 
-    "@hasna/secrets/@hasna/events": ["@hasna/events@0.1.16", "", { "dependencies": { "commander": "^13.1.0" }, "bin": { "events": "dist/cli/index.js", "hasna-events": "dist/cli/index.js" } }, "sha512-HX66T8JljVOoE/Li8WKLUFVozg0GIdZmgBalScfBFW5Vru4IcVSTNs07TmYH3kIJUe5tylItTqwzc02nvjqbfw=="],
-
-    "@types/bun/bun-types": ["bun-types@1.3.10", "", { "dependencies": { "@types/node": "*" } }, "sha512-tcpfCCl6XWo6nCVnpcVrxQ+9AYN1iqMIzgrSKYMB/fjLtV2eyAVEg7AxQJuCq/26R6HpKWykQXuSOq/21RYcbg=="],
-
     "cli-truncate/slice-ansi": ["slice-ansi@5.0.0", "", { "dependencies": { "ansi-styles": "^6.0.0", "is-fullwidth-code-point": "^4.0.0" } }, "sha512-FC+lgizVPfie0kkhqUScwRu1O/lF6NOgJmlCgK+/LYxDCTk8sGelYaHDhFcDN+Sn3Cv+3VSa4Byeo+IMCzpMgQ=="],
 
     "minipass-flush/minipass": ["minipass@3.3.6", "", { "dependencies": { "yallist": "^4.0.0" } }, "sha512-DxiNidxSEK+tHG6zOIklvNOwm3hvCrbUrdtzY74U6HKTJxvIDfOUL5W5P2Ghd3DTkhhKPYGqeNUIh5qcM4YBfw=="],

package/dist/audit-contract.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Pure public contract for the immutable Mementos audit log.
+ *
+ * This module deliberately has no storage, credential, transport, filesystem,
+ * or server dependencies so the SDK and hosted client can validate the exact
+ * same versioned receipts without pulling SQLite into client bundles.
+ */
+export declare const AUDIT_TRAIL_CONTRACT: "mementos.audit.trail.v1";
+export declare const AUDIT_EXPORT_CONTRACT: "mementos.audit.export.v1";
+export declare const AUDIT_STATS_CONTRACT: "mementos.audit.stats.v1";
+export declare const AUDIT_CURSOR_VERSION: 1;
+export declare const AUDIT_DEFAULT_LIMIT: 50;
+export declare const AUDIT_OPERATIONS: readonly ["create", "update", "delete", "archive", "restore", "read"];
+export type AuditOperation = (typeof AUDIT_OPERATIONS)[number];
+export type AuditPageContract = typeof AUDIT_TRAIL_CONTRACT | typeof AUDIT_EXPORT_CONTRACT;
+export interface AuditEntry {
+    id: string;
+    memory_id: string;
+    memory_key: string | null;
+    operation: AuditOperation;
+    agent_id: string | null;
+    /** md5 hex digest of the value before the operation, or null when unavailable. */
+    old_value_hash: string | null;
+    /** md5 hex digest of the value after the operation, or null when unavailable. */
+    new_value_hash: string | null;
+    changes: Record<string, unknown>;
+    created_at: string;
+}
+export interface AuditFilters {
+    memory_id: string | null;
+    since: string | null;
+    until: string | null;
+    operation: AuditOperation | null;
+    agent_id: string | null;
+}
+export interface AuditPage {
+    contract: AuditPageContract;
+    entries: AuditEntry[];
+    count: number;
+    total: number;
+    limit: number;
+    cursor: string | null;
+    next_cursor: string | null;
+    consumed: number;
+    has_more: boolean;
+    complete: boolean;
+    snapshot_at: string;
+    filters: AuditFilters;
+    sort: {
+        field: "created_at";
+        direction: "desc";
+        tie_breaker: "id";
+    };
+}
+export interface AuditStats {
+    contract: typeof AUDIT_STATS_CONTRACT;
+    total_entries: number;
+    by_operation: Record<AuditOperation, number>;
+    recent_24h: number;
+    snapshot_at: string;
+}
+export interface AuditCursorPayload {
+    v: typeof AUDIT_CURSOR_VERSION;
+    contract: AuditPageContract;
+    snapshot_created_at: string | null;
+    snapshot_id: string | null;
+    after_created_at: string | null;
+    after_id: string | null;
+    snapshot_total: number;
+    consumed: number;
+    filter_fingerprint: string;
+}
+export declare class AuditContractError extends Error {
+    readonly code = "MEMENTOS_AUDIT_CONTRACT";
+    constructor(message: string);
+}
+export declare function canonicalAuditTimestamp(value: unknown, label: string): string;
+export declare function auditOperation(value: unknown, label?: string): AuditOperation;
+export declare function validateAuditEntry(value: unknown, label?: string): AuditEntry;
+export declare function validateAuditPage(value: unknown, expected: {
+    contract: AuditPageContract;
+    cursor: string | null;
+    filters: AuditFilters;
+    limit: number;
+}): AuditPage;
+export declare function validateAuditStats(value: unknown): AuditStats;
+//# sourceMappingURL=audit-contract.d.ts.map

package/dist/audit-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-contract.d.ts","sourceRoot":"","sources":["../src/audit-contract.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/info-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"info-context.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/info-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6I7D"}
+{"version":3,"file":"info-context.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/info-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgJ7D"}

package/dist/cli/commands/info-history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"info-history.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/info-history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiF7D"}
+{"version":3,"file":"info-history.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/info-history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2BzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoI7D"}

package/dist/cli/commands/info-stale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"info-stale.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/info-stale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsG3D"}
+{"version":3,"file":"info-stale.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/info-stale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsH3D"}

package/dist/cli/commands/io-backup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"io-backup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/io-backup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsG5D"}
+{"version":3,"file":"io-backup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/io-backup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuIzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiI5D"}

package/dist/cli/commands/io-export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"io-export.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/io-export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwC5D"}
+{"version":3,"file":"io-export.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/io-export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiD5D"}

package/dist/cli/commands/io-restore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"io-restore.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/io-restore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsCzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4N7D"}
+{"version":3,"file":"io-restore.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/io-restore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6FzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsN7D"}

package/dist/cli/commands/memory-cmd-chain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-cmd-chain.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory-cmd-chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiC3D"}
+{"version":3,"file":"memory-cmd-chain.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory-cmd-chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsC3D"}

package/dist/cli/commands/memory-cmd-crud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-cmd-crud.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory-cmd-crud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsCzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0qB3D"}
+{"version":3,"file":"memory-cmd-crud.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory-cmd-crud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2CzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAosB3D"}

package/dist/cli/commands/memory-cmd-list.d.ts

@@ -1,3 +1,28 @@
 import type { Command } from "commander";
+import type { Memory } from "../../types/index.js";
+export declare const STRUCTURED_PAGE_MAX_ROWS = 1000;
+export declare const STRUCTURED_ALL_MAX_ROWS = 5000;
+export declare const STRUCTURED_DEFAULT_MAX_BYTES: number;
+export declare const STRUCTURED_FULL_MAX_BYTES: number;
+export declare const STRUCTURED_ALL_MAX_BYTES: number;
+export type StructuredMemoryDetail = "compact" | "full";
+export declare function structuredMaxBytes(value: unknown, opts: {
+    all: boolean;
+    detail: StructuredMemoryDetail;
+}): number;
+export declare function compactMemoryForStructuredOutput(memory: Memory, opts?: {
+    history?: boolean;
+}): Record<string, unknown>;
+export declare function structuredMemoryOutput(args: {
+    memories: Memory[];
+    receipt: string;
+    offset: number;
+    limit: number;
+    sourceHasMore: boolean;
+    all: boolean;
+    detail: StructuredMemoryDetail;
+    maxBytes: number;
+    history?: boolean;
+}): string;
 export declare function registerListCommand(program: Command): void;
 //# sourceMappingURL=memory-cmd-list.d.ts.map

package/dist/cli/commands/memory-cmd-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-cmd-list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory-cmd-list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6I1D"}
+{"version":3,"file":"memory-cmd-list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory-cmd-list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,OAAO,KAAK,EAAE,MAAM,EAA2D,MAAM,sBAAsB,CAAC;AAkB5G,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAC9C,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAC7C,eAAO,MAAM,4BAA4B,QAAY,CAAC;AACtD,eAAO,MAAM,yBAAyB,QAAY,CAAC;AACnD,eAAO,MAAM,wBAAwB,QAAc,CAAC;AAGpD,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,MAAM,CAAC;AA2BxD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,GACrD,MAAM,CAkBR;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzB;AAiED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,OAAO,CAAC;IACvB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,sBAAsB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,MAAM,CAkDT;AAkBD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqK1D"}

package/dist/cli/commands/memory-cmd-recall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-cmd-recall.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory-cmd-recall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwF5D"}
+{"version":3,"file":"memory-cmd-recall.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory-cmd-recall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8F5D"}

package/dist/cli/commands/memory-cmd-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-cmd-search.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory-cmd-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgJ5D"}
+{"version":3,"file":"memory-cmd-search.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory-cmd-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyJ5D"}

package/dist/cli/commands/memory-cmd-tail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-cmd-tail.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory-cmd-tail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAezC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsF1D"}
+{"version":3,"file":"memory-cmd-tail.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory-cmd-tail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2F1D"}

package/dist/cli/commands/memory-cmd-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-cmd-view.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory-cmd-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiL3D"}
+{"version":3,"file":"memory-cmd-view.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory-cmd-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsM3D"}

package/dist/cli/commands/memory-cmd-when-to-use.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-cmd-when-to-use.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory-cmd-when-to-use.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsC/D"}
+{"version":3,"file":"memory-cmd-when-to-use.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory-cmd-when-to-use.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2C/D"}

package/dist/cli/commands/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuCzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsb9D"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuCzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyb9D"}

package/dist/cli/commands/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6UzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAK9D"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwVzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAK9D"}

package/dist/cli/commands/system-doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/system-doctor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2CzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwP5D"}
+{"version":3,"file":"system-doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/system-doctor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4CzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0Q5D"}

package/dist/cli/commands/system-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-session.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/system-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwH7D"}
+{"version":3,"file":"system-session.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/system-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmI7D"}