agentel 0.3.0 → 0.3.1

package/README.md

@@ -47,7 +47,7 @@ ref for repeatable installs:
 ```sh
 npm install -g brianlzhou/agentlog
 # or
-npm install -g brianlzhou/agentlog#v0.3.0
+npm install -g brianlzhou/agentlog#v0.3.1
 agentlog init
 ```
 
@@ -293,6 +293,22 @@ The detailed watcher/import contract, including sourcePath replacement rules for
 multi-session stores such as Cursor SQLite and Devin `sessions.db`, lives in
 [`docs/history-source-handling.md`](docs/history-source-handling.md).
 
+Slack notifications are an optional, off-by-default notify layer. Run
+`agentlog notify slack setup` for the guided path: it opens Slack's app
+creation page pre-filled from a manifest (one personal app, `chat:write` plus
+`chat:write.customize` for per-speaker identities), verifies the pasted bot
+token, connects a channel, and sends a test post. Two surfaces toggle independently, each with its own channel: summaries
+(one recap per session after it goes quiet for `--quiet-minutes`) and the
+firehose (live turns streamed into one thread per session, batched every
+`--batch-seconds`). Adjust with
+`agentlog notify slack enable --summaries on|off --firehose on|off
+--summary-channel C… --firehose-channel C…`. Only redacted archive output is
+posted, the token can also come from `SLACK_BOT_TOKEN`, and `--repos`
+restricts posting to an allowlist. Posting is at-least-once on a local queue:
+going offline pauses posting but never archiving, and everything drains on
+reconnect. See `docs/agentlog-slack-scope.md` for the design, thread
+lifecycle, and the planned digest/noteworthy modes.
+
 Remote sync can be configured during init or from the CLI. Local storage remains
 canonical. Normal sync is upload-only: this machine pushes changed archive
 objects to the remote target and never deletes objects from the bucket just

package/docs/code-reference.md

@@ -1203,6 +1203,50 @@ Internal helpers:
 - `isAlive(pid)`: checks whether a PID is alive.
 - `log(message, env)`: appends to supervisor log.
 
+## `src/slack-notify.js`
+
+Slack notify layer (`notify.slack` config block; see
+`docs/agentlog-slack-scope.md`). `writeSession` appends changed sessions to a
+state-dir queue; the supervisor tick drains it in a child process and posts
+one completion summary per session after it goes quiet.
+
+Exports:
+
+- `slackNotifySettings(cfg, env)`: resolved settings with independent
+  `summary` (channel, quietMinutes) and `stream` (channel, batchSeconds)
+  blocks; legacy single-channel configs map onto `summary`. Token falls back
+  to `AGENTLOG_SLACK_BOT_TOKEN`/`SLACK_BOT_TOKEN`, API base URL to
+  `AGENTLOG_SLACK_API_BASE_URL` (test override).
+- `enqueueSlackNotification(session, cfg, env)`: gated hot-path append from
+  `writeSession`; honors the per-repo allowlist.
+- `runSlackNotify(env, options)`: drains the queue into tracked state,
+  streams new events for firehose sessions (one thread per session, event
+  cursor per session, batched per `batchSeconds`), posts summaries for quiet
+  sessions (also closing the firehose thread), and returns
+  `{ posted, streamed, tracked, skipped, errors, nextCheckMs }`. Sessions
+  older than 24h never post (reimport-flood guard); failed posts stay tracked
+  for retry; `options.dryRun` collects messages without posting.
+- `streamMessagesForEvents(events, opts)`: per-turn firehose rendering —
+  each prompt/response becomes its own Slack post under a per-speaker
+  identity: the agent as its model name (`modelDisplayName`) with the
+  company logo as avatar (GitHub org avatar PNGs; Slack's `icon_url` needs a
+  public raster, and the viewer's brand logos are inline SVGs). Needs
+  chat:write.customize; falls back to plain bot posts and remembers via
+  `state.customizeUnsupported`. Whole messages, formatting preserved; tool
+  calls only with `stream.includeTools`. Long in-flight sessions replay only
+  the most recent turns on first attach.
+- Thread lifecycle: going quiet closes the session's thread (the recap, when
+  summaries are on, doubles as the close), keeping the event cursor; a
+  session picked back up later opens a fresh thread marked "(resumed)" and
+  streams only the new turns.
+- `buildCompletionMessage(meta, tracked)`: summary text from session metadata.
+- `buildSlackAppManifest(appName)` / `slackAppCreationUrl(appName)`: app
+  manifest (chat:write only) and the pre-filled api.slack.com creation link
+  used by the `agentlog notify slack setup` wizard.
+- `postSlackMessage(settings, payload)` / `slackAuthTest(settings)`: Slack Web
+  API via built-in fetch.
+- `queuePath(env)` / `statePath(env)`: state-dir file locations.
+
 ## `src/source-watch.js`
 
 Filesystem-event layer for the supervisor. Maps each import source to its

