@mono-agent/agent-app 0.11.2 → 0.11.4

package/dist/pi-oauth-login.js

@@ -1,4 +1,5 @@
-import { chmod, readFile, writeFile } from "node:fs/promises";
+import { constants as fsConstants } from "node:fs";
+import { open } from "node:fs/promises";
 import { createInterface } from "node:readline";
 import { getOAuthProvider, } from "@earendil-works/pi-ai/oauth";
 /**
@@ -16,6 +17,7 @@ export async function runPiOAuthLogin(providerId, options = {}) {
     if (provider === undefined || provider.id !== providerId) {
         throw new Error(`Unknown bundled Pi OAuth provider: ${providerId}`);
     }
+    assertPiOAuthLoginPersistenceSupported(process.platform);
     const readline = options.io === undefined
         ? createInterface({ input: process.stdin, output: process.stdout })
         : undefined;
@@ -49,31 +51,63 @@ export async function runPiOAuthLogin(providerId, options = {}) {
         const credentials = await provider.login(callbacks);
         const authPath = options.authPath ?? "auth.json";
         const auth = await readAuth(authPath);
-        await writeFile(authPath, `${JSON.stringify({
+        await writeAuth(authPath, `${JSON.stringify({
             ...auth,
             [providerId]: { type: "oauth", ...credentials },
-        }, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
-        await chmod(authPath, 0o600);
+        }, null, 2)}\n`);
         io.write(`\nCredentials saved to ${authPath}\n`);
     }
     finally {
         readline?.close();
     }
 }
+/** @internal Exported only for deterministic platform-policy tests. */
+export function assertPiOAuthLoginPersistenceSupported(platform) {
+    if (platform === "win32") {
+        throw new Error("Direct Pi OAuth credential persistence is unavailable on Windows because symlink-safe owner-only writes cannot be verified.");
+    }
+}
 async function readAuth(path) {
+    let handle;
     let contents;
     try {
-        contents = await readFile(path, "utf8");
+        handle = await open(path, fsConstants.O_RDONLY | fsConstants.O_NOFOLLOW | fsConstants.O_NONBLOCK);
+        if (!(await handle.stat()).isFile()) {
+            throw new Error(`${path} must be a regular file.`);
+        }
+        contents = await handle.readFile("utf8");
     }
     catch (error) {
         if (error.code === "ENOENT")
             return {};
         throw error;
     }
+    finally {
+        await handle?.close();
+    }
     const parsed = JSON.parse(contents);
     if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
         throw new Error(`${path} must contain a JSON object.`);
     }
     return parsed;
 }
+async function writeAuth(path, contents) {
+    let handle;
+    try {
+        handle = await open(path, fsConstants.O_WRONLY | fsConstants.O_NOFOLLOW | fsConstants.O_NONBLOCK | fsConstants.O_CREAT, 0o600);
+        if (!(await handle.stat()).isFile()) {
+            throw new Error(`${path} must be a regular file.`);
+        }
+        // Tighten an existing file through the already-open inode before replacing
+        // its contents, so new credentials are never exposed under an old mode.
+        await handle.chmod(0o600);
+        // O_WRONLY opens at offset zero. Truncate explicitly so a shorter JSON
+        // replacement cannot retain bytes from the prior credential store.
+        await handle.truncate(0);
+        await handle.writeFile(contents, "utf8");
+    }
+    finally {
+        await handle?.close();
+    }
+}
 //# sourceMappingURL=pi-oauth-login.js.map

package/dist/pi-oauth-login.js.map

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

package/dist/posted-message-index.d.ts

