@hydra-acp/archiver 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sam Magnuson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,169 @@
+# hydra-acp-archiver
+
+Sync extension for [hydra-acp](https://github.com/smagnuso/hydra-acp). Keeps your agent sessions in sync across the machines you work on by uploading session bundles to a shared backend (Google Drive, plain filesystem) after every turn and importing peers' bundles in the background.
+
+Runs as a daemon-managed process, so sessions started on machine A become available on machine B without any manual export/import.
+
+## How it works
+
+1. **Startup cold sweep**: lists every session the daemon knows about and exports the cold ones — so installing the archiver on a machine with a pile of existing sessions backfills them all to the backend without the user having to touch each one. Hash-dedup keeps subsequent restarts cheap (already-uploaded sessions are skipped).
+2. **Live monitoring**: watches every live hydra session via the daemon's WebSocket. When a session emits `turn_complete`, the archiver schedules a debounced flush (default 5 s window).
+3. **On flush**: asks the daemon to `GET /v1/sessions/:id/export`, wraps the resulting `.hydra` bundle in a sync envelope (lineageId + hash + uploader info), and writes it to the backend keyed by `lineageId`.
+4. **Live → cold final flush**: when a session goes cold (daemon detaches), one last flush captures its latest state before the WS bridge tears down.
+5. **Pull loop**: on a separate timer (default 60 s), lists the backend, downloads any envelope newer than what it last saw, and POSTs the bundle to `/v1/sessions/import` with `replace: true`.
+6. **De-dup**: uses hydra's stable `lineageId` (it survives every export/import hop) plus a SHA-256 of the canonicalized bundle to skip uploads when content hasn't actually changed.
+
+Conflict resolution is last-writer-wins by envelope `uploadedAt`. The envelope format leaves room for a future `activeOn` claim-lock; not in this release.
+
+## Install
+
+From npm (recommended once published):
+
+```sh
+npm install -g @hydra-acp/archiver
+```
+
+Drops a `hydra-acp-archiver` binary on your PATH.
+
+Or from source:
+
+```sh
+git clone git@github.com:smagnuson/hydra-acp-archiver.git ~/dev/hydra-acp-archiver
+cd ~/dev/hydra-acp-archiver
+npm install
+npm run build
+```
+
+Register the extension with hydra:
+
+```sh
+hydra-acp extensions add hydra-acp-archiver
+```
+
+Or pointed at a local build:
+
+```sh
+hydra-acp extensions add hydra-acp-archiver \
+  --command node \
+  --args ~/dev/hydra-acp-archiver/dist/index.js
+```
+
+That writes the equivalent entry into `~/.hydra-acp/config.json`:
+
+```json
+{
+  "extensions": {
+    "hydra-acp-archiver": {
+      "command": ["node"],
+      "args": ["/home/you/dev/hydra-acp-archiver/dist/index.js"],
+      "enabled": true
+    }
+  }
+}
+```
+
+On `hydra-acp daemon start`, hydra spawns hydra-acp-archiver as a managed subprocess. Stdout/stderr land in `~/.hydra-acp/extensions/hydra-acp-archiver.log`.
+
+## First-time Google setup
+
+The Google Drive backend uses OAuth 2.0 with the **`drive.file`** scope — the archiver can only see files it creates plus those you explicitly hand it via a picker. Your other Drive contents stay invisible to it.
+
+You provide your own OAuth client (Google's terms make it impractical to ship a shared one):
+
+1. Go to <https://console.cloud.google.com/> and create or pick a project.
+2. Enable the **Google Drive API** for that project.
+3. Configure the **OAuth consent screen**. User type: **External**. Add your Google account under **Test Users**.
+4. **Credentials → Create credentials → OAuth client ID**. Application type: **Desktop app**.
+5. Download the resulting JSON and save it to `~/.hydra-acp/archiver-google-credentials.json` (or anywhere, and set `HYDRA_ACP_ARCHIVER_GOOGLE_CREDENTIALS`).
+6. Run:
+
+   ```sh
+   hydra-acp-archiver login
+   ```
+
+   Your browser opens to Google's consent screen. The "Google hasn't verified this app" interstitial is expected for an unverified personal-use client — click **Advanced → Go to (unsafe)** and approve. The redirect lands on a transient local server, the archiver writes `~/.hydra-acp/archiver-google-token.json` (mode 0600), and you're done.
+
+After this, restart the daemon. The archiver process starts up, creates a `hydra-acp-archive/` folder in your Drive on first upload, and begins syncing.
+
+## Multi-machine setup
+
+Repeat the same login flow on each machine that should sync, using the **same Google account**. Each machine gets its own refresh token; they all point at the same Drive folder.
+
+If you want a different Drive folder per "team" or "context," set `HYDRA_ACP_ARCHIVER_DRIVE_FOLDER` on every participating machine to the same value.
+
+## Filesystem backend
+
+Useful for testing locally, or for pointing at a folder that a separate sync tool (Syncthing, Dropbox client) already mirrors across your machines.
+
+```json
+{
+  "extensions": {
+    "hydra-acp-archiver": {
+      "command": ["node"],
+      "args": ["/home/you/dev/hydra-acp-archiver/dist/index.js"],
+      "env": {
+        "HYDRA_ACP_ARCHIVER_BACKEND": "fs",
+        "HYDRA_ACP_ARCHIVER_FS_DIR": "/home/you/Sync/hydra-archive"
+      }
+    }
+  }
+}
+```
+
+## Environment variables
+
+| Variable | Default | Notes |
+| --- | --- | --- |
+| `HYDRA_ACP_ARCHIVER_BACKEND` | `google-drive` | `google-drive` \| `fs` |
+| `HYDRA_ACP_ARCHIVER_DRIVE_FOLDER` | `hydra-acp-archive` | Drive folder name |
+| `HYDRA_ACP_ARCHIVER_FS_DIR` | `~/.hydra-acp/archive` | Used when backend is `fs` |
+| `HYDRA_ACP_ARCHIVER_GOOGLE_CREDENTIALS` | `~/.hydra-acp/archiver-google-credentials.json` | OAuth client JSON from GCP |
+| `HYDRA_ACP_ARCHIVER_CONFIG` | `~/.hydra-acp/archiver.config.js` | Rule file (optional) |
+| `HYDRA_ACP_ARCHIVER_POLL_MS` | `2000` | Session discovery cadence |
+| `HYDRA_ACP_ARCHIVER_DEBOUNCE_MS` | `5000` | Per-session upload debounce window |
+| `HYDRA_ACP_ARCHIVER_PULL_MS` | `60000` | Backend list cadence |
+| `DEBUG` | `false` | Verbose logging |
+
+## Rule (opt-out specific sessions)
+
+By default the archiver uploads every live session. Drop a JS module at `~/.hydra-acp/archiver.config.js` (or `HYDRA_ACP_ARCHIVER_CONFIG`) to skip some:
+
+```js
+// ~/.hydra-acp/archiver.config.js
+export default function archive(ev) {
+  // ev.sessionId, ev.lineageId
+  // ev.meta.cwd, ev.meta.agentId, ev.meta.title
+
+  // Don't sync work in throwaway scratch dirs:
+  if (ev.meta.cwd?.startsWith("/tmp/")) {
+    return false;
+  }
+
+  // Don't sync sessions whose title is prefixed with "(local)":
+  if (ev.meta.title?.startsWith("(local)")) {
+    return false;
+  }
+
+  return true;
+}
+```
+
+Return `false` to skip an upload. Any other value (including `undefined`) archives. The rule reloads on SIGHUP, so you don't need to restart the daemon to change it.
+
+## On-disk state
+
+- `~/.hydra-acp/archiver-state.json` — per-lineage cache of last uploaded hash + last seen remote upload, used for self-loop suppression. Safe to delete; archiver will rebuild it.
+- `~/.hydra-acp/archiver-google-credentials.json` — OAuth client JSON you downloaded.
+- `~/.hydra-acp/archiver-google-token.json` — refresh + access token (mode 0600). Re-run `hydra-acp-archiver login` to refresh.
+
+## Troubleshooting
+
+- **`Missing HYDRA_ACP_TOKEN env var`** — you ran the archiver directly instead of via the daemon. Run it as a registered extension.
+- **`No Google OAuth token at …`** — run `hydra-acp-archiver login` first.
+- **`OAuth credentials file not found`** — follow the **First-time Google setup** steps to download the client JSON from GCP Console.
+- **Files aren't appearing in Drive** — check `~/.hydra-acp/extensions/hydra-acp-archiver.log` for errors. Common: consent-screen test-user list doesn't include your Google account.
+- **Two machines kept overwriting each other** — that's last-writer-wins working as designed if both are actively editing the same session. Avoid editing the same session on two machines simultaneously; one of them will lose its diff. A future `activeOn` claim-lock will close this gap.
+
+## Backends
+
+Current: `google-drive`, `fs`. Adding a new one means implementing the `SyncBackend` interface in `src/backend/types.ts` and wiring it into `src/backend/factory.ts`.

package/dist/acp/attach.js

@@ -0,0 +1,192 @@
+import { EventEmitter } from "node:events";
+import { readFileSync } from "node:fs";
+import { WebSocket } from "ws";
+import { logger } from "../util/log.js";
+const pkg = JSON.parse(readFileSync(new URL("../../package.json", import.meta.url), "utf8"));
+import { ACP_PROTOCOL_VERSION, isNotification, isRequest, isResponse, } from "./protocol.js";
+const log = logger("acp");
+export class AcpAttach extends EventEmitter {
+    opts;
+    ws;
+    nextId = 1;
+    pending = new Map();
+    connected = false;
+    constructor(opts) {
+        super();
+        this.opts = opts;
+    }
+    get sessionId() {
+        return this.opts.sessionId;
+    }
+    get isConnected() {
+        return this.connected;
+    }
+    start() {
+        log.debug(`connecting ${this.opts.daemonWsUrl} for ${this.opts.sessionId}`);
+        const subprotocols = ["acp.v1", `hydra-acp-token.${this.opts.token}`];
+        let ws;
+        try {
+            ws = new WebSocket(this.opts.daemonWsUrl, subprotocols);
+        }
+        catch (err) {
+            this.emit("error", err);
+            return;
+        }
+        this.ws = ws;
+        ws.on("open", () => {
+            this.connected = true;
+            log.info(`ws open ${this.opts.sessionId}`);
+            void this.handshake()
+                .then(() => {
+                this.emit("open");
+            })
+                .catch((err) => {
+                this.emit("error", err);
+                try {
+                    this.ws?.close();
+                }
+                catch {
+                    void 0;
+                }
+            });
+        });
+        ws.on("message", (data, isBinary) => {
+            if (isBinary) {
+                return;
+            }
+            const text = data.toString("utf8");
+            try {
+                const parsed = JSON.parse(text);
+                this.onMessage(parsed);
+            }
+            catch (err) {
+                log.warn(`parse error on ${this.opts.sessionId}: ${err.message}; raw=${text.slice(0, 200)}`);
+            }
+        });
+        ws.on("error", (err) => {
+            log.warn(`ws error ${this.opts.sessionId}: ${err.message}`);
+            this.emit("error", err);
+        });
+        ws.on("close", (code, reason) => {
+            const hadError = code >= 4000 || code === 1006 || code === 1011;
+            const reasonText = reason.toString("utf8");
+            this.connected = false;
+            log.info(`ws closed ${this.opts.sessionId} code=${code}${reasonText ? ` reason=${reasonText}` : ""}`);
+            for (const [, p] of this.pending) {
+                p.reject(new Error("ws closed"));
+            }
+            this.pending.clear();
+            this.emit("close", { hadError });
+        });
+    }
+    stop() {
+        if (this.ws && this.ws.readyState !== WebSocket.CLOSED) {
+            try {
+                this.ws.close();
+            }
+            catch {
+                void 0;
+            }
+        }
+    }
+    async request(method, params) {
+        const id = this.nextId++;
+        const msg = {
+            jsonrpc: "2.0",
+            id,
+            method,
+            ...(params !== undefined ? { params } : {}),
+        };
+        this.write(msg);
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, {
+                resolve: (resp) => {
+                    if (resp.error) {
+                        reject(new Error(`${resp.error.code}: ${resp.error.message}`));
+                    }
+                    else {
+                        resolve(resp.result);
+                    }
+                },
+                reject,
+            });
+        });
+    }
+    notify(method, params) {
+        const msg = {
+            jsonrpc: "2.0",
+            method,
+            ...(params !== undefined ? { params } : {}),
+        };
+        this.write(msg);
+    }
+    reply(id, result) {
+        const msg = { jsonrpc: "2.0", id, result };
+        this.write(msg);
+    }
+    replyError(id, code, message) {
+        const msg = {
+            jsonrpc: "2.0",
+            id,
+            error: { code, message },
+        };
+        this.write(msg);
+    }
+    async handshake() {
+        try {
+            await this.request("initialize", {
+                protocolVersion: ACP_PROTOCOL_VERSION,
+                clientCapabilities: {
+                    fs: { readTextFile: false, writeTextFile: false },
+                    terminal: false,
+                },
+            });
+        }
+        catch (err) {
+            log.warn(`initialize failed for ${this.opts.sessionId}: ${err.message}`);
+        }
+        try {
+            // historyPolicy: "none" — the archiver pulls full bundles via REST,
+            // it doesn't need history replayed over the WS attach.
+            const attachResult = await this.request("session/attach", {
+                sessionId: this.opts.sessionId,
+                historyPolicy: "none",
+                clientInfo: { name: "hydra-acp-archiver", version: pkg.version },
+            });
+            log.info(`attached ${this.opts.sessionId}${attachResult.replayed !== undefined
+                ? ` replayed=${attachResult.replayed}`
+                : ""}`);
+        }
+        catch (err) {
+            log.warn(`session/attach failed for ${this.opts.sessionId}: ${err.message}`);
+            throw err;
+        }
+    }
+    write(msg) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+            log.warn(`drop write to closed ws: ${JSON.stringify(msg)}`);
+            return;
+        }
+        this.ws.send(JSON.stringify(msg));
+    }
+    onMessage(m) {
+        if (isResponse(m)) {
+            const p = this.pending.get(m.id);
+            if (p) {
+                this.pending.delete(m.id);
+                p.resolve(m);
+            }
+            else {
+                log.debug(`unmatched response id=${String(m.id)}`);
+            }
+            this.emit("response", m);
+        }
+        else if (isRequest(m)) {
+            this.emit("request", m);
+        }
+        else if (isNotification(m)) {
+            this.emit("notification", m);
+        }
+    }
+}
+//# sourceMappingURL=attach.js.map

