npm - volute - Versions diffs - 0.4.0 → 0.6.0 - Mend

volute 0.4.0 → 0.6.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 (82) hide show

package/README.md +22 -22
package/dist/agent-X7GJLBLW.js +79 -0
package/dist/{agent-manager-AUCKMGPR.js → agent-manager-JDVXU3ON.js} +4 -4
package/dist/channel-SMCNOIVQ.js +262 -0
package/dist/chunk-AOKAQGO4.js +107 -0
package/dist/{chunk-VRVVQIYY.js → chunk-AZEL2IEK.js} +1 -1
package/dist/chunk-B3R6L2GW.js +24 -0
package/dist/{chunk-MXUCNIBG.js → chunk-BX7KI4S3.js} +68 -3
package/dist/{chunk-I6OHXCMV.js → chunk-G6ZNGLUX.js} +47 -9
package/dist/{chunk-DNOXHLE5.js → chunk-H7AMDUIA.js} +1 -1
package/dist/{chunk-YGFIWIOF.js → chunk-JR4UXCTO.js} +1 -1
package/dist/{chunk-3C2XR4IY.js → chunk-UWHWAPGO.js} +120 -107
package/dist/{chunk-SOZA2TLP.js → chunk-W76KWE23.js} +1 -1
package/dist/{chunk-GSPKUPKU.js → chunk-XUA3JUFK.js} +2 -1
package/dist/chunk-ZYGKG6VC.js +22 -0
package/dist/chunk-ZZOOTYXK.js +583 -0
package/dist/cli.js +83 -74
package/dist/{connector-DKDJTLYZ.js → connector-Y7JPNROO.js} +11 -6
package/dist/connectors/discord.js +34 -5
package/dist/connectors/slack.js +36 -8
package/dist/connectors/telegram.js +55 -6
package/dist/create-G525LWEA.js +91 -0
package/dist/{daemon-client-XR24PUJF.js → daemon-client-442IV43D.js} +2 -2
package/dist/daemon.js +1273 -384
package/dist/{delete-55MXCEY5.js → delete-2PH2CGDY.js} +7 -8
package/dist/{down-3OB6UVAJ.js → down-FXWAN66A.js} +1 -1
package/dist/{env-JB27UAC3.js → env-7GLUJCWS.js} +8 -5
package/dist/{history-BKG74I43.js → history-H72ZUIBN.js} +3 -3
package/dist/{import-4CI2ZUTJ.js → import-AVKQJDYC.js} +8 -8
package/dist/{logs-NXFFGUKY.js → logs-EDGK26AK.js} +2 -2
package/dist/message-SCOQDR3P.js +32 -0
package/dist/{package-Z2SFO2SV.js → package-4DP4Y4UO.js} +1 -1
package/dist/restart-O4ETYLJF.js +29 -0
package/dist/{schedule-A35SH4HT.js → schedule-S6QVC5ON.js} +10 -5
package/dist/send-G7PE4DOJ.js +72 -0
package/dist/{setup-2FDVN7OF.js → setup-F4TCWVSP.js} +5 -5
package/dist/{start-LDPMCMYT.js → start-VHQ7LNWM.js} +3 -3
package/dist/{status-MVSQG54T.js → status-QAJWXKMZ.js} +3 -3
package/dist/{stop-5PZTZCLL.js → stop-CAGCT5NI.js} +6 -7
package/dist/{up-F7TMTLRE.js → up-CSX3ZUIU.js} +16 -4
package/dist/update-XSIX3GGP.js +140 -0
package/dist/update-check-5ZADDHCK.js +17 -0
package/dist/{upgrade-6ZW2RD64.js → upgrade-YXKPWDRU.js} +16 -15
package/dist/{variant-T64BKARF.js → variant-4Z6W3PP6.js} +15 -10
package/dist/web-assets/assets/index-D5PzIndO.js +308 -0
package/dist/web-assets/index.html +2 -2
package/drizzle/0003_clean_ego.sql +12 -0
package/drizzle/meta/0003_snapshot.json +417 -0
package/drizzle/meta/_journal.json +7 -0
package/package.json +1 -1
package/templates/_base/.init/.config/hooks/startup-context.sh +19 -1
package/templates/_base/.init/.config/scripts/session-reader.ts +59 -0
package/templates/_base/_skills/sessions/SKILL.md +49 -0
package/templates/_base/_skills/volute-agent/SKILL.md +114 -14
package/templates/_base/home/.config/routes.json +10 -0
package/templates/_base/home/VOLUTE.md +14 -35
package/templates/_base/src/lib/format-prefix.ts +7 -1
package/templates/_base/src/lib/router.ts +193 -19
package/templates/_base/src/lib/routing.ts +55 -18
package/templates/_base/src/lib/session-monitor.ts +400 -0
package/templates/_base/src/lib/types.ts +5 -1
package/templates/agent-sdk/.init/.config/routes.json +5 -0
package/templates/agent-sdk/.init/CLAUDE.md +2 -2
package/templates/agent-sdk/src/agent.ts +18 -1
package/templates/agent-sdk/src/lib/hooks/session-context.ts +32 -0
package/templates/agent-sdk/src/server.ts +8 -2
package/templates/agent-sdk/volute-template.json +1 -1
package/templates/pi/.init/.config/routes.json +5 -0
package/templates/pi/.init/AGENTS.md +1 -1
package/templates/pi/src/agent.ts +12 -4
package/templates/pi/src/lib/session-context-extension.ts +33 -0
package/templates/pi/src/server.ts +1 -1
package/templates/pi/volute-template.json +1 -1
package/dist/channel-DQ6UY7QB.js +0 -67
package/dist/chunk-5OCWMTVS.js +0 -152
package/dist/chunk-ZHCE4DPY.js +0 -110
package/dist/create-ILVOG75A.js +0 -79
package/dist/send-3U6OTKG7.js +0 -57
package/dist/web-assets/assets/index-NS621maO.js +0 -296
package/templates/agent-sdk/.init/.config/sessions.json +0 -4
package/templates/pi/.init/.config/sessions.json +0 -1
package/dist/{service-SA4TTMDU.js → service-HZNIDNJF.js} +3 -3

