@hasna/mementos 0.15.2 → 0.17.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 (130) hide show
  1. package/README.md +83 -22
  2. package/dist/audit-contract.d.ts +87 -0
  3. package/dist/audit-contract.d.ts.map +1 -0
  4. package/dist/cli/commands/agent.d.ts.map +1 -1
  5. package/dist/cli/commands/consolidation.d.ts.map +1 -1
  6. package/dist/cli/commands/info-context.d.ts.map +1 -1
  7. package/dist/cli/commands/info-history.d.ts.map +1 -1
  8. package/dist/cli/commands/io-backup.d.ts.map +1 -1
  9. package/dist/cli/commands/io-export.d.ts.map +1 -1
  10. package/dist/cli/commands/io-restore.d.ts.map +1 -1
  11. package/dist/cli/commands/memory-cmd-crud.d.ts.map +1 -1
  12. package/dist/cli/commands/memory-cmd-list.d.ts +25 -0
  13. package/dist/cli/commands/memory-cmd-list.d.ts.map +1 -1
  14. package/dist/cli/commands/memory-cmd-recall.d.ts.map +1 -1
  15. package/dist/cli/commands/memory-cmd-remove.d.ts.map +1 -1
  16. package/dist/cli/commands/memory-cmd-search.d.ts.map +1 -1
  17. package/dist/cli/commands/memory-cmd-view.d.ts.map +1 -1
  18. package/dist/cli/commands/memory-cmd-when-to-use.d.ts.map +1 -1
  19. package/dist/cli/commands/project.d.ts.map +1 -1
  20. package/dist/cli/commands/system-session.d.ts.map +1 -1
  21. package/dist/cli/commands/system-status.d.ts.map +1 -1
  22. package/dist/cli/commands/system-synthesized-profile.d.ts.map +1 -1
  23. package/dist/cli/helpers.d.ts +3 -1
  24. package/dist/cli/helpers.d.ts.map +1 -1
  25. package/dist/cli/index.js +2482 -823
  26. package/dist/cli/structured-json.d.ts +54 -0
  27. package/dist/cli/structured-json.d.ts.map +1 -0
  28. package/dist/db/api-mode.d.ts +10 -0
  29. package/dist/db/api-mode.d.ts.map +1 -1
  30. package/dist/db/api-response-contract.d.ts +23 -0
  31. package/dist/db/api-response-contract.d.ts.map +1 -0
  32. package/dist/db/audit.d.ts +34 -45
  33. package/dist/db/audit.d.ts.map +1 -1
  34. package/dist/db/database.d.ts +1 -0
  35. package/dist/db/database.d.ts.map +1 -1
  36. package/dist/db/locks.d.ts.map +1 -1
  37. package/dist/db/machines.d.ts +50 -13
  38. package/dist/db/machines.d.ts.map +1 -1
  39. package/dist/db/memories.d.ts.map +1 -1
  40. package/dist/db/migrations.d.ts.map +1 -1
  41. package/dist/db/pg-migrate.d.ts.map +1 -1
  42. package/dist/db/pg-migrations.d.ts.map +1 -1
  43. package/dist/db/session-jobs.d.ts +2 -0
  44. package/dist/db/session-jobs.d.ts.map +1 -1
  45. package/dist/diagnostics/historical-project-registration-receipt.js +215 -1
  46. package/dist/index.d.ts +4 -2
  47. package/dist/index.d.ts.map +1 -1
  48. package/dist/index.js +1523 -206
  49. package/dist/lib/built-in-hooks.d.ts.map +1 -1
  50. package/dist/lib/conversations-transport.d.ts +21 -0
  51. package/dist/lib/conversations-transport.d.ts.map +1 -0
  52. package/dist/lib/export-v1.d.ts +2 -0
  53. package/dist/lib/export-v1.d.ts.map +1 -1
  54. package/dist/lib/injection-project.d.ts +10 -0
  55. package/dist/lib/injection-project.d.ts.map +1 -0
  56. package/dist/lib/injector.d.ts +1 -0
  57. package/dist/lib/injector.d.ts.map +1 -1
  58. package/dist/lib/machine-visibility.d.ts.map +1 -1
  59. package/dist/lib/memory-lock.d.ts.map +1 -1
  60. package/dist/lib/profile-synthesizer.d.ts +13 -2
  61. package/dist/lib/profile-synthesizer.d.ts.map +1 -1
  62. package/dist/lib/session-queue.d.ts.map +1 -1
  63. package/dist/lib/session-registry.d.ts +38 -1
  64. package/dist/lib/session-registry.d.ts.map +1 -1
  65. package/dist/lib/storage-sync.d.ts +5 -0
  66. package/dist/lib/storage-sync.d.ts.map +1 -1
  67. package/dist/lib/synthesis/index.d.ts.map +1 -1
  68. package/dist/mcp/index.d.ts +1 -1
  69. package/dist/mcp/index.d.ts.map +1 -1
  70. package/dist/mcp/index.js +3857 -1600
  71. package/dist/mcp/memory-broadcast.d.ts +6 -8
  72. package/dist/mcp/memory-broadcast.d.ts.map +1 -1
  73. package/dist/mcp/profile.d.ts +23 -0
  74. package/dist/mcp/profile.d.ts.map +1 -0
  75. package/dist/mcp/tools/bounded-output.d.ts +27 -0
  76. package/dist/mcp/tools/bounded-output.d.ts.map +1 -0
  77. package/dist/mcp/tools/lock-tools.d.ts.map +1 -1
  78. package/dist/mcp/tools/memory-audit.d.ts +1 -1
  79. package/dist/mcp/tools/memory-audit.d.ts.map +1 -1
  80. package/dist/mcp/tools/memory-crud.d.ts.map +1 -1
  81. package/dist/mcp/tools/memory-inject.d.ts.map +1 -1
  82. package/dist/mcp/tools/memory-io.d.ts.map +1 -1
  83. package/dist/mcp/tools/project-tools.d.ts.map +1 -1
  84. package/dist/mcp/tools/session-tools.d.ts.map +1 -1
  85. package/dist/mcp/tools/tool-registry.d.ts +22 -19
  86. package/dist/mcp/tools/tool-registry.d.ts.map +1 -1
  87. package/dist/mcp/tools/utility-tools.d.ts +2 -1
  88. package/dist/mcp/tools/utility-tools.d.ts.map +1 -1
  89. package/dist/project-registration.js +276 -20
  90. package/dist/sdk/index.d.ts +110 -7
  91. package/dist/sdk/index.d.ts.map +1 -1
  92. package/dist/sdk/index.js +746 -28
  93. package/dist/server/index.d.ts +2 -0
  94. package/dist/server/index.d.ts.map +1 -1
  95. package/dist/server/index.js +3195 -1134
  96. package/dist/server/openapi.d.ts.map +1 -1
  97. package/dist/server/routes/audit.d.ts +2 -0
  98. package/dist/server/routes/audit.d.ts.map +1 -0
  99. package/dist/server/routes/machines.d.ts +2 -0
  100. package/dist/server/routes/machines.d.ts.map +1 -0
  101. package/dist/server/routes/system-sessions.d.ts.map +1 -1
  102. package/dist/server/routes/system-synthesis.d.ts.map +1 -1
  103. package/dist/types/index.d.ts +3 -0
  104. package/dist/types/index.d.ts.map +1 -1
  105. package/hasna.contract.json +2 -2
  106. package/package.json +8 -5
  107. package/dist/cli/__fixtures__/clean-fallback-stub-server.d.ts +0 -2
  108. package/dist/cli/__fixtures__/clean-fallback-stub-server.d.ts.map +0 -1
  109. package/dist/cli/__fixtures__/io-restore-stub-server.d.ts +0 -2
  110. package/dist/cli/__fixtures__/io-restore-stub-server.d.ts.map +0 -1
  111. package/dist/db/__fixtures__/fail-closed-stub-server.d.ts +0 -2
  112. package/dist/db/__fixtures__/fail-closed-stub-server.d.ts.map +0 -1
  113. package/dist/db/__fixtures__/list-filter-capture-server.d.ts +0 -2
  114. package/dist/db/__fixtures__/list-filter-capture-server.d.ts.map +0 -1
  115. package/dist/db/__fixtures__/list-filter-client-runner.d.ts +0 -2
  116. package/dist/db/__fixtures__/list-filter-client-runner.d.ts.map +0 -1
  117. package/dist/test-support/memories-page-stub-server.d.ts +0 -2
  118. package/dist/test-support/memories-page-stub-server.d.ts.map +0 -1
  119. package/dist/test-support/memories-page-stub.d.ts +0 -28
  120. package/dist/test-support/memories-page-stub.d.ts.map +0 -1
  121. package/dist/test-support/pg-sync-stub-worker.d.ts +0 -2
  122. package/dist/test-support/pg-sync-stub-worker.d.ts.map +0 -1
  123. package/dist/test-support/preload-local-store.d.ts +0 -2
  124. package/dist/test-support/preload-local-store.d.ts.map +0 -1
  125. package/dist/test-support/project-authority-identity.d.ts +0 -8
  126. package/dist/test-support/project-authority-identity.d.ts.map +0 -1
  127. package/dist/test-support/store-isolation.d.ts +0 -147
  128. package/dist/test-support/store-isolation.d.ts.map +0 -1
  129. package/dist/test-support/strip-ansi.d.ts +0 -3
  130. package/dist/test-support/strip-ansi.d.ts.map +0 -1