package/dist/acp/attach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.js","sourceRoot":"","sources":["../../src/acp/attach.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAC9C,CAAC;AACzB,OAAO,EACL,oBAAoB,EAMpB,cAAc,EACd,SAAS,EACT,UAAU,GACX,MAAM,eAAe,CAAC;AAEvB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;AAsB1B,MAAM,OAAO,SAAU,SAAQ,YAA0B;IAM1B;IALrB,EAAE,CAAwB;IAC1B,MAAM,GAAG,CAAC,CAAC;IACX,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;IAC/C,SAAS,GAAG,KAAK,CAAC;IAE1B,YAA6B,IAAmB;QAC9C,KAAK,EAAE,CAAC;QADmB,SAAI,GAAJ,IAAI,CAAe;IAEhD,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;IAC7B,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,KAAK;QACH,GAAG,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,WAAW,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAC5E,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,mBAAmB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACtE,IAAI,EAAa,CAAC;QAClB,IAAI,CAAC;YACH,EAAE,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAY,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QAEb,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;YACjB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;YAC3C,KAAK,IAAI,CAAC,SAAS,EAAE;iBAClB,IAAI,CAAC,GAAG,EAAE;gBACT,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpB,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;gBACtB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAY,CAAC,CAAC;gBACjC,IAAI,CAAC;oBACH,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC;gBACnB,CAAC;gBAAC,MAAM,CAAC;oBACP,KAAK,CAAC,CAAC;gBACT,CAAC;YACH,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE;YAClC,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC;gBAClD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,IAAI,CACN,kBAAkB,IAAI,CAAC,IAAI,CAAC,SAAS,KAAM,GAAa,CAAC,OAAO,SAAS,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAC9F,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACrB,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,SAAS,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5D,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAC9B,MAAM,QAAQ,GAAG,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC;YAChE,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC3C,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,GAAG,CAAC,IAAI,CACN,aAAa,IAAI,CAAC,IAAI,CAAC,SAAS,SAAS,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5F,CAAC;YACF,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;YACnC,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;YACvD,IAAI,CAAC;gBACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;YAClB,CAAC;YAAC,MAAM,CAAC;gBACP,KAAK,CAAC,CAAC;YACT,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAc,MAAc,EAAE,MAAgB;QACzD,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,GAAG,GAAmB;YAC1B,OAAO,EAAE,KAAK;YACd,EAAE;YACF,MAAM;YACN,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5C,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChB,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE;gBACnB,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;oBAChB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;wBACf,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;oBACjE,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,IAAI,CAAC,MAAW,CAAC,CAAC;oBAC5B,CAAC;gBACH,CAAC;gBACD,MAAM;aACP,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,MAAc,EAAE,MAAgB;QACrC,MAAM,GAAG,GAAwB;YAC/B,OAAO,EAAE,KAAK;YACd,MAAM;YACN,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5C,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,EAAa,EAAE,MAAe;QAClC,MAAM,GAAG,GAAoB,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;QAC5D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,UAAU,CAAC,EAAa,EAAE,IAAY,EAAE,OAAe;QACrD,MAAM,GAAG,GAAoB;YAC3B,OAAO,EAAE,KAAK;YACd,EAAE;YACF,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;SACzB,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,SAAS;QACrB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE;gBAC/B,eAAe,EAAE,oBAAoB;gBACrC,kBAAkB,EAAE;oBAClB,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;oBACjD,QAAQ,EAAE,KAAK;iBAChB;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,IAAI,CACN,yBAAyB,IAAI,CAAC,IAAI,CAAC,SAAS,KAAM,GAAa,CAAC,OAAO,EAAE,CAC1E,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,oEAAoE;YACpE,uDAAuD;YACvD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,OAAO,CAGpC,gBAAgB,EAAE;gBACnB,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS;gBAC9B,aAAa,EAAE,MAAM;gBACrB,UAAU,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;aACjE,CAAC,CAAC;YACH,GAAG,CAAC,IAAI,CACN,YAAY,IAAI,CAAC,IAAI,CAAC,SAAS,GAC7B,YAAY,CAAC,QAAQ,KAAK,SAAS;gBACjC,CAAC,CAAC,aAAa,YAAY,CAAC,QAAQ,EAAE;gBACtC,CAAC,CAAC,EACN,EAAE,CACH,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,IAAI,CACN,6BAA6B,IAAI,CAAC,IAAI,CAAC,SAAS,KAAM,GAAa,CAAC,OAAO,EAAE,CAC9E,CAAC;YACF,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,GAAmB;QAC/B,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YACtD,GAAG,CAAC,IAAI,CAAC,4BAA4B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5D,OAAO;QACT,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,CAAC;IAEO,SAAS,CAAC,CAAiB;QACjC,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YAClB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjC,IAAI,CAAC,EAAE,CAAC;gBACN,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC1B,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACf,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,KAAK,CAAC,yBAAyB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACrD,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAC1B,CAAC;aAAM,IAAI,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;CACF"}