@@ -11,14 +11,27 @@
  * producing conversationId`; the consumer (inbound dispatch) looks it up and
  * aliases the reply onto the producing conversation.
  *
- * Storage is an append-only JSONL file inside the run-artifact dir. Append-only
- * keeps cross-process writes safe: the `SlackSendMessage` child process and the
- * adapter both only ever append (small `O_APPEND` writes are atomic), and only the
- * single adapter process compacts. A `.jsonl` file is ignored by the
- * `.summary.json` artifact scanners (see `seen-conversations.ts`), so it never
- * collides with run-artifact tooling.
+ * Storage is a JSONL file inside the run-artifact dir. Appenders, readers,
+ * startup maintenance, recovery, and compaction serialize through one
+ * owner-only SQLite coordinator. Compaction appends a durable recovery trailer
+ * to the verified index inode, then rewrites that same inode through its pinned
+ * descriptor; it never promotes or later reopens a source pathname. The index
+ * and coordinator are opened no-follow and must remain current-owner, regular,
+ * single-link files. These files are ignored by the `.summary.json` artifact
+ * scanners (see `seen-conversations.ts`), so they never collide with run-artifact
+ * tooling.
  */
 export declare const POSTED_MESSAGE_INDEX_FILENAME = "posted-message-index.jsonl";
+interface PostedMessageIndexCompactionHooks {
+    readonly beforePrepare?: () => Promise<void>;
+    /** Test-only boundary after recovery bytes but before the commit footer. */
+    readonly afterPrepareBody?: () => Promise<void>;
+    readonly beforeReplace?: () => Promise<void>;
+    /** Test-only boundary after the final pathname checks and before pinned-FD rewrite. */
+    readonly afterPromotionChecks?: (indexPath: string) => Promise<void>;
+    /** Test-only boundary after the replacement prefix is durable but before truncate. */
+    readonly afterRewriteSync?: () => Promise<void>;
+}
 export interface PostedMessageEntry {
     /** Slack channel/DM id the message was posted to. */
     readonly channelId: string;
@@ -34,17 +47,22 @@ export declare function resolvePostedMessageIndexPath(artifactDir: string): stri
 /** Strip a trailing daily-rollover bucket so the stored id is the base producing id. */
 export declare function basePostedConversationId(conversationId: string): string;
 /**
- * Record that `conversationId` posted a message at `(channelId, ts)`. Best-effort:
- * a failed index write must never fail the Slack post, so callers should not await
- * this in a way that surfaces its errors — it swallows them. The stored
- * conversationId is de-bucketed so the consumer can let the responder re-bucket to
- * the reply's own day (consistent with daily session rollover).
+ * Record that `conversationId` posted a message at `(channelId, ts)`. Appenders in
+ * both the adapter and its stdio child share a filesystem lock with compaction, so
+ * a rewrite cannot discard a completed concurrent append. Once the cap is reached,
+ * compaction drops a batch of oldest entries before appending; this keeps the file
+ * at or below the cap without a full rewrite on every later send.
+ *
+ * Best-effort: a failed index write or lock acquisition must never fail the Slack
+ * post, so this function swallows errors. The stored conversationId is de-bucketed
+ * so the consumer can let the responder re-bucket to the reply's own day
+ * (consistent with daily session rollover).
  */
 export declare function appendPostedMessage(indexPath: string, entry: {
     channelId: string;
     ts: string;
     conversationId: string;
-}, now?: () => Date): Promise<void>;
+}, now?: () => Date, maxEntries?: number, compactionHooks?: PostedMessageIndexCompactionHooks): Promise<void>;
 /**
  * Resolve the producing conversationId for a posted message, newest write wins.
  * Returns `undefined` when the file is missing or has no matching entry, so the
@@ -53,9 +71,10 @@ export declare function appendPostedMessage(indexPath: string, entry: {
 export declare function lookupProducingConversation(indexPath: string, channelId: string, ts: string): Promise<string | undefined>;
 /**
  * Bound file growth by rewriting the index with only the newest `maxEntries`
- * (by write time, de-duped to the newest entry per `channel+ts`). Consumer-only —
- * a single process compacts, via temp-file + rename so a concurrent append is
- * never interleaved with a partial rewrite. Best-effort.
+ * (by write time, de-duped to the newest entry per `channel+ts`). Slack-driver
+ * startup invokes this exact routine, and every appender also uses the same
+ * unlocked implementation after taking this cross-process lock. Best-effort.
  */
-export declare function compactPostedMessageIndex(indexPath: string, maxEntries?: number): Promise<void>;
+export declare function compactPostedMessageIndex(indexPath: string, maxEntries?: number, hooks?: PostedMessageIndexCompactionHooks): Promise<void>;
+export {};
 //# sourceMappingURL=posted-message-index.d.ts.map

package/dist/posted-message-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"posted-message-index.d.ts","sourceRoot":"","sources":["../src/posted-message-index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,eAAO,MAAM,6BAA6B,+BAA+B,CAAC;AAO1E,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,sEAAsE;AACtE,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,EAChE,GAAG,GAAE,MAAM,IAAuB,GACjC,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAC/C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgB7B;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAAoC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAyBf"}
+{"version":3,"file":"posted-message-index.d.ts","sourceRoot":"","sources":["../src/posted-message-index.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,eAAO,MAAM,6BAA6B,+BAA+B,CAAC;AAuD1E,UAAU,iCAAiC;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,4EAA4E;IAC5E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,uFAAuF;IACvF,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,sFAAsF;IACtF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAoBD,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,sEAAsE;AACtE,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,EAChE,GAAG,GAAE,MAAM,IAAuB,EAClC,UAAU,GAAE,MAAoC,EAChD,eAAe,GAAE,iCAAsC,GACtD,OAAO,CAAC,IAAI,CAAC,CAuDf;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAC/C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAmB7B;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAAoC,EAChD,KAAK,GAAE,iCAAsC,GAC5C,OAAO,CAAC,IAAI,CAAC,CAYf"}