package/README.md CHANGED
@@ -1,9 +1,8 @@
1
1
  # @hasna/mementos
2
2
 
3
3
  Persistent memory for AI agents, available as a CLI, MCP server, REST service,
4
- and TypeScript library. Mementos stores memories in local SQLite by default and
5
- can route clients to a self-hosted PostgreSQL-backed service over an authenticated
6
- HTTP API.
4
+ and TypeScript library. Hosted clients use the authenticated Mementos HTTP API;
5
+ local SQLite is available only through an explicit local-mode opt-in.
7
6
 
8
7
  [![npm](https://img.shields.io/npm/v/@hasna/mementos)](https://www.npmjs.com/package/@hasna/mementos)
9
8
  [![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
@@ -28,10 +27,11 @@ The package installs three binaries:
28
27
 
29
28
  ## Quick start
30
29
 
31
- Local mode needs no service or database configuration. The first command creates
30
+ Local mode must be selected explicitly. The first command after the opt-in creates
32
31
  and migrates `~/.hasna/mementos/mementos.db`.
33
32
 
34
33
  ```bash
34
+ export HASNA_MEMENTOS_LOCAL=1
35
35
  mementos save project-stack "Bun, TypeScript, SQLite" \
36
36
  --scope shared --category fact
37
37
  mementos recall project-stack
@@ -51,6 +51,28 @@ Memory scopes are `global`, `shared`, `private`, and `working`. `working` is
51
51
  transient session scratch space and defaults to a one-hour lifetime. Categories
52
52
  are `preference`, `fact`, `knowledge`, `history`, `procedural`, and `resource`.
53
53
 
54
+ For CLI `context` and `inject`, an explicit `--project` must resolve to a registered
55
+ project and restricts every included scope to that exact project. SDK
56
+ `getContext({ project_id })` uses the same exact-project rule. Unknown explicit
57
+ projects fail before memories are selected or touched; omitting the project keeps
58
+ the existing scope selection.
59
+
60
+ The library and MCP injection strategies retain unassigned agent-private context
61
+ alongside the selected project's private memories. They exclude private memories
62
+ assigned to another project. Their existing global/shared policies remain:
63
+ library strategies include global memories across projects and project-scoped
64
+ shared memories; direct MCP injection also scopes global memories to the project,
65
+ while its full smart pipeline uses the library policy.
66
+
67
+ Injection project references may be a stable project ID, registered name, or
68
+ registered path. Library, MCP, and HTTP/SDK injection resolve that reference once
69
+ and use the stable project ID for every downstream profile, search, filter, hook,
70
+ and touch path.
71
+
72
+ The list API and SDK expose `include_unassigned_project: true` with `project_id`
73
+ for this union. The filter applies before pagination and also governs `total`;
74
+ without a project it has no effect. Omitting it keeps an exact project match.
75
+
54
76
  ## CLI
55
77
 
56
78
  ```bash
@@ -60,13 +82,32 @@ mementos <command> --help
60
82
 
61
83
  Human-readable list and search commands are compact and paginated by default.
62
84
  Use `--limit` with `--cursor` or `--offset`, `--verbose` for wider snippets, and
63
- `mementos show <id>` for a full record. Use global `--json` or a supported
64
- `--format json|csv|yaml` option for structured output.
85
+ `mementos show <id>` for a full record.
86
+
87
+ JSON collection output is intentionally envelope-based in this minor release.
88
+ `projects --json`, `agents --json`, `list --json`, and `search --json` no longer
89
+ return bare arrays: each returns a compact collection plus truthful `_meta`
90
+ continuation fields. `--agent-json` remains an alias for the list receipt.
91
+ `--full` changes row detail inside the envelope; `--all` exhausts the query
92
+ inside the envelope (up to 100,000 rows / 64 MiB). Neither flag restores a bare
93
+ array for these four commands. The sole legacy bare-array escape is
94
+ `export --all`, because export is an explicitly bulk-oriented command.
95
+
96
+ Agent JSON uses offset pagination. Stable ID tie-breakers prevent overlap for
97
+ equal timestamps and importance while the result set is unchanged; writes
98
+ between page requests can shift offsets, so restart traversal when a stable
99
+ snapshot is required.
65
100
 
66
101
  ```bash
67
- mementos list --limit 20 --cursor 20
68
- mementos search "deploy" --verbose
69
- mementos --json list
102
+ mementos list --json # compact 20-row receipt, <=32 KiB
103
+ mementos list --json --cursor 20
104
+ mementos list --json --full --limit 5 # explicit full detail, still bounded
105
+ mementos list --json --all # exhaustive receipt, still an envelope
106
+ mementos projects --json # compact continuation receipt
107
+ mementos agents --json # compact continuation receipt
108
+ mementos search "deploy" --json # compact byte-capped search receipt
109
+ mementos export # truthful paginated export receipt
110
+ mementos export --all # explicit exhaustive legacy array
70
111
  mementos storage mode --json
71
112
  ```
72
113
 
@@ -95,11 +136,22 @@ mementos-mcp --stdio
95
136
  Cursor, Codex, Claude, and other command-based MCP host entries should use
96
137
  `command = "mementos-mcp"` with `args = ["--stdio"]`.
97
138
 
98
- The server exposes its live tools plus `mementos://memories`,
99
- `mementos://agents`, and `mementos://projects`. MCP `tools/list` is the complete
100
- schema source; the convenience `search_tools` and `describe_tools` calls cover
101
- the smaller registered utility discovery catalog. See the [MCP
102
- reference](docs/MCP.md) for installation examples and the full tool inventory.
139
+ The default `core` MCP profile exposes a bounded 23-tool agent surface. Select
140
+ additional comma-separated profiles with `--mcp-profile`,
141
+ `HASNA_MEMENTOS_MCP_PROFILE`, or the compatibility alias
142
+ `MEMENTOS_MCP_PROFILE`: `search`, `graph`, `automation`, `admin`, `storage`,
143
+ `hooks`, and `full`. The explicit `full` profile preserves all 124 tools and the
144
+ legacy unpaged `mementos://memories`, `mementos://agents`, and
145
+ `mementos://projects` resources; reduced profiles omit those resources and use
146
+ bounded list/get tools instead.
147
+
148
+ MCP `tools/list` remains the authoritative schema source. `search_tools` returns
149
+ a bounded names-only page for active-profile tools, and `describe_tools`
150
+ requires one to ten explicit names. `memory_context` defaults to ten ranked
151
+ ~240-character previews under a 32 KiB ceiling; use `detail="full"` explicitly.
152
+ `memory_inject` defaults to lightweight hints and preserves complete injection
153
+ behind `mode="full"`. `memory_export` is paginated and receipt-bearing. See the [MCP reference](docs/MCP.md) for
154
+ profile membership and compatibility details.
103
155
 
104
156
  ## REST API
105
157
 
@@ -123,17 +175,26 @@ API routes use bearer/API-key authentication when configured. See the
123
175
 
124
176
  ## Storage
125
177
 
126
- ### Local clients
178
+ ### Client storage selection
127
179
 
128
- SQLite is authoritative by default. Database selection order is:
180
+ The hosted Mementos API is the ordinary client default. The CLI, MCP server,
181
+ and SDK resolve the hosted credential and authority chain described below; if
182
+ no hosted credential resolves, client data commands fail closed rather than
183
+ opening or creating SQLite automatically.
129
184
 
130
- 1. `HASNA_MEMENTOS_DB_PATH` or `MEMENTOS_DB_PATH`.
131
- 2. The nearest existing `.mementos/mementos.db` walking up from the current directory.
132
- 3. Git-root `.mementos/mementos.db` when `MEMENTOS_DB_SCOPE=project`.
133
- 4. `~/.hasna/mementos/mementos.db`.
185
+ SQLite is available only through an explicit local opt-in:
186
+
187
+ ```bash
188
+ # Use the standard local data root (~/.hasna/mementos/mementos.db).
189
+ export HASNA_MEMENTOS_LOCAL=1
190
+
191
+ # Or select one exact SQLite file explicitly.
192
+ export HASNA_MEMENTOS_DB_PATH=/absolute/path/to/mementos.db
193
+ ```
134
194
 
135
- Legacy `~/.mementos` data is copied to `~/.hasna/mementos` when the new directory
136
- does not yet exist.
195
+ `MEMENTOS_LOCAL=1` and `MEMENTOS_DB_PATH` are compatibility aliases. Legacy
196
+ `~/.mementos` data is considered for migration only after local mode has been
197
+ selected explicitly; it is never an automatic client fallback.
137
198
 
138
199
  ### Server backend and HTTP clients
139
200
 
@@ -0,0 +1,87 @@
1
+ /**
2
+ * Pure public contract for the immutable Mementos audit log.
3
+ *
4
+ * This module deliberately has no storage, credential, transport, filesystem,
5
+ * or server dependencies so the SDK and hosted client can validate the exact
6
+ * same versioned receipts without pulling SQLite into client bundles.
7
+ */
8
+ export declare const AUDIT_TRAIL_CONTRACT: "mementos.audit.trail.v1";
9
+ export declare const AUDIT_EXPORT_CONTRACT: "mementos.audit.export.v1";
10
+ export declare const AUDIT_STATS_CONTRACT: "mementos.audit.stats.v1";
11
+ export declare const AUDIT_CURSOR_VERSION: 1;
12
+ export declare const AUDIT_DEFAULT_LIMIT: 50;
13
+ export declare const AUDIT_OPERATIONS: readonly ["create", "update", "delete", "archive", "restore", "read"];
14
+ export type AuditOperation = (typeof AUDIT_OPERATIONS)[number];
15
+ export type AuditPageContract = typeof AUDIT_TRAIL_CONTRACT | typeof AUDIT_EXPORT_CONTRACT;
16
+ export interface AuditEntry {
17
+ id: string;
18
+ memory_id: string;
19
+ memory_key: string | null;
20
+ operation: AuditOperation;
21
+ agent_id: string | null;
22
+ /** md5 hex digest of the value before the operation, or null when unavailable. */
23
+ old_value_hash: string | null;
24
+ /** md5 hex digest of the value after the operation, or null when unavailable. */
25
+ new_value_hash: string | null;
26
+ changes: Record<string, unknown>;
27
+ created_at: string;
28
+ }
29
+ export interface AuditFilters {
30
+ memory_id: string | null;
31
+ since: string | null;
32
+ until: string | null;
33
+ operation: AuditOperation | null;
34
+ agent_id: string | null;
35
+ }
36
+ export interface AuditPage {
37
+ contract: AuditPageContract;
38
+ entries: AuditEntry[];
39
+ count: number;
40
+ total: number;
41
+ limit: number;
42
+ cursor: string | null;
43
+ next_cursor: string | null;
44
+ consumed: number;
45
+ has_more: boolean;
46
+ complete: boolean;
47
+ snapshot_at: string;
48
+ filters: AuditFilters;
49
+ sort: {
50
+ field: "created_at";
51
+ direction: "desc";
52
+ tie_breaker: "id";
53
+ };
54
+ }
55
+ export interface AuditStats {
56
+ contract: typeof AUDIT_STATS_CONTRACT;
57
+ total_entries: number;
58
+ by_operation: Record<AuditOperation, number>;
59
+ recent_24h: number;
60
+ snapshot_at: string;
61
+ }
62
+ export interface AuditCursorPayload {
63
+ v: typeof AUDIT_CURSOR_VERSION;
64
+ contract: AuditPageContract;
65
+ snapshot_created_at: string | null;
66
+ snapshot_id: string | null;
67
+ after_created_at: string | null;
68
+ after_id: string | null;
69
+ snapshot_total: number;
70
+ consumed: number;
71
+ filter_fingerprint: string;
72
+ }
73
+ export declare class AuditContractError extends Error {
74
+ readonly code = "MEMENTOS_AUDIT_CONTRACT";
75
+ constructor(message: string);
76
+ }
77
+ export declare function canonicalAuditTimestamp(value: unknown, label: string): string;
78
+ export declare function auditOperation(value: unknown, label?: string): AuditOperation;
79
+ export declare function validateAuditEntry(value: unknown, label?: string): AuditEntry;
80
+ export declare function validateAuditPage(value: unknown, expected: {
81
+ contract: AuditPageContract;
82
+ cursor: string | null;
83
+ filters: AuditFilters;
84
+ limit: number;
85
+ }): AuditPage;
86
+ export declare function validateAuditStats(value: unknown): AuditStats;
87
+ //# sourceMappingURL=audit-contract.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"audit-contract.d.ts","sourceRoot":"","sources":["../src/audit-contract.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4N5D"}
1
+ {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyBzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsP5D"}
@@ -1 +1 @@
1
- {"version":3,"file":"consolidation.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/consolidation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BzC,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+GpE"}
1
+ {"version":3,"file":"consolidation.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/consolidation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BzC,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiHpE"}
@@ -1 +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"}
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,CAgJ7D"}
@@ -1 +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;AAkBzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyF7D"}
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;AA2BzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoI7D"}
@@ -1 +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"}
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;AAuIzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiI5D"}
@@ -1 +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;AAazC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiD5D"}
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;AAmBzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4E5D"}
@@ -1 +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"}
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;AA8FzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsN7D"}
@@ -1 +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;AA2CzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAosB3D"}
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;AA4CzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAssB3D"}
@@ -1,3 +1,28 @@
1
1
  import type { Command } from "commander";
2
+ import type { Memory } from "../../types/index.js";
3
+ export declare const STRUCTURED_PAGE_MAX_ROWS = 1000;
4
+ export declare const STRUCTURED_ALL_MAX_ROWS = 100000;
5
+ export declare const STRUCTURED_DEFAULT_MAX_BYTES: number;
6
+ export declare const STRUCTURED_FULL_MAX_BYTES: number;
7
+ export declare const STRUCTURED_ALL_MAX_BYTES: number;
8
+ export type StructuredMemoryDetail = "compact" | "full";
9
+ export declare function structuredMaxBytes(value: unknown, opts: {
10
+ all: boolean;
11
+ detail: StructuredMemoryDetail;
12
+ }): number;
13
+ export declare function compactMemoryForStructuredOutput(memory: Memory, opts?: {
14
+ history?: boolean;
15
+ }): Record<string, unknown>;
16
+ export declare function structuredMemoryOutput(args: {
17
+ memories: Memory[];
18
+ receipt: string;
19
+ offset: number;
20
+ limit: number;
21
+ sourceHasMore: boolean;
22
+ all: boolean;
23
+ detail: StructuredMemoryDetail;
24
+ maxBytes: number;
25
+ history?: boolean;
26
+ }): string;
2
27
  export declare function registerListCommand(program: Command): void;
3
28
  //# sourceMappingURL=memory-cmd-list.d.ts.map
@@ -1 +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"}
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;AAKzC,OAAO,KAAK,EAAE,MAAM,EAA2D,MAAM,sBAAsB,CAAC;AAkB5G,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAC9C,eAAO,MAAM,uBAAuB,SAAU,CAAC;AAC/C,eAAO,MAAM,4BAA4B,QAAY,CAAC;AACtD,eAAO,MAAM,yBAAyB,QAAY,CAAC;AACnD,eAAO,MAAM,wBAAwB,QAAmB,CAAC;AAGzD,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"}
@@ -1 +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;AAYzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8F5D"}
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;AAYzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgG5D"}
@@ -1 +1 @@
1
- {"version":3,"file":"memory-cmd-remove.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory-cmd-remove.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoD5D"}
1
+ {"version":3,"file":"memory-cmd-remove.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory-cmd-remove.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsD5D"}
@@ -1 +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;AAsBzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyJ5D"}
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;AA+BzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8L5D"}
@@ -1 +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;AAsBzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsM3D"}
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;AAuBzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyM3D"}
@@ -1 +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;AAMzC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2C/D"}
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;AAMzC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4C/D"}
@@ -1 +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"}
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;AA+CzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsd9D"}
@@ -1 +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"}
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,CAmI7D"}
@@ -1 +1 @@
1
- {"version":3,"file":"system-status.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/system-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBzC;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,UAAU,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,cAAc,CAAC;IAC7C,4EAA4E;IAC5E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAUD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,MAA4B,GAAG;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAuD3H;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6C5D"}
1
+ {"version":3,"file":"system-status.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/system-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBzC;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,UAAU,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,cAAc,CAAC;IAC7C,4EAA4E;IAC5E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAUD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,MAA4B,GAAG;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CA0D3H;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6C5D"}
@@ -1 +1 @@
1
- {"version":3,"file":"system-synthesized-profile.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/system-synthesized-profile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsDxE"}
1
+ {"version":3,"file":"system-synthesized-profile.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/system-synthesized-profile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwDxE"}
@@ -9,6 +9,8 @@ export declare function colorImportance(importance: number): string;
9
9
  export declare function colorEntityType(type: string, suffix?: string): string;
10
10
  export declare function resolveEntityArg(nameOrId: string, type?: EntityType): Entity;
11
11
  export declare function outputJson(data: unknown): void;
12
+ /** Emit terminal JSON and preserve the requested exit status after drain. */
13
+ export declare function outputJsonAndExit(data: unknown, code: number): Promise<never>;
12
14
  export declare const DEFAULT_COMPACT_LIMIT = 20;
13
15
  export declare const DEFAULT_SEARCH_LIMIT = 10;
14
16
  export declare const DEFAULT_SNIPPET_LENGTH = 72;
@@ -70,7 +72,7 @@ export declare function formatMemoryLine(m: Memory, opts?: {
70
72
  preferSummary?: boolean;
71
73
  }): string;
72
74
  export declare function formatMemoryDetail(m: Memory): string;
73
- export declare function makeHandleError(program: Command): (e: unknown) => never;
75
+ export declare function makeHandleError(program: Command): (e: unknown) => Promise<never> | never;
74
76
  export declare function resolveMemoryId(partialId: string): string;
75
77
  /**
76
78
  * Resolve an `--agent` filter value to the agent id the store actually indexes.
@@ -1 +1 @@
1
- {"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/cli/helpers.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/cli/helpers.ts"],"names":[],"mappings":"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"}