package/dist/acp/protocol.js

@@ -0,0 +1,13 @@
+// ACP wire protocol version this extension speaks. Single source of
+// truth for the initialize handshake; never a literal at the callsite.
+export const ACP_PROTOCOL_VERSION = 1;
+export function isRequest(m) {
+    return "method" in m && "id" in m;
+}
+export function isNotification(m) {
+    return "method" in m && !("id" in m);
+}
+export function isResponse(m) {
+    return !("method" in m) && "id" in m;
+}
+//# sourceMappingURL=protocol.js.map

package/dist/acp/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/acp/protocol.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,uEAAuE;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AA6BtC,MAAM,UAAU,SAAS,CAAC,CAAiB;IACzC,OAAO,QAAQ,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,CAAiB;IAC9C,OAAO,QAAQ,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,CAAiB;IAC1C,OAAO,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/dist/archive-loop.js

@@ -0,0 +1,134 @@
+import { hostname, userInfo } from "node:os";
+import { hashBundle, keyFor, serialize, wrap, } from "./envelope.js";
+import { logger } from "./util/log.js";
+const log = logger("archive");
+export class ArchiveLoop {
+    opts;
+    host;
+    pending = new Map();
+    // Tracks sessionId -> meta we know about (just cwd/title/agentId for
+    // now), so the rule fn has something to decide on.
+    meta = new Map();
+    stopped = false;
+    constructor(opts) {
+        this.opts = opts;
+        this.host = opts.host ?? defaultHost();
+    }
+    setMeta(sessionId, meta) {
+        this.meta.set(sessionId, meta);
+    }
+    forgetSession(sessionId) {
+        const p = this.pending.get(sessionId);
+        if (p) {
+            clearTimeout(p.timer);
+            this.pending.delete(sessionId);
+        }
+        this.meta.delete(sessionId);
+    }
+    // Cancel any pending debounced upload and synchronously run one final
+    // flush — used when a session transitions live → cold so we capture
+    // its last state. Errors are logged, not thrown, so callers can
+    // fire-and-forget. The session's meta is dropped after the flush
+    // resolves.
+    async finalFlush(sessionId) {
+        const existing = this.pending.get(sessionId);
+        if (existing) {
+            clearTimeout(existing.timer);
+            this.pending.delete(sessionId);
+        }
+        try {
+            await this.flush(sessionId);
+        }
+        catch (err) {
+            log.warn(`final flush ${sessionId} failed: ${err.message}`);
+        }
+        this.meta.delete(sessionId);
+    }
+    markDirty(sessionId) {
+        if (this.stopped) {
+            return;
+        }
+        const existing = this.pending.get(sessionId);
+        if (existing) {
+            clearTimeout(existing.timer);
+        }
+        const timer = setTimeout(() => {
+            this.pending.delete(sessionId);
+            void this.flush(sessionId).catch((err) => {
+                log.warn(`flush ${sessionId} failed: ${err.message}`);
+            });
+        }, this.opts.debounceMs);
+        timer.unref();
+        this.pending.set(sessionId, { timer });
+    }
+    stop() {
+        this.stopped = true;
+        for (const p of this.pending.values()) {
+            clearTimeout(p.timer);
+        }
+        this.pending.clear();
+    }
+    // flushNow is exposed for tests so they don't have to wait out the
+    // debounce window. Production code goes through markDirty.
+    async flushNow(sessionId) {
+        const existing = this.pending.get(sessionId);
+        if (existing) {
+            clearTimeout(existing.timer);
+            this.pending.delete(sessionId);
+        }
+        await this.flush(sessionId);
+    }
+    async flush(sessionId) {
+        const bundle = await this.opts.daemon.exportSession(sessionId);
+        const lineageId = bundle.session.lineageId;
+        if (!lineageId) {
+            log.warn(`session ${sessionId} export had no lineageId; skipping`);
+            return;
+        }
+        const meta = this.meta.get(sessionId);
+        const rule = this.opts.getRule();
+        const shouldArchive = await runRule(rule, {
+            sessionId,
+            lineageId,
+            meta: meta ?? {},
+        });
+        if (!shouldArchive) {
+            log.debug(`rule skipped session ${sessionId} (lineage ${lineageId})`);
+            return;
+        }
+        const newHash = hashBundle(bundle);
+        const prev = this.opts.state.get(lineageId);
+        if (prev.lastUploadedHash === newHash) {
+            log.debug(`unchanged content for lineage ${lineageId} — skip upload`);
+            return;
+        }
+        const envelope = wrap(bundle, lineageId, this.host);
+        await this.opts.backend.put(keyFor(lineageId), serialize(envelope));
+        await this.opts.state.set(lineageId, {
+            lastUploadedHash: newHash,
+            lastUploadedAt: envelope.uploadedAt,
+        });
+        log.info(`uploaded lineage=${lineageId} session=${sessionId} hash=${newHash.slice(0, 22)}…`);
+    }
+}
+async function runRule(rule, ev) {
+    try {
+        const r = await rule(ev);
+        return r !== false;
+    }
+    catch (err) {
+        log.warn(`rule threw for ${ev.sessionId}: ${err.message}; defaulting to archive`);
+        return true;
+    }
+}
+function defaultHost() {
+    let user = "unknown";
+    try {
+        user = userInfo().username;
+    }
+    catch {
+        // happens in some sandboxes; fall through
+    }
+    return { host: hostname(), user };
+}
+//# sourceMappingURL=archive-loop.js.map

