@3ngram/server 1.3.0 → 1.4.2

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.
@@ -8,9 +8,9 @@
8
8
  // (packages/schema Zod), call the COMPLETE core service (which runs withTenant
9
9
  // internally), shape the structured result. A read -> requiredScope
10
10
  // memory:read; runTool enforces the scope BEFORE the handler runs.
11
- import { applyPolicyToScopeFilter, searchDashboardPage } from '@3ngram/core';
11
+ import { applyPolicyToScopeFilter, searchChronological, searchDashboardPage, } from '@3ngram/core';
12
12
  import { MEMORY_READ_SCOPE } from '@3ngram/core/auth';
13
- import { searchQueryV3Schema, searchToolOutputV3Schema, } from '@3ngram/schema';
13
+ import { searchQueryV4Schema, searchToolOutputV3Schema, } from '@3ngram/schema';
14
14
  import { decodeSearchCursor, encodeCursor, searchFingerprint } from '../cursor.js';
15
15
  import { parseOutput } from '../output-validation.js';
16
16
  import { READ_ONLY_ANNOTATIONS } from './tool-annotations.js';
@@ -72,7 +72,13 @@ function toFilters(input) {
72
72
  * the interesting ids with get_memories.
73
73
  */
74
74
  function projectHit(hit, projection) {
75
- const compact = { id: hit.id, memoryType: hit.memoryType, topic: hit.topic, score: hit.score };
75
+ const compact = {
76
+ id: hit.id,
77
+ memoryType: hit.memoryType,
78
+ topic: hit.topic,
79
+ score: hit.score,
80
+ superseded: hit.superseded,
81
+ };
76
82
  if (projection === 'compact')
77
83
  return compact;
78
84
  return {
@@ -83,51 +89,186 @@ function projectHit(hit, projection) {
83
89
  };
84
90
  }
85
91
  /**
86
- * search — unified fused retrieval (docs/concepts/mcp-design.mdx JTBD "find what I know").
87
- * Requires a configured embedding gateway: core embeds the query and THROWS
88
- * without an embedding source, so absent a gateway the tool returns a clear
89
- * typed error rather than a 500. The input contract is the V3 composition
90
- * ({@link searchQueryV3Schema}, hard rule 2): query + limit, the candidate-
91
- * narrowing filters (V1 memoryType/scope/project/status/asOf + V2
92
- * memoryTypes[]/recordedAfter/recordedBefore), and the continuation pair —
93
- * `cursor` (opaque frozen-ordering token) + `projection` (full/compact). Each
94
- * filter NARROWS the candidate set BEFORE fusion; none alters the fusion
95
- * weights or the supersession ranking (docs/concepts/memory-model.mdx
96
- * live-first stays the default). The tool registers the FULL `.strict()`
97
- * object (not its raw shape), so the SDK parses inbound args strictly at the
98
- * transport boundary and an UNKNOWN key is REJECTED there — never silently
99
- * dropped.
100
- *
101
- * PAGINATION routes through the SAME frozen-ordering machinery the dashboard
102
- * uses (core searchDashboardPage + the shared ../cursor.js codec): page 1 ranks
103
- * the bounded candidate pool once and freezes the ordering into `nextCursor`;
104
- * a continuation pages BY POSITION within it (fetchHitsByIds), immune to
105
- * duplicate/skip under mid-walk corpus drift. Page-1 ranking is identical to
106
- * the pre-cursor path (returnFullPool ranks the same pool), so the eval floors
107
- * are untouched. A garbled cursor throws a ZodError -> runTool's ladder labels
108
- * it invalid input (never a 500); a stale pre-v2 cursor decodes to undefined
109
- * and restarts at page 1. The cursor is BOUND to the query+filters that issued
92
+ * Ranked (relevance-order) search: the shipped fused-retrieval path, byte-
93
+ * compatible with the pre-V4 tool behavior. PAGINATION routes through the
94
+ * SAME frozen-ordering machinery the dashboard uses (core searchDashboardPage
95
+ * + the shared ../cursor.js codec): page 1 ranks the bounded candidate pool
96
+ * once and freezes the ordering into `nextCursor`; a continuation pages BY
97
+ * POSITION within it (fetchHitsByIds), immune to duplicate/skip under
98
+ * mid-walk corpus drift. The cursor is BOUND to the query+filters that issued
110
99
  * it (the shared codec's fingerprint, verified in decodeSearchCursor): a
111
- * continuation under a CHANGED query/filters is a typed
112
- * CursorQueryMismatchError -> invalid_input, never a silent re-page of the old
113
- * search's frozen ordering. Fingerprint-less cursors minted before the binding
114
- * stay valid (verify-when-present).
100
+ * continuation under a CHANGED query/filters is a typed CursorQueryMismatchError
101
+ * -> invalid_input, never a silent re-page of the old search's frozen
102
+ * ordering. Fingerprint-less cursors minted before the binding stay valid
103
+ * (verify-when-present); the fingerprint computation here is BYTE-IDENTICAL
104
+ * to the pre-V4 tool (no `order` folded in), so a cursor minted before
105
+ * chronological order existed keeps verifying.
106
+ */
107
+ async function handleRelevanceSearch(input, filters, policyScope, retrievalPolicy, ctx) {
108
+ if (ctx.gateway === undefined) {
109
+ return fail('embedding gateway not configured');
110
+ }
111
+ const fingerprint = searchFingerprint(input.query, filters, policyScope.scope, policyScope.appliedScope !== null);
112
+ const decodedRaw = input.cursor === undefined ? undefined : decodeSearchCursor(input.cursor, fingerprint);
113
+ // Relevance (ranked) search only ever mints/consumes the v2 frozen-ordering
114
+ // cursor — the v3 chronological keyset cursor belongs to order:
115
+ // 'chronological' only. A well-formed v3 token is NEVER reachable here at
116
+ // all: cursorPayloadV3Schema requires `fp` (packages/schema/src/cursor.ts —
117
+ // v3 has no legacy fp-less tokens to carve out, unlike v2), so
118
+ // decodeSearchCursor above has ALREADY thrown a typed mismatch for any real
119
+ // v3 token (its fingerprint folds in `order: 'chronological'`, which a
120
+ // relevance fingerprint never does, so the hashes can never coincidentally
121
+ // collide). This shape guard is therefore UNREACHABLE for any cursor that
122
+ // successfully decodes — it stays purely as defense in depth (the same
123
+ // two-layer posture this codebase applies elsewhere) against a malformed or
124
+ // hand-crafted v3-shaped payload reaching this line: without it, `.ids`/
125
+ // `.scores` below would read as `undefined` off the wrong shape instead of
126
+ // restarting cleanly at page 1.
127
+ const decoded = decodedRaw !== undefined && decodedRaw.v === 2 ? decodedRaw : undefined;
128
+ const frozen = decoded === undefined
129
+ ? undefined
130
+ : {
131
+ ids: decoded.ids,
132
+ scores: decoded.scores,
133
+ off: decoded.off,
134
+ ...(decoded.policyScope === undefined ? {} : { policyScope: decoded.policyScope }),
135
+ };
136
+ const page = await searchDashboardPage(ctx.userId, input.query, { gateway: ctx.gateway }, defined({
137
+ limit: input.limit,
138
+ filters,
139
+ frozen,
140
+ budget: ctx.budget,
141
+ retrievalPolicy,
142
+ }));
143
+ // Emit a cursor ONLY when a further page exists (searchToolOutputV2Schema
144
+ // ENFORCES nextCursor <-> hasMore, so a drifting pair can never ship).
145
+ const nextCursor = page.hasMore
146
+ ? encodeCursor({
147
+ v: 2,
148
+ ids: page.frozen.ids,
149
+ scores: page.frozen.scores,
150
+ off: page.nextOffset,
151
+ fp: fingerprint,
152
+ policyScope: page.frozen.policyScope,
153
+ })
154
+ : undefined;
155
+ const output = parseOutput('search', searchToolOutputV3Schema, defined({
156
+ hits: page.hits.map((hit) => projectHit(hit, input.projection)),
157
+ count: page.hits.length,
158
+ hasMore: page.hasMore,
159
+ nextCursor,
160
+ // Present exactly when the policy narrowed this call (never silent);
161
+ // omitted otherwise so an off/no-policy response stays byte-identical.
162
+ appliedScope: page.appliedScope ?? undefined,
163
+ }));
164
+ return ok(output);
165
+ }
166
+ /**
167
+ * Chronological (list-mode) search: an exhaustive, unranked recorded_at DESC
168
+ * enumeration (packages/core/src/read/search-list.ts). Skips the embedding
169
+ * gateway ENTIRELY — no gateway call, no query-embed cost row — and skips the
170
+ * abstention path by construction: nothing here ever reads `vectorScore`
171
+ * (that field only exists on the ranked path's hits), so there is no cosine
172
+ * signal to abstain on.
173
+ *
174
+ * The v3 keyset cursor (recordedAt, id) is DRIFT-FREE, unlike the ranked
175
+ * path's frozen-pool cursor, so it needs no frozen candidate set — tiny by
176
+ * comparison. `recordedAt` is OPAQUE full-precision text, never a JS `Date`
177
+ * (packages/db/src/search-list.ts's ChronologicalCursor doc: a `Date` cannot
178
+ * represent Postgres's microsecond resolution, and truncating it can silently
179
+ * strand rows that tie on a same-transaction timestamp). Its fingerprint
180
+ * folds `order: 'chronological'` into the hashed filter set, which the ranked
181
+ * path's fingerprint (byte-identical to pre-V4) does NOT do — so a v2
182
+ * (ranked) cursor carrying `fp`, replayed here, is REJECTED as a typed
183
+ * CursorQueryMismatchError (invalid_input) by decodeSearchCursor, never
184
+ * silently misread. Only a fingerprint-LESS LEGACY v2 token (pre-binding,
185
+ * before `fp` existed) skips that check and reaches the shape guard below —
186
+ * v3 has no fp-less analogue, since `fp` is REQUIRED on cursorPayloadV3Schema
187
+ * (packages/schema/src/cursor.ts: v3 is introduced in this same change, so no
188
+ * legacy fp-less v3 token has ever legitimately existed).
189
+ */
190
+ async function handleChronologicalSearch(input, filters, policyScope, retrievalPolicy, ctx) {
191
+ const fingerprint = searchFingerprint(
192
+ // PINNED EMPTY, not `input.query ?? ''`: the V4 chronological variant
193
+ // REJECTS a present `query` at the schema boundary, so nothing can reach
194
+ // here with one. Reading the field would imply a query leg this ordering
195
+ // does not have and would let a fingerprint vary on an input that cannot
196
+ // exist — the constant keeps the hashed identity exactly the filter set.
197
+ '', { ...filters, order: 'chronological' }, policyScope.scope, policyScope.appliedScope !== null);
198
+ const decodedRaw = input.cursor === undefined ? undefined : decodeSearchCursor(input.cursor, fingerprint);
199
+ // UNLIKE the relevance handler's symmetric guard, this shape check IS
200
+ // reachable in a legitimate case: a fingerprint-LESS LEGACY v2 token
201
+ // (minted before `fp` existed) skips decodeSearchCursor's mismatch check
202
+ // entirely (verify-when-present) and reaches here with `v: 2` — `decoded`
203
+ // correctly resolves to undefined (restart at page 1) rather than
204
+ // misreading a v2 payload's `ids`/`scores` shape as `recordedAt`/`id`. A
205
+ // well-formed v3 token can never reach this branch already-mismatched: `fp`
206
+ // is required on it (packages/schema/src/cursor.ts), so any real v3 token
207
+ // either matches (falls through, `v: 3`) or was already rejected above.
208
+ const decoded = decodedRaw !== undefined && decodedRaw.v === 3 ? decodedRaw : undefined;
209
+ // recordedAt is OPAQUE full-precision text end to end — NEVER parsed
210
+ // through `new Date()` here, which would floor it to millisecond precision
211
+ // and could silently re-admit rows a same-transaction batch insert already
212
+ // returned (see db/search-list.ts's ChronologicalCursor doc for the full
213
+ // mechanism this must not reintroduce).
214
+ const cursor = decoded === undefined ? undefined : { recordedAt: decoded.recordedAt, id: decoded.id };
215
+ const page = await searchChronological(ctx.userId, defined({
216
+ limit: input.limit,
217
+ filters,
218
+ cursor,
219
+ retrievalPolicy,
220
+ }));
221
+ const nextCursor = page.hasMore && page.nextCursor !== undefined
222
+ ? encodeCursor({
223
+ v: 3,
224
+ recordedAt: page.nextCursor.recordedAt,
225
+ id: page.nextCursor.id,
226
+ fp: fingerprint,
227
+ })
228
+ : undefined;
229
+ const output = parseOutput('search', searchToolOutputV3Schema, defined({
230
+ hits: page.hits.map((hit) => projectHit(hit, input.projection)),
231
+ count: page.hits.length,
232
+ hasMore: page.hasMore,
233
+ nextCursor,
234
+ appliedScope: page.appliedScope ?? undefined,
235
+ }));
236
+ return ok(output);
237
+ }
238
+ /**
239
+ * search — unified fused retrieval (docs/concepts/mcp-design.mdx JTBD "find what I know"),
240
+ * plus an exhaustive chronological list mode. The input contract is the V4
241
+ * composition ({@link searchQueryV4Schema}, hard rule 2): query + limit, the
242
+ * candidate-narrowing filters (V1 memoryType/scope/project/status/asOf + V2
243
+ * memoryTypes[]/recordedAfter/recordedBefore), the continuation pair —
244
+ * `cursor` (opaque token) + `projection` (full/compact) — and `order`
245
+ * (relevance default | chronological). Each filter NARROWS the candidate set
246
+ * BEFORE fusion/ordering; none alters the fusion weights or the supersession
247
+ * ranking (docs/concepts/memory-model.mdx live-first stays the default). The
248
+ * tool registers the FULL `.strict()` object (not its raw shape), so the SDK
249
+ * parses inbound args strictly at the transport boundary and an UNKNOWN key
250
+ * is REJECTED there — never silently dropped.
251
+ *
252
+ * `order: 'relevance'` (default) requires a gateway-configured embedding
253
+ * source and a `query`; `order: 'chronological'` requires NEITHER — it never
254
+ * calls the gateway, and it REJECTS a `query` outright (this path ranks
255
+ * nothing, so a query could only be ignored) while requiring >=1 filter to
256
+ * bound the scan. The two orders mint DIFFERENT cursor shapes (see
257
+ * {@link handleRelevanceSearch} / {@link handleChronologicalSearch}); each
258
+ * rejects/restarts on the other's cursor rather than misreading it.
115
259
  */
116
260
  const searchTool = {
117
261
  name: 'search',
118
262
  requiredScope: MEMORY_READ_SCOPE,
119
263
  config: {
120
264
  title: 'Search',
121
- description: 'Unified semantic + keyword retrieval over your memories, supersession-aware. Accepts a query and an optional result limit, plus optional filters that narrow the candidate set BEFORE fusion (no change to ranking weights): memoryType OR memoryTypes (a list of types, mutually exclusive with memoryType), scope, project, status, asOf (bi-temporal time travel with validAt/asKnownAt), and recordedAfter/recordedBefore (an inclusive recorded-at range over the live view — not time travel). Omit a filter to leave that axis unconstrained. If a retrieval-scope policy is set (configure_scope set_retrieval_default), an unscoped search may be narrowed to your default scope (the result then reports appliedScope) or rejected until you pass a scope filter. Hit content is a bounded excerpt — when a hit reports truncated: true, call get_memories with its id to read the full content. To page: pass nextCursor back as cursor with the SAME query and filters; pages come from the ordering frozen on the first page, so a mid-walk write or archive can never duplicate or skip a hit. The cursor is bound to the query and filters that issued it: passing it with a changed query or filters is rejected as invalid input — omit the cursor to start a new search. The cursor token is a real context cost (~4-6 KB — it carries the frozen ids+scores of the candidate pool), so page only when you actually need more hits. Paging stops at the frozen pool: hasMore: false means the pool is exhausted — refine the query (better filters, more specific terms) instead of paging harder. For broad scans set projection: "compact" to omit content/contentLength/truncated per hit (~5x fewer tokens), then batch-fetch the interesting ids with get_memories.',
122
- inputSchema: searchQueryV3Schema,
265
+ description: 'Unified semantic + keyword retrieval over your memories, supersession-aware. Accepts a query and an optional result limit, plus optional filters that narrow the candidate set BEFORE fusion (no change to ranking weights): memoryType OR memoryTypes (a list of types, mutually exclusive with memoryType), scope, project, status, asOf (bi-temporal time travel with validAt/asKnownAt), and recordedAfter/recordedBefore (an inclusive recorded-at range over the live view — not time travel). Omit a filter to leave that axis unconstrained. Set order: "chronological" for an exhaustive, unranked recorded_at-descending listing instead of the fused ranking — no embedding call, no gateway required; query is RELEVANCE-ONLY and is rejected in chronological order (that mode ranks nothing, so a query could only be ignored), and chronological instead REQUIRES at least one filter to bound the scan. Default order "relevance" is the fused ranked search and still requires a query. If a retrieval-scope policy is set (configure_scope set_retrieval_default), an unscoped search may be narrowed to your default scope (the result then reports appliedScope) or rejected until you pass a scope filter. Hit content is a bounded excerpt — when a hit reports truncated: true, call get_memories with its id to read the full content. Superseded predecessors are never filtered out, only ranked below their successor — a hit reports superseded: true when it is one, so you can tell a demoted result from a current one; superseded is recomputed live on every page (including continuations of a frozen relevance walk), so a hit\'s rank and score stay frozen across pages of one walk but its superseded flag can still flip if it is revised mid-session. To page: pass nextCursor back as cursor with the SAME query, filters, and order; pages come from the ordering frozen (relevance) or the keyset position (chronological) on the first page, so a mid-walk write or archive can never duplicate or skip a hit. The cursor is bound to the query, filters, and order that issued it: passing it with any of those changed is rejected as invalid input — omit the cursor to start a new search. The relevance cursor token is a real context cost (~4-6 KB — it carries the frozen ids+scores of the candidate pool); the chronological cursor is tiny (a single row position) by comparison. Paging stops at the frozen pool (relevance) or the live corpus (chronological): hasMore: false means there is nothing more to page to. For broad scans set projection: "compact" to omit content/contentLength/truncated per hit (~5x fewer tokens), then batch-fetch the interesting ids with get_memories.',
266
+ inputSchema: searchQueryV4Schema,
123
267
  outputSchema: searchToolOutputV3Schema,
124
268
  annotations: READ_ONLY_ANNOTATIONS,
125
269
  },
126
270
  async handler(args, ctx) {
127
- if (ctx.gateway === undefined) {
128
- return fail('embedding gateway not configured');
129
- }
130
- const input = searchQueryV3Schema.parse(args);
271
+ const input = searchQueryV4Schema.parse(args);
131
272
  const filters = toFilters(input);
132
273
  // Assert platform read access before policy resolution performs its tenant
133
274
  // lookup. The core call is therefore not given the gate a second time.
@@ -136,54 +277,14 @@ const searchTool = {
136
277
  // RETRIEVAL-SCOPE POLICY (issue #47): resolved at most once per request
137
278
  // (the route's memoized thunk) and INJECTED into core, which owns the
138
279
  // enforcement (default fills a missing scope filter; require throws the
139
- // typed UnscopedRetrievalError mapped by errors.ts).
280
+ // typed UnscopedRetrievalError mapped by errors.ts). Shared across both
281
+ // order branches so neither pays a second lookup.
140
282
  const retrievalPolicy = ctx.retrievalPolicy === undefined ? undefined : await ctx.retrievalPolicy();
141
283
  const policyScope = applyPolicyToScopeFilter(retrievalPolicy, filters.scope);
142
- // Frozen-ordering continuation: a malformed token throws here (client
143
- // input, mapped by runTool); a legacy token restarts at page 1. The
144
- // fingerprint binds the cursor to THIS query+filter set — a cursor
145
- // replayed under a changed query/filters throws the typed mismatch
146
- // (mapped to invalid_input), never silently paging the old frozen ids.
147
- // Fingerprint-less cursors stay valid (verify-when-present).
148
- const fingerprint = searchFingerprint(input.query, filters, policyScope.scope, policyScope.appliedScope !== null);
149
- const decoded = input.cursor === undefined ? undefined : decodeSearchCursor(input.cursor, fingerprint);
150
- const frozen = decoded === undefined
151
- ? undefined
152
- : {
153
- ids: decoded.ids,
154
- scores: decoded.scores,
155
- off: decoded.off,
156
- ...(decoded.policyScope === undefined ? {} : { policyScope: decoded.policyScope }),
157
- };
158
- const page = await searchDashboardPage(ctx.userId, input.query, { gateway: ctx.gateway }, defined({
159
- limit: input.limit,
160
- filters,
161
- frozen,
162
- budget: ctx.budget,
163
- retrievalPolicy,
164
- }));
165
- // Emit a cursor ONLY when a further page exists (searchToolOutputV2Schema
166
- // ENFORCES nextCursor <-> hasMore, so a drifting pair can never ship).
167
- const nextCursor = page.hasMore
168
- ? encodeCursor({
169
- v: 2,
170
- ids: page.frozen.ids,
171
- scores: page.frozen.scores,
172
- off: page.nextOffset,
173
- fp: fingerprint,
174
- policyScope: page.frozen.policyScope,
175
- })
176
- : undefined;
177
- const output = parseOutput('search', searchToolOutputV3Schema, defined({
178
- hits: page.hits.map((hit) => projectHit(hit, input.projection)),
179
- count: page.hits.length,
180
- hasMore: page.hasMore,
181
- nextCursor,
182
- // Present exactly when the policy narrowed this call (never silent);
183
- // omitted otherwise so an off/no-policy response stays byte-identical.
184
- appliedScope: page.appliedScope ?? undefined,
185
- }));
186
- return ok(output);
284
+ if (input.order === 'chronological') {
285
+ return handleChronologicalSearch(input, filters, policyScope, retrievalPolicy, ctx);
286
+ }
287
+ return handleRelevanceSearch(input, filters, policyScope, retrievalPolicy, ctx);
187
288
  },
188
289
  };
189
290
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"tools-search.js","sourceRoot":"","sources":["../../src/mcp/tools-search.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,8EAA8E;AAC9E,4EAA4E;AAC5E,+EAA+E;AAC/E,uCAAuC;AACvC,EAAE;AACF,yEAAyE;AACzE,+EAA+E;AAC/E,oEAAoE;AACpE,mEAAmE;AACnE,OAAO,EAAE,wBAAwB,EAAkB,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAIL,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAG7D;;;;;GAKG;AACH,SAAS,EAAE,CAAC,UAAmC;IAC7C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7D,iBAAiB,EAAE,UAAU;KAC9B,CAAA;AACH,CAAC;AAED,mFAAmF;AACnF,SAAS,IAAI,CAAC,OAAe;IAC3B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AACtE,CAAC;AAED,mFAAmF;AACnF,SAAS,OAAO,CACd,GAAM;IAEN,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAE/E,CAAA;AACH,CAAC;AAED,mFAAmF;AACnF,SAAS,MAAM,CAAC,KAAyB;IACvC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAA;AAC1D,CAAC;AAED,SAAS,MAAM,CAAC,IAA2B;IACzC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACxC,OAAO,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;AACtF,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,SAAS,CAAC,KAAyB;IAC1C,OAAO,OAAO,CAAC;QACb,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC;QAC1C,cAAc,EAAE,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC;KAC7C,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,UAAU,CAAC,GAAc,EAAE,UAA4B;IAC9D,MAAM,OAAO,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAA;IAC9F,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,OAAO,CAAA;IAC5C,OAAO;QACL,GAAG,OAAO;QACV,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,GAAmB;IACjC,IAAI,EAAE,QAAQ;IACd,aAAa,EAAE,iBAAiB;IAChC,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ;QACf,WAAW,EACT,4rDAA4rD;QAC9rD,WAAW,EAAE,mBAAmB;QAChC,YAAY,EAAE,wBAAwB;QACtC,WAAW,EAAE,qBAAqB;KACnC;IACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG;QACrB,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,kCAAkC,CAAC,CAAA;QACjD,CAAC;QACD,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC7C,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;QAChC,2EAA2E;QAC3E,uEAAuE;QACvE,IAAI,GAAG,CAAC,MAAM;YAAE,MAAM,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACvD,wEAAwE;QACxE,sEAAsE;QACtE,wEAAwE;QACxE,qDAAqD;QACrD,MAAM,eAAe,GACnB,GAAG,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,eAAe,EAAE,CAAA;QAC7E,MAAM,WAAW,GAAG,wBAAwB,CAAC,eAAe,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;QAC5E,sEAAsE;QACtE,oEAAoE;QACpE,mEAAmE;QACnE,mEAAmE;QACnE,uEAAuE;QACvE,6DAA6D;QAC7D,MAAM,WAAW,GAAG,iBAAiB,CACnC,KAAK,CAAC,KAAK,EACX,OAAO,EACP,WAAW,CAAC,KAAK,EACjB,WAAW,CAAC,YAAY,KAAK,IAAI,CAClC,CAAA;QACD,MAAM,OAAO,GACX,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;QACxF,MAAM,MAAM,GACV,OAAO,KAAK,SAAS;YACnB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC;gBACE,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;aACnF,CAAA;QACP,MAAM,IAAI,GAAG,MAAM,mBAAmB,CACpC,GAAG,CAAC,MAAM,EACV,KAAK,CAAC,KAAK,EACX,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,EACxB,OAAO,CAAC;YACN,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO;YACP,MAAM;YACN,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,eAAe;SAChB,CAAC,CACH,CAAA;QACD,0EAA0E;QAC1E,uEAAuE;QACvE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO;YAC7B,CAAC,CAAC,YAAY,CAAC;gBACX,CAAC,EAAE,CAAC;gBACJ,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG;gBACpB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;gBAC1B,GAAG,EAAE,IAAI,CAAC,UAAU;gBACpB,EAAE,EAAE,WAAW;gBACf,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;aACrC,CAAC;YACJ,CAAC,CAAC,SAAS,CAAA;QACb,MAAM,MAAM,GAAG,WAAW,CACxB,QAAQ,EACR,wBAAwB,EACxB,OAAO,CAAC;YACN,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YAC/D,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU;YACV,qEAAqE;YACrE,uEAAuE;YACvE,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,SAAS;SAC7C,CAAC,CACH,CAAA;QACD,OAAO,EAAE,CAAC,MAAM,CAAC,CAAA;IACnB,CAAC;CACF,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAA8B,CAAC,UAAU,CAAC,CAAA"}
1
+ {"version":3,"file":"tools-search.js","sourceRoot":"","sources":["../../src/mcp/tools-search.ts"],"names":[],"mappings":"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"}
@@ -86,10 +86,10 @@ export interface ToolContext {
86
86
  retrievalPolicy?: (() => Promise<RetrievalPolicy>) | undefined;
87
87
  }
88
88
  /**
89
- * THE registered tool surface. Length === registered count; the <=12 cap (hard
90
- * rule 8) is auditable from this one array. D0: 3; D1 adds revise + resolve -> 5;
91
- * D2 orient (briefing, handoff) -> 7; D3 admin (configure_scope,
92
- * describe_environment, review_proposals) -> 10; get_memories (inspect) -> 11.
89
+ * THE registered tool surface. Length === registered count, auditable from this
90
+ * one array (hard rule 8). D0: 3; D1 adds revise + resolve -> 5; D2 orient
91
+ * (briefing, handoff) -> 7; D3 admin (configure_scope, describe_environment,
92
+ * review_proposals) -> 10; get_memories (inspect) -> 11.
93
93
  *
94
94
  * The admin tools are created via a FACTORY given a thunk over {@link TOOLS}, so
95
95
  * describe_environment can report the FULL surface (itself included) without a
@@ -97,8 +97,6 @@ export interface ToolContext {
97
97
  * time, long after this assignment completes.
98
98
  */
99
99
  export declare const TOOLS: readonly ToolDefinition[];
100
- /** Hard ceiling per docs/concepts/mcp-design.mdx / hard rule 8. LEDGER: 11/12 registered; the LAST slot is reserved for the future `manage_context` tool. */
101
- export declare const MAX_TOOLS = 12;
102
100
  /**
103
101
  * Run a tool handler with uniform metrics + typed-error mapping. A KNOWN typed
104
102
  * core error (bad input, missing embedding source) becomes an isError result
package/dist/mcp/tools.js CHANGED
@@ -6,10 +6,14 @@
6
6
  // every core call (which runs withTenant internally) — a tool can only ever
7
7
  // touch the caller's own rows (hard rule 3).
8
8
  //
9
- // TOOL-COUNT DISCIPLINE (docs/concepts/mcp-design.mdx, hard rule 8: <=12): the single {@link
10
- // TOOLS} array is the auditable surface — its length IS the registered tool
11
- // count. D0 ships exactly THREE (remember/search/get_facts); the other seven
12
- // JTBD tools land in later slices.
9
+ // TOOL-SURFACE DISCIPLINE (docs/concepts/mcp-design.mdx, hard rule 8): the single
10
+ // {@link TOOLS} array is the auditable surface — its length IS the registered
11
+ // tool count. There is no numeric ceiling: what a count was ever a proxy for is
12
+ // selection accuracy and description overlap, and those are now MEASURED and
13
+ // gated by eval/src/tool-selection.mjs against eval/fixtures/floors.json. Adding
14
+ // a tool requires a JTBD no existing tool covers, a regenerated surface snapshot,
15
+ // and scenarios in eval/fixtures/tool-selection.json that cover it — a tool whose
16
+ // description blurs into a neighbour's fails the gate.
13
17
  //
14
18
  // Observability (hard rule 6): no memory content, query text, subject/value, or
15
19
  // credential enters a log. A tool error returns a typed isError result to the
@@ -17,7 +21,7 @@
17
21
  import { log, mcpToolCalls, mcpToolErrors } from '@3ngram/config';
18
22
  import { getFacts, remember, resolveByMemoryId, revise, } from '@3ngram/core';
19
23
  import { MEMORY_READ_SCOPE, MEMORY_WRITE_SCOPE } from '@3ngram/core/auth';
20
- import { factsQueryInputSchema, factsToolOutputSchema, MAX_CONTENT_LENGTH, rememberToolInputSchema, rememberToolOutputSchema, resolveToolInputSchema, resolveToolOutputSchema, reviseToolInputSchema, reviseToolOutputSchema, } from '@3ngram/schema';
24
+ import { factsQueryInputV2Schema, factsToolOutputSchema, MAX_CONTENT_LENGTH, rememberToolInputV2Schema, rememberToolOutputV2Schema, resolveToolInputSchema, resolveToolOutputSchema, reviseToolInputSchema, reviseToolOutputSchema, } from '@3ngram/schema';
21
25
  import { parseOutput } from '../output-validation.js';
22
26
  import { mapToolError } from './errors.js';
23
27
  import { READ_ONLY_ANNOTATIONS } from './tool-annotations.js';
@@ -81,6 +85,12 @@ function toAsOf(asOf) {
81
85
  return undefined;
82
86
  return defined({ validAt: toDate(asOf.validAt), asKnownAt: toDate(asOf.asKnownAt) });
83
87
  }
88
+ /** Coerce a range's optional ISO-8601 bounds to Dates for the bi-temporal core query (range read). */
89
+ function toRange(range) {
90
+ if (range === undefined)
91
+ return undefined;
92
+ return defined({ from: toDate(range.from), to: toDate(range.to) });
93
+ }
84
94
  /**
85
95
  * remember — append a memory (docs/concepts/mcp-design.mdx JTBD "persist something worth
86
96
  * keeping"). Validates via the canonical write schema, calls core remember()
@@ -96,9 +106,9 @@ const rememberTool = {
96
106
  requiredScope: MEMORY_WRITE_SCOPE,
97
107
  config: {
98
108
  title: 'Remember',
99
- description: `Append a new memory (decision, fact, preference, blocker, commitment, ...). Never merges; append-only. Content is capped at ${MAX_CONTENT_LENGTH} characters. To surface a commitment or blocker in a PROJECT-scoped briefing, pass \`project\` — a memory written with a NULL project never matches the bare project selector; only the scope_project selector's includeUnscoped: true opts it back in.`,
100
- inputSchema: rememberToolInputSchema,
101
- outputSchema: rememberToolOutputSchema,
109
+ description: `Append a new memory (decision, fact, preference, blocker, commitment, ...). Never merges; append-only. Content is capped at ${MAX_CONTENT_LENGTH} characters. To surface a commitment or blocker in a PROJECT-scoped briefing, pass \`project\` — a memory written with a NULL project never matches the bare project selector; only the scope_project selector's includeUnscoped: true opts it back in. Optionally pass \`facts\`: the measurable claims the memory states, as subject/predicate/value triples that \`get_facts\` can then read back directly instead of re-reading the prose. Values are text, so put the unit in the predicate and keep one measure per fact (subject \`lift.back_squat\`, predicate \`top_set.weight_kg\`, value \`98\`). Give a fact a \`validFrom\` when it became true, if that is not now.`,
110
+ inputSchema: rememberToolInputV2Schema,
111
+ outputSchema: rememberToolOutputV2Schema,
102
112
  // Appends a NEW row on every call, so repeating it is not a no-op —
103
113
  // idempotentHint: false. destructiveHint: false is a real product claim:
104
114
  // remember never merges into or overwrites an existing memory (hard rule 1).
@@ -114,7 +124,7 @@ const rememberTool = {
114
124
  // It returns the new id only, so the structured output echoes the NORMALIZED
115
125
  // write input (scope default + null project applied here) for the rest.
116
126
  // Embedding is on iff a gateway is configured — best-effort, never blocks.
117
- const input = rememberToolInputSchema.parse(args);
127
+ const input = rememberToolInputV2Schema.parse(args);
118
128
  const gatewayOpts = ctx.gateway === undefined
119
129
  ? { access: ctx.access, limits: ctx.limits }
120
130
  : { gateway: ctx.gateway, budget: ctx.budget, access: ctx.access, limits: ctx.limits };
@@ -132,7 +142,7 @@ const rememberTool = {
132
142
  // A commitment-type memory auto-creates an 'open' commitment in the same
133
143
  // write tx; surface its id so the caller can `resolve`
134
144
  // it without a follow-up lookup. Undefined (omitted) for every other type.
135
- const output = parseOutput('remember', rememberToolOutputSchema, defined({
145
+ const output = parseOutput('remember', rememberToolOutputV2Schema, defined({
136
146
  memory: {
137
147
  id: written.id,
138
148
  memoryType: input.memoryType,
@@ -142,28 +152,39 @@ const rememberTool = {
142
152
  },
143
153
  embedded,
144
154
  commitmentId: written.commitmentId,
155
+ // Ids only, and only when facts were written: `defined()` drops the key
156
+ // when undefined, so a write without facts returns the V1 response
157
+ // byte-for-byte. The triples themselves are memory content and are not
158
+ // echoed back (hard rule 6).
159
+ factIds: written.factIds,
145
160
  }));
146
161
  return ok(output);
147
162
  },
148
163
  };
149
164
  /**
150
165
  * get_facts — currently-valid facts for a subject, bi-temporally (docs/concepts/mcp-design.mdx
151
- * JTBD "what is currently true about X"). Calls core getFacts() with the
152
- * subject/predicate filters and the as_of coordinates (ISO strings coerced to
153
- * Date at this boundary).
166
+ * JTBD "what is currently true about X"), OR a chronological time-series read
167
+ * across a valid-time window (`range`). Calls core getFacts() with the
168
+ * subject/predicate filters and either the as_of coordinates or the range
169
+ * bounds (ISO strings coerced to Date at this boundary) — `range` and `asOf`
170
+ * are mutually exclusive, enforced by factsQueryInputV2Schema.
171
+ *
172
+ * get_facts has NO scope axis (issue #47, reaffirmed for the range read): the
173
+ * facts table carries no scope column, so a range read is not policy-enforced
174
+ * either — deliberately deferred again, not silently dropped.
154
175
  */
155
176
  const getFactsTool = {
156
177
  name: 'get_facts',
157
178
  requiredScope: MEMORY_READ_SCOPE,
158
179
  config: {
159
180
  title: 'Get Facts',
160
- description: 'Currently-valid facts for a subject, with optional bi-temporal time travel. List mode (no subject) returns the most recent facts, bounded by an optional limit (default 50, max 200).',
161
- inputSchema: factsQueryInputSchema,
181
+ description: 'Currently-valid facts for a subject, with optional bi-temporal time travel, OR a chronological time-series read across a valid-time window (range: {from?, to?} — half-open [from, to), surfaces superseded generations inside it). range and asOf are mutually exclusive. List/range mode (no subject) returns the most recent (or earliest-in-window) facts, bounded by an optional limit (default 50, max 200).',
182
+ inputSchema: factsQueryInputV2Schema,
162
183
  outputSchema: factsToolOutputSchema,
163
184
  annotations: READ_ONLY_ANNOTATIONS,
164
185
  },
165
186
  async handler(args, ctx) {
166
- const input = factsQueryInputSchema.parse(args);
187
+ const input = factsQueryInputV2Schema.parse(args);
167
188
  // ACCESS GUARD: get_facts is a READ, so read access is asserted BEFORE the db
168
189
  // op (self-host allowAllAccess allows all; back-compat when no gate is wired).
169
190
  // Mirrors search (which asserts this inside core) and the REST /api/v1/facts
@@ -174,6 +195,7 @@ const getFactsTool = {
174
195
  subject: input.subject,
175
196
  predicate: input.predicate,
176
197
  asOf: toAsOf(input.asOf),
198
+ range: toRange(input.range),
177
199
  // Always forward the bounded limit (schema default 50, max 200) so list
178
200
  // mode never returns every fact (no-firehose, docs/concepts/mcp-design.mdx).
179
201
  limit: input.limit,
@@ -187,6 +209,7 @@ const getFactsTool = {
187
209
  confidence: fact.confidence,
188
210
  validFrom: fact.validFrom.toISOString(),
189
211
  validTo: fact.validTo?.toISOString() ?? null,
212
+ recordedAt: fact.recordedAt.toISOString(),
190
213
  })),
191
214
  count: facts.length,
192
215
  });
@@ -309,10 +332,10 @@ const resolveTool = {
309
332
  },
310
333
  };
311
334
  /**
312
- * THE registered tool surface. Length === registered count; the <=12 cap (hard
313
- * rule 8) is auditable from this one array. D0: 3; D1 adds revise + resolve -> 5;
314
- * D2 orient (briefing, handoff) -> 7; D3 admin (configure_scope,
315
- * describe_environment, review_proposals) -> 10; get_memories (inspect) -> 11.
335
+ * THE registered tool surface. Length === registered count, auditable from this
336
+ * one array (hard rule 8). D0: 3; D1 adds revise + resolve -> 5; D2 orient
337
+ * (briefing, handoff) -> 7; D3 admin (configure_scope, describe_environment,
338
+ * review_proposals) -> 10; get_memories (inspect) -> 11.
316
339
  *
317
340
  * The admin tools are created via a FACTORY given a thunk over {@link TOOLS}, so
318
341
  * describe_environment can report the FULL surface (itself included) without a
@@ -336,8 +359,6 @@ export const TOOLS = [
336
359
  // surface (itself included) without a circular import.
337
360
  ...createAdminTools(() => TOOLS.map((t) => t.name)),
338
361
  ];
339
- /** Hard ceiling per docs/concepts/mcp-design.mdx / hard rule 8. LEDGER: 11/12 registered; the LAST slot is reserved for the future `manage_context` tool. */
340
- export const MAX_TOOLS = 12;
341
362
  /**
342
363
  * Run a tool handler with uniform metrics + typed-error mapping. A KNOWN typed
343
364
  * core error (bad input, missing embedding source) becomes an isError result
@@ -1 +1 @@
1
- {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import type { AsOfInput } from '@3ngram/schema';
1
+ import type { AsOfInput, FactsRangeInput } from '@3ngram/schema';
2
2
  import type { Request, Response } from 'express';
3
3
  /** Drop undefined values so exact-optional core parameters remain absent. */
4
4
  export declare function defined<T extends Record<string, unknown>>(obj: T): {
@@ -9,6 +9,11 @@ export declare function toAsOf(asOf: AsOfInput | undefined): {
9
9
  validAt?: Date;
10
10
  asKnownAt?: Date;
11
11
  } | undefined;
12
+ /** Map an optional {from,to} range's ISO bounds to core Date values (range read). */
13
+ export declare function toRange(range: FactsRangeInput | undefined): {
14
+ from?: Date;
15
+ to?: Date;
16
+ } | undefined;
12
17
  /** The authenticated tenant bound by apiOrSessionAuth. */
13
18
  export declare function tenant(req: Request): string;
14
19
  /** Apply the shared typed-error mapping without logging request content. */
@@ -17,6 +17,15 @@ export function toAsOf(asOf) {
17
17
  asKnownAt: asOf.asKnownAt === undefined ? undefined : new Date(asOf.asKnownAt),
18
18
  });
19
19
  }
20
+ /** Map an optional {from,to} range's ISO bounds to core Date values (range read). */
21
+ export function toRange(range) {
22
+ if (range === undefined)
23
+ return undefined;
24
+ return defined({
25
+ from: range.from === undefined ? undefined : new Date(range.from),
26
+ to: range.to === undefined ? undefined : new Date(range.to),
27
+ });
28
+ }
20
29
  /** The authenticated tenant bound by apiOrSessionAuth. */
21
30
  export function tenant(req) {
22
31
  return req.userId;