package/dist/web-assets/index.html CHANGED Viewed

@@ -6,8 +6,8 @@
     <title>volute</title>
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
-    <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:ital,wght@0,300;0,400;0,500;0,600;1,400&family=Space+Grotesk:wght@300;400;500;600;700&display=swap" rel="stylesheet" />
-    <script type="module" crossorigin src="/assets/index-NS621maO.js"></script>
+    <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:ital,wght@0,300;0,400;0,500;0,600;1,400&display=swap" rel="stylesheet" />
+    <script type="module" crossorigin src="/assets/index-D5PzIndO.js"></script>
   </head>
   <body>
     <div id="root"></div>

package/drizzle/0003_clean_ego.sql ADDED Viewed

@@ -0,0 +1,12 @@
+CREATE TABLE `conversation_participants` (
+	`conversation_id` text NOT NULL,
+	`user_id` integer NOT NULL,
+	`role` text DEFAULT 'member' NOT NULL,
+	`joined_at` text DEFAULT (datetime('now')) NOT NULL,
+	FOREIGN KEY (`conversation_id`) REFERENCES `conversations`(`id`) ON UPDATE no action ON DELETE cascade,
+	FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `idx_cp_unique` ON `conversation_participants` (`conversation_id`,`user_id`);--> statement-breakpoint
+CREATE INDEX `idx_cp_user_id` ON `conversation_participants` (`user_id`);--> statement-breakpoint
+ALTER TABLE `users` ADD `user_type` text DEFAULT 'human' NOT NULL;

package/drizzle/meta/0003_snapshot.json ADDED Viewed

@@ -0,0 +1,417 @@
+{
+  "version": "6",
+  "dialect": "sqlite",
+  "id": "b96d5915-4500-42f4-8638-28f0526d41f0",
+  "prevId": "b76b7e15-3489-4a1d-ac23-977cf267d174",
+  "tables": {
+    "agent_messages": {
+      "name": "agent_messages",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "integer",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": true
+        },
+        "agent": {
+          "name": "agent",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "channel": {
+          "name": "channel",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "role": {
+          "name": "role",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "sender": {
+          "name": "sender",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "content": {
+          "name": "content",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(datetime('now'))"
+        }
+      },
+      "indexes": {
+        "idx_agent_messages_agent": {
+          "name": "idx_agent_messages_agent",
+          "columns": ["agent"],
+          "isUnique": false
+        },
+        "idx_agent_messages_channel": {
+          "name": "idx_agent_messages_channel",
+          "columns": ["agent", "channel"],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "conversation_participants": {
+      "name": "conversation_participants",
+      "columns": {
+        "conversation_id": {
+          "name": "conversation_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "role": {
+          "name": "role",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'member'"
+        },
+        "joined_at": {
+          "name": "joined_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(datetime('now'))"
+        }
+      },
+      "indexes": {
+        "idx_cp_unique": {
+          "name": "idx_cp_unique",
+          "columns": ["conversation_id", "user_id"],
+          "isUnique": true
+        },
+        "idx_cp_user_id": {
+          "name": "idx_cp_user_id",
+          "columns": ["user_id"],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "conversation_participants_conversation_id_conversations_id_fk": {
+          "name": "conversation_participants_conversation_id_conversations_id_fk",
+          "tableFrom": "conversation_participants",
+          "tableTo": "conversations",
+          "columnsFrom": ["conversation_id"],
+          "columnsTo": ["id"],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "conversation_participants_user_id_users_id_fk": {
+          "name": "conversation_participants_user_id_users_id_fk",
+          "tableFrom": "conversation_participants",
+          "tableTo": "users",
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "conversations": {
+      "name": "conversations",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "agent_name": {
+          "name": "agent_name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "channel": {
+          "name": "channel",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "title": {
+          "name": "title",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(datetime('now'))"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(datetime('now'))"
+        }
+      },
+      "indexes": {
+        "idx_conversations_agent_name": {
+          "name": "idx_conversations_agent_name",
+          "columns": ["agent_name"],
+          "isUnique": false
+        },
+        "idx_conversations_user_id": {
+          "name": "idx_conversations_user_id",
+          "columns": ["user_id"],
+          "isUnique": false
+        },
+        "idx_conversations_updated_at": {
+          "name": "idx_conversations_updated_at",
+          "columns": ["updated_at"],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "conversations_user_id_users_id_fk": {
+          "name": "conversations_user_id_users_id_fk",
+          "tableFrom": "conversations",
+          "tableTo": "users",
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "messages": {
+      "name": "messages",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "integer",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": true
+        },
+        "conversation_id": {
+          "name": "conversation_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "role": {
+          "name": "role",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "sender_name": {
+          "name": "sender_name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "content": {
+          "name": "content",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(datetime('now'))"
+        }
+      },
+      "indexes": {
+        "idx_messages_conversation_id": {
+          "name": "idx_messages_conversation_id",
+          "columns": ["conversation_id"],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "messages_conversation_id_conversations_id_fk": {
+          "name": "messages_conversation_id_conversations_id_fk",
+          "tableFrom": "messages",
+          "tableTo": "conversations",
+          "columnsFrom": ["conversation_id"],
+          "columnsTo": ["id"],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "sessions": {
+      "name": "sessions",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {
+        "sessions_user_id_users_id_fk": {
+          "name": "sessions_user_id_users_id_fk",
+          "tableFrom": "sessions",
+          "tableTo": "users",
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "users": {
+      "name": "users",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "integer",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": true
+        },
+        "username": {
+          "name": "username",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "password_hash": {
+          "name": "password_hash",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "role": {
+          "name": "role",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'pending'"
+        },
+        "user_type": {
+          "name": "user_type",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'human'"
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(datetime('now'))"
+        }
+      },
+      "indexes": {
+        "users_username_unique": {
+          "name": "users_username_unique",
+          "columns": ["username"],
+          "isUnique": true
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    }
+  },
+  "views": {},
+  "enums": {},
+  "_meta": {
+    "schemas": {},
+    "tables": {},
+    "columns": {}
+  },
+  "internal": {
+    "indexes": {}
+  }
+}

package/drizzle/meta/_journal.json CHANGED Viewed

@@ -22,6 +22,13 @@
       "when": 1770672071268,
       "tag": "0002_wealthy_the_call",
       "breakpoints": true
+    },
+    {
+      "idx": 3,
+      "version": "6",
+      "when": 1770770603615,
+      "tag": "0003_clean_ego",
+      "breakpoints": true
     }
   ]
 }

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "volute",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "CLI for creating and managing self-modifying AI agents powered by the Claude Agent SDK",
   "type": "module",
   "license": "MIT",

package/templates/_base/.init/.config/hooks/startup-context.sh CHANGED Viewed

@@ -10,7 +10,16 @@ SOURCE=$(echo "$INPUT" | jq -r '.source // "startup"')
 CONTEXT="Session ${SOURCE} at $(date '+%Y-%m-%d %H:%M')."
-# Add recent journal context if available
+# Active sessions
+SESSIONS_DIR=".volute/sessions"
+if [ -d "$SESSIONS_DIR" ]; then
+  SESSION_LIST=$(ls -1 "$SESSIONS_DIR"/*.json 2>/dev/null | xargs -I{} basename {} .json | sort)
+  if [ -n "$SESSION_LIST" ]; then
+    CONTEXT="$CONTEXT Active sessions: $(echo "$SESSION_LIST" | tr '\n' ', ' | sed 's/, $//')."
+  fi
+fi
+# Last journal entry
 JOURNAL_DIR="home/memory/journal"
 if [ -d "$JOURNAL_DIR" ]; then
   LATEST=$(ls -1 "$JOURNAL_DIR"/*.md 2>/dev/null | sort | tail -1)
@@ -19,6 +28,15 @@ if [ -d "$JOURNAL_DIR" ]; then
   fi
 fi
+# Pending channel invites
+INBOX_DIR="home/inbox"
+if [ -d "$INBOX_DIR" ]; then
+  INVITE_COUNT=$(ls -1 "$INBOX_DIR"/*.md 2>/dev/null | wc -l | tr -d ' ')
+  if [ "$INVITE_COUNT" -gt 0 ] 2>/dev/null; then
+    CONTEXT="$CONTEXT Pending channel invites: ${INVITE_COUNT} (check inbox/)."
+  fi
+fi
 # Output in SessionStart hook format
 jq -n --arg ctx "$CONTEXT" '{
   hookSpecificOutput: {

package/templates/_base/.init/.config/scripts/session-reader.ts ADDED Viewed

@@ -0,0 +1,59 @@
+#!/usr/bin/env npx tsx
+/**
+ * Session reader — displays a human-readable log of another session's activity.
+ *
+ * Usage: npx tsx .config/scripts/session-reader.ts <session-name> [--lines N]
+ *
+ * Runs from the agent's home/ directory.
+ */
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import {
+  readSessionLog,
+  resolveAgentSdkJsonl,
+  resolvePiJsonl,
+} from "../../src/lib/session-monitor.js";
+const args = process.argv.slice(2);
+let sessionName: string | undefined;
+let lines = 50;
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === "--lines" && args[i + 1]) {
+    lines = parseInt(args[++i], 10);
+  } else if (!sessionName && !args[i].startsWith("-")) {
+    sessionName = args[i];
+  }
+}
+if (!sessionName) {
+  console.error("Usage: npx tsx .config/scripts/session-reader.ts <session-name> [--lines N]");
+  process.exit(1);
+}
+// Detect template type and resolve JSONL path
+const cwd = process.cwd();
+const agentSdkSessions = resolve(cwd, "../.volute/sessions");
+const piSessions = resolve(cwd, "../.volute/pi-sessions");
+let jsonlPath: string | null = null;
+let format: "agent-sdk" | "pi";
+if (existsSync(agentSdkSessions)) {
+  format = "agent-sdk";
+  jsonlPath = resolveAgentSdkJsonl(agentSdkSessions, sessionName, cwd);
+} else if (existsSync(piSessions)) {
+  format = "pi";
+  jsonlPath = resolvePiJsonl(piSessions, sessionName);
+} else {
+  console.error("No session directory found. Expected .volute/sessions/ or .volute/pi-sessions/");
+  process.exit(1);
+}
+if (!jsonlPath || !existsSync(jsonlPath)) {
+  console.error(`No session log found for "${sessionName}".`);
+  process.exit(1);
+}
+const output = readSessionLog({ jsonlPath, format, lines });
+console.log(output);

package/templates/_base/_skills/sessions/SKILL.md ADDED Viewed

@@ -0,0 +1,49 @@
+---
+name: Sessions
+description: This skill should be used when checking activity in other sessions, reading session logs, understanding cross-session context, or investigating what happened in another session. Covers "session activity", "other sessions", "session reader", "session log", "cross-session", "what happened in discord", "check session".
+---
+# Cross-Session Awareness
+You can have multiple concurrent sessions (main, discord, email, etc.), each with its own conversation history stored as a JSONL file.
+## Automatic Updates
+When a message arrives, you automatically receive a brief summary of new activity in other sessions (if any). This appears as a `[Session Activity]` block showing what happened since your last check.
+## Listing Sessions
+To see which sessions are active:
+```sh
+ls ../.volute/sessions/       # agent-sdk template
+ls ../.volute/pi-sessions/    # pi template
+```
+## Reading a Session Log
+For a detailed view of what happened in another session, run the session reader script:
+```sh
+npx tsx .config/scripts/session-reader.ts <session-name> [--lines N]
+```
+- `session-name`: The session to inspect (e.g., `discord`, `main`, `email`)
+- `--lines N`: Number of recent entries to show (default: 50)
+### Output Format
+The reader shows a chronological log with:
+- **User messages**: Full text of what was sent
+- **Assistant text**: Full text of your responses
+- **Tool uses**: `[ToolName primary-arg]` format (e.g., `[Edit home/MEMORY.md]`, `[Bash npm test]`)
+- **Timestamps** on each entry
+Thinking blocks, tool result content, and metadata entries are omitted for readability.
+## When to Use This
+- When you receive a `[Session Activity]` summary and want more detail
+- When you want to understand what happened in another session before responding
+- When coordinating work across multiple sessions
+- When a user references something from a different channel