@grepr/cli 1.11.13-bbb7524 → 1.12.0-05cba48

package/build/dist/commands/investigation-memory-command.d.ts

@@ -3,5 +3,7 @@ import type { ICommand } from '../lib/command-registry.js';
 import type { MergeConfiguration } from '../types.js';
 export declare class InvestigationMemoryCommand implements ICommand {
     addToProgram(program: Command, merge: MergeConfiguration): void;
+    private addGet;
+    private addSearch;
 }
 //# sourceMappingURL=investigation-memory-command.d.ts.map

package/build/dist/commands/investigation-memory-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"investigation-memory-command.d.ts","sourceRoot":"","sources":["../../../src/main/typescript/commands/investigation-memory-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AA+CtD,qBAAa,0BAA2B,YAAW,QAAQ;IACzD,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI;CAiBhE"}
+{"version":3,"file":"investigation-memory-command.d.ts","sourceRoot":"","sources":["../../../src/main/typescript/commands/investigation-memory-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAwEtD,qBAAa,0BAA2B,YAAW,QAAQ;IACzD,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAK/D,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,SAAS;CAsBlB"}

package/build/dist/commands/investigation-memory-command.js

@@ -1,7 +1,21 @@
 import { createApiClient } from '../lib/api-client-factory.js';
 import { enumOption, integerOption, readAction, readCommand, writeReadOutput } from '../lib/investigation-output.js';
 import { parseIsoTimestamp } from '../lib/time-utils.js';
-import { MemorySearchRequestMode as Mode, MemorySearchRequestSignificance as Significance } from '../openapi/openApiTypes.js';
+const MODES = ['SEMANTIC', 'TEXT', 'TIMELINE'];
+const SIGNIFICANCES = ['INCIDENT', 'OBSERVATION', 'INCONCLUSIVE', 'BENIGN'];
+const VERBOSITIES = ['COMPACT', 'FULL'];
+/**
+ * How many investigations are linked to the memory, then each one the detail carries with when it
+ * was linked, oldest first. The detail lists only the most recent links, so the rest are counted.
+ */
+function linkedInvestigations(detail) {
+    const total = detail.linkCount ?? 0;
+    const links = detail.recurrences ?? [];
+    const unlisted = total - links.length;
+    return [`${total} investigations linked to this memory as recurrences${links.length > 0 ? ':' : '.'}`,
+        ...(unlisted > 0 ? [`${unlisted} earlier links not listed.`] : []),
+        ...links.map(link => `${link.investigationId ?? ''} linked ${link.linkedAt ?? ''}`)].join('\n');
+}
 function requestFor(options) {
     const entityTags = {};
     for (const tag of options.entityTag ?? []) {
@@ -14,7 +28,7 @@ function requestFor(options) {
             throw new Error(`Duplicate entity tag: ${key}`);
         Object.defineProperty(entityTags, key, { value, enumerable: true });
     }
-    if (options.mode === Mode.TIMELINE) {
+    if (options.mode === 'TIMELINE') {
         if (Object.keys(entityTags).length === 0)
             throw new Error('timeline requires --entity-tag');
         if (options.query !== undefined)
@@ -24,35 +38,46 @@ function requestFor(options) {
         throw new Error('text and semantic search require --query');
     if (options.agentId !== undefined && !options.agentId.trim())
         throw new Error('--agent-id must not be blank');
-    if (options.mode === Mode.SEMANTIC) {
-        if (!options.agentId)
-            throw new Error('semantic search requires --agent-id for a direct CLI caller');
-        if (Object.keys(entityTags).some(key => !key.startsWith('entity:'))) {
-            throw new Error('semantic search accepts only entity:-prefixed tags');
-        }
-    }
-    if (options.significance === Significance.BENIGN && options.mode !== Mode.TIMELINE) {
-        throw new Error('BENIGN is supported only in timeline mode');
+    if (options.mode === 'SEMANTIC' && !options.agentId) {
+        throw new Error('semantic search requires --agent-id for a direct CLI caller');
     }
     return { mode: options.mode, query: options.query, agentId: options.agentId,
-        entityTags, significance: options.significance, limit: options.limit,
+        entityTags, limit: options.limit,
+        verbosity: options.verbosity, includeVocabulary: options.includeVocabulary,
+        significances: options.significance ?? [],
         recordedAfter: options.recordedAfter ? parseIsoTimestamp(options.recordedAfter, '--recorded-after').toISOString() : undefined };
 }
 export class InvestigationMemoryCommand {
     addToProgram(program, merge) {
+        this.addSearch(program, merge);
+        this.addGet(program, merge);
+    }
+    addGet(program, merge) {
+        const command = readCommand(program, 'investigation:memory:get <memoryId>', 'Read one recorded memory in full by its id, with the investigations linked to it as recurrences');
+        readAction(command, merge, async (global) => {
+            const options = { ...global, ...command.opts() };
+            const detail = await createApiClient(options).getInvestigationMemory(command.args[0] ?? '');
+            await writeReadOutput(detail, options, detail.memory ? [detail.memory] : [], linkedInvestigations(detail));
+        });
+    }
+    addSearch(program, merge) {
         const command = readCommand(program, 'investigation:memory:search', 'Search recorded investigation memories, not full transcripts')
-            .requiredOption('--mode <mode>', 'Search mode: text, semantic or timeline', value => enumOption(Object.values(Mode), value))
+            .requiredOption('--mode <mode>', 'Search mode: text, semantic or timeline', value => enumOption(MODES, value))
             .option('--query <text>', 'Symptom or full-text query (required for text/semantic)')
             .option('--agent-id <id>', 'Restrict to an agent (required for semantic)')
             .option('--entity-tag <key=value>', 'Filter by entity tag; repeat for multiple tags', (value, previous) => [...previous, value], [])
-            .option('--significance <significance>', 'INCIDENT, OBSERVATION, INCONCLUSIVE or BENIGN (timeline only)', value => enumOption(Object.values(Significance), value))
+            .option('--significance <significance>', 'Return only this significance (INCIDENT, OBSERVATION, INCONCLUSIVE or BENIGN); repeat to keep several, omit for all', (value, previous) => [...previous, enumOption(SIGNIFICANCES, value)], [])
             .option('--recorded-after <timestamp>', 'Only memories recorded on/after an RFC3339 timestamp')
-            .option('--limit <number>', 'Maximum memories (1–50; results are not exhaustive)', integerOption(1, 50), 10);
+            .option('--limit <number>', 'Maximum memories (1–50; omit for the server default; results are not exhaustive)', integerOption(1, 50))
+            .option('--verbosity <verbosity>', 'compact omits the narrative fields; full returns them; omit for the server default', value => enumOption(VERBOSITIES, value))
+            .option('--include-vocabulary', 'Also return the organization\'s entity tag vocabulary');
         readAction(command, merge, async (global) => {
             const options = { ...global, ...command.opts() };
             const request = requestFor(options);
             const result = await createApiClient(options).searchInvestigationMemory(request);
-            await writeReadOutput(result, options, result.results ?? [], [result.preamble, result.note, result.semanticSearchUnavailable ? 'Semantic search unavailable.' : undefined].filter(Boolean).join('\n'));
+            await writeReadOutput(result, options, result.results ?? [], [result.preamble, result.note, result.semanticSearchUnavailable ? 'Semantic search unavailable.' : undefined,
+                result.hasMore ? 'More memories may match than --limit returned; raise it or narrow the filters.' : undefined]
+                .filter(Boolean).join('\n'));
         });
     }
 }

package/build/dist/commands/investigation-memory-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"investigation-memory-command.js","sourceRoot":"","sources":["../../../src/main/typescript/commands/investigation-memory-command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"investigation-memory-command.js","sourceRoot":"","sources":["../../../src/main/typescript/commands/investigation-memory-command.ts"],"names":[],"mappings":"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"}

package/build/dist/docs-index/{36634421-8b53-4406-bdc5-25a595ce18c5.txt → 32fb1622-d659-4661-b0d6-8a3275b3f310.txt}

@@ -14,9 +14,9 @@ List of attribute-to-attribute remapping rules. Each rule moves the value from a
   description: When true, the source attribute is preserved (copied) instead of being removed (moved). Defaults to false (source is removed after remapping).
 
 - name: source (required)
-  type: string
-  description: Source attribute path (dot-notation)
+  type: one of: string, array of string
+  description: Source attribute path: a dotted string ("resource.service" is resource → service), or an array of literal keys (["http", "user.agent"]).
 
 - name: target (required)
-  type: string
-  description: Target attribute path (dot-notation)
+  type: one of: string, array of string
+  description: Target attribute path: a dotted string, or an array of literal keys.

package/build/dist/docs-index/{fbfbf2e6-8c5f-4f15-84a5-df1aaac917f9.txt → 37886f30-f2d6-4ac8-9da3-e8894279c150.txt}

@@ -32,7 +32,7 @@ An agent can correct its own memory for an investigation while that investigatio
 
 ### Significance \[#classification]
 
-Significance is how an agent classifies what it found, and it decides how the memory can be found later:
+Significance is how an agent classifies what it found, and a search can filter on it:
 
 | Significance | Meaning |
 | --- | --- |
@@ -41,7 +41,7 @@ Significance is how an agent classifies what it found, and it decides how the me
 | Inconclusive | The agent could not determine whether there was a problem. |
 | Benign | Triaged as no problem. |
 
-Benign memories are recorded but not indexed for search by meaning or by text. They are reachable only by a timeline search over their entity tags. This keeps the large number of routine all-clear findings out of the way of searches for real problems, at the cost of making them harder to find. If you want an agent to notice that a given service has been triaged as benign many times, search the timeline for that service rather than searching by text.
+Text and timeline searches find benign memories like any other memory, so an agent can notice that a given service has been triaged as benign many times. A semantic search finds a benign memory only when the agent that recorded it made it searchable by meaning. A search that is looking only for real problems can list the significances it wants and leave benign out.
 
 ## Turn on memory \[#enable]
 
@@ -62,7 +62,7 @@ An agent's reasoning model and its embedding model are separate choices. An agen
 
 ### Step 3: Turn on memory for the agent \[#agent-memory]
 
-1. On the agent's page, go to the **Memory** step.
+1. On the agent's page, go to the **Memories** step.
 2. Turn on **Remember past investigations**.
 3. Under **Storage**, select the **Vector index integration**, the **Embedding credentials**, and the **Embedding model**.
 4. Save the agent.
@@ -85,18 +85,18 @@ A search runs in exactly one of three modes, and which mode fits depends on what
 | Text | Investigations mentioning specific words, using full-text search. | Has this exact error string or identifier come up before? |
 | Timeline | Investigations about given entities, ordered by time. | What has been happening to this service recently? |
 
-Semantic search finds a past incident described in different words, which text search misses. Text search finds a literal, such as an error code or a host name, which semantic search can rank poorly. Timeline search needs entity tags rather than a query, and it is the only mode that returns benign memories.
+Semantic search finds a past incident described in different words, which text search misses. Text search finds a literal, such as an error code or a host name, which semantic search can rank poorly. Timeline search needs entity tags rather than a query.
 
 The modes also differ in how much they cover, which matters when you read an empty result:
 
-* A semantic search covers one agent at a time, because a query is only comparable against embeddings made with that agent's model. An empty semantic result means nothing similar was found within what the search could reach. It is not evidence that the agent recorded nothing similar, and it is not evidence that your organization has not seen the problem. A memory embedded with a model the agent no longer uses is unreachable until it is embedded again, and a search that cannot reach the embedding provider returns empty as well. When an empty result matters, confirm it with a text or timeline search, which read the records directly.
+* A semantic search covers one agent at a time, because a query is only comparable against embeddings made with that agent's model. An empty semantic result means nothing similar was found within what the search could reach. It is not evidence that the agent recorded nothing similar, and it is not evidence that your organization has not seen the problem. A memory embedded with a model the agent no longer uses is unreachable until it is embedded again, and a search that cannot reach the embedding provider returns empty as well. An agent can also record a routine or benign observation without making it searchable by meaning, so a semantic search never returns it. When an empty result matters, confirm it with a text or timeline search, which read the records directly.
 * A text or timeline search covers every agent in your organization by default, so it is the one to use when you want the organization's whole history.
 
 So to find out whether any agent has seen something, search by text or timeline, or repeat the semantic search against each agent you care about.
 
-A result carries the memory's content along with its recurrence count, how long ago it was recorded, when it was last seen, and whether it is active, recent, or historical. There is no relevance score, because the agent judges from the content and the provenance rather than a ranking number.
+A result carries the memory's title, significance, and entity tags along with its recurrence count, how long ago it was recorded, when it was last seen, and whether it is active, recent, or historical. Results are compact by default: the symptoms, root cause, ruled-out causes, and resolution come back only when the search asks for them, or when the agent reads one memory in full by its ID. Each semantic or text result also carries a score that ranks it within that search. A score orders candidates; it does not establish that a past memory is the same incident, which the agent judges from the content.
 
-Search returns at most 50 results and has no pagination, so a broad query can be incomplete. Narrowing by entity tags or by significance is more effective than raising the limit.
+Search returns three results by default and at most 50, without pagination, and says when more matched than it returned. Narrowing by entity tags or by significance is more effective than raising the limit.
 
 ## Entity tags \[#tagging]
 
@@ -113,9 +113,38 @@ Grepr derives its tags using a mapping per signal type, which extracts values fr
 | Webhook | The integration, and the service and host from the payload. |
 | Manual | The signal type only. |
 
-The webhook mapping reads the service and host from field names Grepr expects. If your payloads name those fields differently, add a mapping so the tags resolve. On the agent's **Memory** step, under **Entity tags**, add a mapping for the signal type, then add each tag key with the paths to read it from. Grepr tries the paths in order and uses the first that resolves.
+The webhook mapping reads the service and host from field names Grepr expects. If your payloads name those fields differently, add a mapping so the tags resolve. On the agent's **Memories** step, under **Entity tags**, add a mapping for the signal type, then add each tag key with the paths to read it from. Grepr tries the paths in order and uses the first that resolves.
 
-Consistent tag values matter more than complete ones. A service tagged `checkout` in some memories and `checkout-svc` in others splits its history in two, and a timeline search finds only half. Grepr gives an agent the tag values already in use in your organization when it searches, so an agent that searches before recording reuses existing values rather than inventing new ones.
+Consistent tag values matter more than complete ones. A service tagged `checkout` in some memories and `checkout-svc` in others splits its history in two, and a timeline search finds only half. An agent can ask a search for the tag values already in use in your organization, so an agent that checks before recording reuses existing values rather than inventing new ones.
+
+## Set how an agent uses its memory \[#policy]
+
+The **Retrieval policy** settings on the agent's **Memories** step tell the agent how much to search and what to record. Grepr adds them to the agent's instructions, so you do not restate them in the agent's own prompt.
+
+| Setting | What it tells the agent | Default |
+| --- | --- | --- |
+| **Search budget per investigation** | How many memory searches to spend in one investigation, from 0 to 10. A budget of 0 tells the agent not to search. | 2 |
+| **Record** | Which conclusions are worth a memory: **Every conclusion**, **Non-benign only**, or **Reusable only**, which keeps only a cause, a fix, or a pattern that is known noise under stated conditions. | Every conclusion |
+| **Extra guidance** | Your own instructions about what this agent should or should not remember, added after the settings above. | None |
+
+The search budget is an instruction, not a limit. Grepr does not count an agent's searches or refuse one past the budget, and an agent can search again when a result gives it a specific reason to. A setting you leave empty or at **Default** follows the default, including if the default changes.
+
+## Hand an agent its related history \[#digest]
+
+With the *related-history digest*, an investigation starts with a short list of memories related to its triggering signals, so the agent recognizes a recurring problem before it spends any of the investigation looking for it. The digest is off by default. To turn it on, on the agent's **Memories** step, under **Related-history digest**, turn on **Send related history with the trigger**.
+
+For each triggering signal, Grepr looks up memories tagged with the signal's pattern. When the pattern has no memories in the window, Grepr looks up memories tagged with the signal's service instead. The lookup covers every agent in your organization and keeps memories last seen within the window, so a problem first recorded long ago that keeps recurring still appears.
+
+| Setting | What it controls | Default |
+| --- | --- | --- |
+| **Window (days)** | How long ago a memory can have last been seen and still be listed, from 1 to 90 days. | 14 |
+| **Max items** | How many memories the digest lists in total, from 1 to 20, shared across the triggering signals. | 5 |
+
+Each line of the digest names the memory's ID, whether the agent recorded it, its significance and confidence, how often it recurred, when it was last seen, and whether it matched by pattern or by service. A memory a person edited or marked wrong says so.
+
+The agent treats a digest that checked every triggering signal as its initial memory check, and searches again only for something the digest did not answer, such as older history. When the lookup could not check everything, the agent is told so and searches memory itself, unless its search budget is 0. That happens when the lookup fails, when a signal has no pattern or service tag to look up, when the trigger carries more than 10 tagged signals, or when more memories matched than **Max items** allows.
+
+The digest needs the memory search tool, because the agent reads a listed memory in full before it links its investigation to that memory. Turning on memory for an agent in the Grepr UI also gives it the search tool. A continuation of an earlier investigation does not get a digest, and searches memory itself instead.
 
 ## Who can read and write memories \[#scope]
 
@@ -126,9 +155,21 @@ When an agent finds that a past memory describes what it is now seeing, it links
 
 Memories outlive the agent that wrote them. Deleting an agent leaves its memories searchable by your other agents.
 
+## Review memories in the UI \[#review]
+
+The **Memories** page in the Agents area lists every agent's memories in your organization, most recently seen first. Filter it by any entity tag, such as a service or an environment, and by agent, significance, verdict, or text, then open a memory to read it in full with links to the investigations it came from. An agent's **Memories** step shows the same list below its memory settings, fixed to that agent.
+
+With permission to edit integrations, you can also correct what an agent concluded:
+
+* **Edit** a memory's title, symptoms, root cause and confidence, ruled-out causes, resolution, significance, or tags. Tags derived from the triggering signal cannot be changed. An edit applies only to the version of the memory you opened, so a change a person or an agent made after you opened it is never overwritten without you seeing it first.
+* **Mark it wrong** with a note explaining why. The memory stays searchable, and agents that find it are told a person rejected its conclusion, so they treat its root cause as ruled out rather than as a match.
+* **Delete** it. Deleting removes the memory and its recurrence links, and the investigations keep their transcripts. If the investigation that recorded it records again, that is a new memory.
+
+Agents see when a person edited a memory or marked it wrong. A later investigation that finds the same incident in a memory you edited counts as a recurrence but does not change its text. An agent does not link an investigation to a memory you marked wrong, and records a memory of its own instead. An investigation whose own memory you edited or marked wrong keeps that memory, so the agent cannot remove your review by linking the investigation to another memory. The investigation that recorded a memory can still update it, because the agent that ran the investigation owns it. An update replaces the text you reviewed, but the memory still shows as edited or marked wrong, and the agent is told that your edit or verdict remains. Agents treat the root cause of a memory you marked wrong as ruled out until you clear the verdict. For a memory you edited, agents are told when you edited it, and that the investigation that recorded it might have updated the text since then.
+
 ## Search memories from the CLI \[#cli]
 
-The Grepr CLI searches the same memories an agent does, which is how you read what your agents have concluded.
+The Grepr CLI searches the same memories an agent does, so you can read what your agents have concluded from a terminal or a script as well as on the **Memories** page.
 
 ```bash
 # Find investigations mentioning a literal string
@@ -139,11 +180,16 @@ grepr investigation:memory:search --mode semantic --agent-id <agent-id> --query
 
 # See what has been happening to one service lately
 grepr investigation:memory:search --mode timeline --entity-tag entity:service=checkout
+
+# Read one memory in full, with the investigations linked to it as recurrences
+grepr investigation:memory:get <memory-id>
 ```
 
 A semantic search needs an agent id, because a query can only be compared inside the index that agent embeds into. Text and timeline searches cover every agent in your organization by default. Timeline searches need at least one entity tag.
 
-The CLI is how you read what your agents have concluded outside of an investigation. To learn more about the CLI, see [_](/cli).
+Search results are compact by default. To read a result's symptoms, root cause, ruled-out causes, and resolution, pass its investigation id to `investigation:memory:get`, which also lists the most recent investigations linked to it.
+
+To learn more about the CLI, see [_](/cli).
 
 ## Frequently Asked Questions
 
@@ -157,12 +203,16 @@ Three things: a vector index integration whose dimensions match your embedding m
 
 ### How does an agent search its memory?
 
-In one of three modes. Semantic search finds conclusions that mean something similar to the query, and covers one agent at a time. Text search finds specific words, such as an error code. Timeline search finds memories about given entities ordered by time, and is the only mode that returns benign memories. Text and timeline searches cover every agent in the organization by default.
+In one of three modes. Semantic search finds conclusions that mean something similar to the query, and covers one agent at a time. Text search finds specific words, such as an error code. Timeline search finds memories about given entities ordered by time. Text and timeline searches cover every agent in the organization by default.
 
 ### Can one Grepr AI agent read another agent's memories?
 
 Yes, permission is organization-wide, so any agent can search any other agent's memories in your organization. Coverage differs by mode: text and timeline searches span every agent by default, while a search by meaning targets one agent at a time, because a query is only comparable against embeddings made with that agent's model. Writes are owner-only.
 
+### Can a Grepr AI agent start an investigation with its related history?
+
+Yes, with the related-history digest, which is off by default. When you turn it on, each investigation starts with up to 5 memories related to its triggering signals, looked up by the signal's pattern and then by its service, among memories last seen in the past 14 days. Both numbers are configurable. A continuation of an earlier investigation does not get a digest.
+
 ### How do I read what my agents have remembered?
 
-Search them with the grepr investigation:memory:search command, choosing text, semantic, or timeline mode, or read them in an investigation that searched them. The Memory step of an agent holds the settings rather than the records.
+Open the Memories page in the Agents area to browse every agent's memories, filter them by tag, agent, significance, verdict, or text, and open one in full. An agent's Memories step shows the same list for that agent. You can also search them with the grepr investigation:memory:search command.

package/build/dist/docs-index/{cd22fe07-5def-4cb2-ab15-7ca168b5a21d.txt → 4ab56245-7842-494f-8240-b5c6acf1f1e3.txt}

@@ -5,8 +5,8 @@
 ## Properties
 
 - name: extractAttribute (optional)
-  type: string
-  description: Optional attribute to extract. Does nothing if it does not refer to a string attribute
+  type: one of: string, array of string
+  description: Optional attribute to extract. Does nothing if it does not refer to a string attribute. A dotted string, or an array of literal keys.
 
 - name: grokHelperRules (optional)
   type: array of string

package/build/dist/docs-index/{0277478f-310d-46d1-aef8-e269fbe7ae39.txt → 93f1a451-8d1b-4fc1-9dcc-02c5300515f6.txt}

@@ -109,9 +109,9 @@ An agent's settings are spread across the steps on its page, which hold the same
 
 * **Behavior** holds the name, the system prompt, the model, and the limits.
 * **Capabilities** holds the service account, the tools, the skills, the MCP integrations, and the change approval mode.
-* **Memory** holds the memory settings.
+* **Memories** holds the memory settings and, below them, the memories the agent recorded.
 
-Changes on these three steps are held until you click **Save Changes**, so you can revise several steps in one pass. To abandon them, click **Discard Changes**. Subscriptions are not part of this and apply as soon as you make them.
+Changes to the settings on these three steps are held until you click **Save Changes**, so you can revise several steps in one pass. To abandon them, click **Discard Changes**. Subscriptions are not part of this and apply as soon as you make them. Neither are changes to individual memories on the **Memories** step: an edit, a verdict, or a delete applies as soon as you confirm it, and **Discard Changes** does not undo it.
 
 An investigation reads the agent's instructions, model, and limits when it starts, so correcting those mid-incident leaves the current run on the settings it began with and applies to the next one.
 

package/build/dist/docs-index/{9a0c9724-7f8e-47e7-b5cb-34de62e4b5f2.txt → 9c250501-5638-40b9-bfff-1a22527b391f.txt}

@@ -11,7 +11,7 @@
   type: `ReadOrgConstraints`
 
 - name: featureFlags (optional)
-  type: array of enum: `DATADOG_BROWSER_LOGS_INTEGRATION`, `METRICS_SOURCE`, `S3_LOGS_FILE_SOURCE`, `PIPELINE_TEMPLATES`, `AI_WORKFLOWS`, `SEARCH_ICEBERG_SOURCE`, `MULTI_GROK_PARSER`, `AUTH0_SSO_CONNECTION`, `TRINO_QUERY_ENGINE`, `UNKNOWN`
+  type: array of enum: `DATADOG_BROWSER_LOGS_INTEGRATION`, `METRICS_SOURCE`, `S3_LOGS_FILE_SOURCE`, `PIPELINE_TEMPLATES`, `AI_WORKFLOWS`, `SEARCH_ICEBERG_SOURCE`, `MULTI_GROK_PARSER`, `AUTH0_SSO_CONNECTION`, `TRINO_QUERY_ENGINE`, `REMAP_ARRAY_KEY_PATHS`, `UNKNOWN`
 
 - name: name (required)
   type: string

package/build/dist/docs-index/{472334cf-024d-4522-860d-a0171f3eb110.txt → acacb71f-93b3-48f1-9651-7aba597d00df.txt}

@@ -7,8 +7,8 @@ Ordered list of grok rule sets. Each rule set has its own predicate, optional ex
 ## Properties
 
 - name: extractAttribute (optional)
-  type: string
-  description: Optional attribute to extract from. If null, extracts from the log message. Rules that extract from enriched attributes should be ordered after rules that populate those attributes.
+  type: one of: string, array of string
+  description: Optional attribute to extract from. If null, extracts from the log message. Rules that extract from enriched attributes should be ordered after rules that populate those attributes. A dotted string, or an array of literal keys.
 
 - name: grokHelperRules (optional)
   type: array of string

package/build/dist/docs-index/{22e19793-3b24-4a98-a4c7-6d18158ba2db.txt → c2e6b247-69d5-4380-85e8-54942d2d248a.txt}

@@ -440,7 +440,7 @@ The Grepr CLI includes commands to:
 * Manage datasets for log storage and querying: `dataset:create`, `dataset:list`, `dataset:get`, `dataset:update`, `dataset:delete`.
 * Search and retrieve Grepr documentation: `docs:search`, `docs:get`.
 * Test Grok rules: `grok:parse`.
-* Read AI agents and their investigations: `agent:list`, `agent:get`, `investigation:list`, `investigation:get`, `investigation:turns`, `investigation:transcript`, `investigation:memory:search`.
+* Read AI agents and their investigations: `agent:list`, `agent:get`, `investigation:list`, `investigation:get`, `investigation:turns`, `investigation:transcript`, `investigation:memory:search`, `investigation:memory:get`.
 
 The following sections contain examples demonstrating how to use these commands. Most of these examples assume you have already saved a default configuration. If you haven't saved a default configuration, include the `--conf` option to specify a saved configuration when you run CLI commands. To learn how to create a default configuration, see [Configure the Grepr CLI](#cli-configuration).
 
@@ -1026,7 +1026,12 @@ grepr investigation:memory:search --mode semantic --agent-id <agent-id> --query
 grepr investigation:memory:search --mode timeline --entity-tag entity:service=checkout
 ```
 
-A semantic search needs an agent id, because a query can only be compared inside the index that agent embeds into. A timeline search needs at least one entity tag. To learn what memories hold and how the modes differ, see [_](/ai-agents/memory#search-modes).
+```console
+# Read one memory in full, with the investigations linked to it as recurrences
+grepr investigation:memory:get <memory-id>
+```
+
+A semantic search needs an agent id, because a query can only be compared inside the index that agent embeds into, and it filters only on entity tags. A timeline search needs at least one entity tag. Search results leave out each memory's symptoms, root cause, ruled-out causes, and resolution unless you pass `--verbosity full`; to read one result in full, pass its id to `investigation:memory:get`. To learn what memories hold and how the modes differ, see [_](/ai-agents/memory#search-modes).
 
 ## Examples: Documentation commands