package/dist/archive-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-loop.js","sourceRoot":"","sources":["../src/archive-loop.ts"],"names":[],"mappings":"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"}

package/dist/backend/factory.js

@@ -0,0 +1,19 @@
+import { FsBackend } from "./fs.js";
+import { GoogleDriveBackend } from "./google-drive.js";
+export function makeBackend(config) {
+    switch (config.backend) {
+        case "fs":
+            return new FsBackend({ dir: config.fsDir });
+        case "google-drive":
+            return new GoogleDriveBackend({
+                credentialsPath: config.credentialsPath,
+                tokenPath: config.tokenPath,
+                folderName: config.driveFolderName,
+            });
+        default: {
+            const exhaustive = config.backend;
+            throw new Error(`unknown backend: ${String(exhaustive)}`);
+        }
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/backend/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/backend/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,QAAQ,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,KAAK,IAAI;YACP,OAAO,IAAI,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9C,KAAK,cAAc;YACjB,OAAO,IAAI,kBAAkB,CAAC;gBAC5B,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,UAAU,EAAE,MAAM,CAAC,eAAe;aACnC,CAAC,CAAC;QACL,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,UAAU,GAAU,MAAM,CAAC,OAAO,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/backend/fs.js

@@ -0,0 +1,73 @@
+import { mkdir, readFile, readdir, rename, stat, unlink, writeFile, } from "node:fs/promises";
+import { resolve } from "node:path";
+import { logger } from "../util/log.js";
+const log = logger("backend.fs");
+// Filesystem-backed implementation. Useful for tests, for users who want
+// to point a folder-sync tool (Syncthing, Dropbox) at the archive
+// directory, and for development against a local daemon.
+export class FsBackend {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async init() {
+        await mkdir(this.opts.dir, { recursive: true });
+        log.info(`fs backend ready at ${this.opts.dir}`);
+    }
+    async list() {
+        let names;
+        try {
+            names = await readdir(this.opts.dir);
+        }
+        catch (err) {
+            const e = err;
+            if (e.code === "ENOENT") {
+                return [];
+            }
+            throw err;
+        }
+        const out = [];
+        for (const name of names) {
+            if (name.startsWith(".") || name.endsWith(".tmp")) {
+                continue;
+            }
+            const full = resolve(this.opts.dir, name);
+            try {
+                const s = await stat(full);
+                if (!s.isFile()) {
+                    continue;
+                }
+                out.push({
+                    key: name,
+                    size: s.size,
+                    modifiedAt: s.mtime.toISOString(),
+                });
+            }
+            catch (err) {
+                log.debug(`stat ${full}: ${err.message}`);
+            }
+        }
+        return out;
+    }
+    async get(key) {
+        return readFile(resolve(this.opts.dir, key));
+    }
+    async put(key, data) {
+        const dest = resolve(this.opts.dir, key);
+        const tmp = `${dest}.tmp`;
+        await writeFile(tmp, data);
+        await rename(tmp, dest);
+    }
+    async delete(key) {
+        try {
+            await unlink(resolve(this.opts.dir, key));
+        }
+        catch (err) {
+            const e = err;
+            if (e.code !== "ENOENT") {
+                throw err;
+            }
+        }
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/backend/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/backend/fs.ts"],"names":[],"mappings":"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"}