package/docs/history-source-handling.md

@@ -267,49 +267,49 @@ package-prefixed scheme.
 
 | Source type | Version |
 | --- | --- |
-| `codex-cli-history` | `0.3.0.0` |
-| `codex-desktop-history` | `0.3.0.0` |
-| `codex-sdk-history` | `0.3.0.0` |
-| `cli-history` | `0.3.0.0` |
-| `claude-sdk-history` | `0.3.0.0` |
-| `claude-code-desktop-metadata` | `0.3.0.0` |
-| `claude-workspace-desktop` | `0.3.0.0` |
-| `cursor-workspace-sqlite` | `0.3.0.0` |
-| `cursor-global-sqlite` | `0.3.0.0` |
-| `cursor-raw-sqlite-salvage` | `0.3.0.0` |
-| `cursor-agent-transcripts` | `0.3.0.0` |
-| `devin-cli-history` | `0.3.0.0` |
-| `devin-desktop-acp-events` | `0.3.0.0` |
-| `copilot-cli-history` | `0.3.0.0` |
-| `factory-droid-history` | `0.3.0.0` |
-| `grok-build-history` | `0.3.0.0` |
-| `pi-cli-history` | `0.3.0.0` |
-| `gemini-cli-history` | `0.3.0.0` |
-| `cline-task-history` | `0.3.0.0` |
-| `opencode-cli-history` | `0.3.0.0` |
-| `opencode-cli-sqlite-history` | `0.3.0.0` |
-| `opencode-desktop-history` | `0.3.0.0` |
-| `opencode-desktop-sqlite-history` | `0.3.0.0` |
-| `opencode-web-sqlite-history` | `0.3.0.0` |
-| `opencode-history` | `0.3.0.0` |
-| `opencode-sqlite-history` | `0.3.0.0` |
-| `aider-chat-history` | `0.3.0.0` |
-| `antigravity-history` | `0.3.0.0` |
-| `antigravity-transcript-log` | `0.3.0.0` |
-| `antigravity-cli-transcript-log` | `0.3.0.0` |
-| `antigravity-cli-brain` | `0.3.0.0` |
-| `antigravity-ide-transcript-log` | `0.3.0.0` |
-| `antigravity-ide-brain` | `0.3.0.0` |
-| `antigravity-summary-proto` | `0.3.0.0` |
-| `antigravity-trajectory-summary` | `0.3.0.0` |
-| `windsurf-cascade-brain` | `0.3.0.0` |
-| `windsurf-cascade-protobuf` | `0.3.0.0` |
-| `windsurf-trajectory-export` | `0.3.0.0` |
-| `web-chat-export` | `0.3.0.0` |
-| `chatgpt-export` | `0.3.0.0` |
-| `claude-web-export` | `0.3.0.0` |
-| `claude-web-memory` | `0.3.0.0` |
-| `import` | `0.3.0.0` |
+| `codex-cli-history` | `0.3.1.0` |
+| `codex-desktop-history` | `0.3.1.0` |
+| `codex-sdk-history` | `0.3.1.0` |
+| `cli-history` | `0.3.1.0` |
+| `claude-sdk-history` | `0.3.1.0` |
+| `claude-code-desktop-metadata` | `0.3.1.0` |
+| `claude-workspace-desktop` | `0.3.1.0` |
+| `cursor-workspace-sqlite` | `0.3.1.0` |
+| `cursor-global-sqlite` | `0.3.1.0` |
+| `cursor-raw-sqlite-salvage` | `0.3.1.0` |
+| `cursor-agent-transcripts` | `0.3.1.0` |
+| `devin-cli-history` | `0.3.1.0` |
+| `devin-desktop-acp-events` | `0.3.1.0` |
+| `copilot-cli-history` | `0.3.1.0` |
+| `factory-droid-history` | `0.3.1.0` |
+| `grok-build-history` | `0.3.1.0` |
+| `pi-cli-history` | `0.3.1.0` |
+| `gemini-cli-history` | `0.3.1.0` |
+| `cline-task-history` | `0.3.1.0` |
+| `opencode-cli-history` | `0.3.1.0` |
+| `opencode-cli-sqlite-history` | `0.3.1.0` |
+| `opencode-desktop-history` | `0.3.1.0` |
+| `opencode-desktop-sqlite-history` | `0.3.1.0` |
+| `opencode-web-sqlite-history` | `0.3.1.0` |
+| `opencode-history` | `0.3.1.0` |
+| `opencode-sqlite-history` | `0.3.1.0` |
+| `aider-chat-history` | `0.3.1.0` |
+| `antigravity-history` | `0.3.1.0` |
+| `antigravity-transcript-log` | `0.3.1.0` |
+| `antigravity-cli-transcript-log` | `0.3.1.0` |
+| `antigravity-cli-brain` | `0.3.1.0` |
+| `antigravity-ide-transcript-log` | `0.3.1.0` |
+| `antigravity-ide-brain` | `0.3.1.0` |
+| `antigravity-summary-proto` | `0.3.1.0` |
+| `antigravity-trajectory-summary` | `0.3.1.0` |
+| `windsurf-cascade-brain` | `0.3.1.0` |
+| `windsurf-cascade-protobuf` | `0.3.1.0` |
+| `windsurf-trajectory-export` | `0.3.1.0` |
+| `web-chat-export` | `0.3.1.0` |
+| `chatgpt-export` | `0.3.1.0` |
+| `claude-web-export` | `0.3.1.0` |
+| `claude-web-memory` | `0.3.1.0` |
+| `import` | `0.3.1.0` |
 
 `cursor-sqlite-history` and `antigravity-brain` are compatibility aliases for
 older labels. Fingerprints include the parser version prefix, so changing the

package/docs/release.md

@@ -91,5 +91,5 @@ After tagging and pushing the release, sanity-check both public install forms:
 
 ```sh
 npm install -g agentel
-npm install -g brianlzhou/agentlog#v0.3.0
+npm install -g brianlzhou/agentlog#v0.3.1
 ```

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "agentel",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "agentel",
-      "version": "0.3.0",
+      "version": "0.3.1",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentel",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Local-first archive and recall layer for agent coding sessions.",
   "type": "commonjs",
   "license": "MIT",

package/src/archive.js

@@ -10,6 +10,7 @@ const { canonicalRepo } = require("./repo");
 const { loadRedactionConfig, loadEnvValues, mergeSummaries, redactText, styleRedactionMarkersForMarkdown } = require("./redaction");
 const { ensureBaseDirs, ensureDir, paths, readJson, writeJson } = require("./paths");
 const sessionStore = require("./session-store");
+const { enqueueSlackNotification } = require("./slack-notify");
 
 const SHARED_RAW_SOURCE_CACHE = new Map();
 const ESTIMATED_TOKEN_CHARS = 4;
@@ -234,6 +235,7 @@ function writeSession(input, env = process.env) {
     replaceSourcePathCopies: input.replaceSourcePathCopies !== false
   });
   invalidateSessionsSnapshotCache();
+  enqueueSlackNotification({ ...session, metadataPath }, cfg, env);
   return { session, conversationPath, metadataPath, transcriptPath, eventPath, viewPath, rawPath: session.rawPath || "", artifactsPath: session.artifactsPath || "" };
 }