esoul-sdk 0.21.0 → 0.21.1

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 Releases before 0.20.0 are recorded in the repository history only.
 
+## 0.21.1
+
+### Fixed
+
+- **SimGmail people answer an agent's mail.** A persona that is a person (`reply`, `optout`) now reads and
+  answers mail marked `Auto-Submitted` (what an app's autonomous agent sends, RFC 3834) — as people do. Only a
+  machine responder (`ooo`) stays silent to it, and a dead address bounces it. Before, every persona ignored
+  it, so a simulated conversation with an autonomous agent stopped after the first reply.
+
+### Added
+
+- **`esoul-sdk/testing` exports the failed-request list** (`listFailedRequests`, `subscribeFailedRequests`,
+  `resetFailedRequests`) so a test can assert that a click which failed reverted and was named on the banner
+  (`runOptimistic` from `esoul-sdk/react`).
+
 ## 0.21.0
 
 ### Added

package/api-reference.md

@@ -3928,11 +3928,11 @@ interface WorkspaceTools {
 ```
 
 ==============================================================================
-## `esoul-sdk/testing` — 53 exports
+## `esoul-sdk/testing` — 56 exports
 
 Tests: run an op as a persona, an in-memory database with the real rules, recorders.
 
-### Functions and values (13)
+### Functions and values (16)
 
 #### `capture` — function · src/testing/ops.ts
 
@@ -3982,6 +3982,12 @@ A caller to run something as. Give it a `role` when your app declares its own vo
 function fakeViewer( kind: ViewerKind, opts: { userId?: string | null; viewerIds?: string[]; role?: string; name?: string | null; email?: string | null; attrs?: Record<string, string | number | boolean> } = {}, ): RuleViewer
 ```
 
+#### `listFailedRequests` — function · src/failed-requests.ts
+
+```ts
+function listFailedRequests(): FailedRequest[]
+```
+
 #### `memoryDb` — function · src/testing/db.ts
 
 A database for your app, from your manifest. Starts as the app's own code (an `internal` caller) so a test can seed rows, then `.as(someone)` to check what each kind of person may actually see.
@@ -3998,6 +4004,14 @@ An in-memory `FilesApi` over a tree you write in the test: folders are objects,
 function memoryFiles(sources: Record<string, MemoryFileTree>, opts?: { readOnly?: string[] }): MemoryFiles
 ```
 
+#### `resetFailedRequests` — function · src/failed-requests.ts
+
+Test-only: start from nothing.
+
+```ts
+function __resetFailedRequests(): void
+```
+
 #### `roleForKind` — function · src/testing/db.ts
 
 The app's own word for a kind of caller, read from the manifest's `roles`.
@@ -4038,6 +4052,12 @@ A real (tiny) OAuth2 provider for exercising the plugin-connection flow: /author
 function startMockOAuth(opts?: { port?: number; clientId?: string; accessTtlMs?: number; }): Promise<MockOAuthServer>
 ```
 
+#### `subscribeFailedRequests` — function · src/failed-requests.ts
+
+```ts
+function subscribeFailedRequests(l: Listener): () => void
+```
+
 ### Types (40)
 
 #### `BoundAppFixture` — interface · src/testing/ops.ts

package/dist/testing/index.d.ts

@@ -18,6 +18,8 @@ export { capture, fakeApps, runOp } from "./ops.js";
 export type { BoundAppFixture, EmitCall, NotifyCall, Recorder, RunOpOptions, RunOpResult } from "./ops.js";
 export { memoryFiles } from "./files.js";
 export { scriptedModel, defaultScriptedText } from "./llm.js";
+/** The failed-request banner's list, for a test that asserts a click reverted and was named (runOptimistic). */
+export { listFailedRequests, subscribeFailedRequests, __resetFailedRequests as resetFailedRequests } from "../failed-requests.js";
 export type { ScriptedLlm, ScriptedPolicy, ScriptedReply } from "./llm.js";
 export type { MemoryFiles, MemoryFileTree } from "./files.js";
 export { simGmail, DEFAULT_SIM_ACCOUNT, DEFAULT_CROWD_MIX } from "./sim-gmail/index.js";

package/dist/testing/index.js

@@ -16,6 +16,8 @@ export { fakeViewer, memoryDb, roleForKind } from "./db.js";
 export { capture, fakeApps, runOp } from "./ops.js";
 export { memoryFiles } from "./files.js";
 export { scriptedModel, defaultScriptedText } from "./llm.js";
+/** The failed-request banner's list, for a test that asserts a click reverted and was named (runOptimistic). */
+export { listFailedRequests, subscribeFailedRequests, __resetFailedRequests as resetFailedRequests } from "../failed-requests.js";
 export { simGmail, DEFAULT_SIM_ACCOUNT, DEFAULT_CROWD_MIX } from "./sim-gmail/index.js";
 import http from "node:http";
 import crypto from "node:crypto";

package/dist/testing/sim-gmail/personas.d.ts

@@ -26,6 +26,8 @@ export declare class Personas {
     crowd(n: number, mix?: CrowdMix, opts?: CrowdOptions, record?: boolean): CrowdMember[];
     private inboundView;
     private answerable;
+    /** Mail a machine sent (`Auto-Submitted` other than "no"): only a machine responder ignores it. */
+    private automated;
     private select;
     private intercept;
     private delivered;

package/dist/testing/sim-gmail/personas.js

@@ -7,8 +7,11 @@
  * travel through the same send path as an API send, after `latencyMs` of
  * virtual time (0 = before the sender's next request).
  *
- * Personas never answer auto-submitted mail, mailer-daemon, or another
- * persona — so two scripts cannot loop.
+ * Personas never answer mailer-daemon or another persona, so two scripts cannot
+ * loop. Auto-submitted mail (RFC 3834 — an agent's autonomous reply carries
+ * `Auto-Submitted: auto-replied`) is answered the way the world answers it: a
+ * PERSON (reply / opt-out) reads and answers it like any mail, a machine
+ * responder (out-of-office) stays silent, and a dead address bounces it.
  */
 import { buildMime, formatAddress, headerOf, parseAddressList, textOf } from "./mime.js";
 import { rfc2822 } from "./corpus.js";
@@ -99,13 +102,15 @@ export class Personas {
             count,
         };
     }
-    answerable(sender, msg, node = null) {
+    answerable(sender, msg) {
         if (sender.persona)
             return false;
-        if (/mailer-daemon@|postmaster@/i.test(msg.from))
-            return false;
+        return !/mailer-daemon@|postmaster@/i.test(msg.from);
+    }
+    /** Mail a machine sent (`Auto-Submitted` other than "no"): only a machine responder ignores it. */
+    automated(node) {
         const auto = node ? headerOf(node, "auto-submitted") : undefined;
-        return !auto || auto.toLowerCase() === "no";
+        return !!auto && auto.toLowerCase() !== "no";
     }
     select(state, inbound) {
         for (let i = 0; i < state.steps.length; i++) {
@@ -123,8 +128,7 @@ export class Personas {
         const state = this.states.get(recipient.address);
         if (!state)
             return false;
-        const node = this.world.nodeOf(sender, sentCopy);
-        if (!this.answerable(sender, sentCopy, node))
+        if (!this.answerable(sender, sentCopy))
             return false;
         const view = this.inboundView(sender, sentCopy, state.received + 1);
         const hit = this.select(state, view);
@@ -140,13 +144,17 @@ export class Personas {
         if (!state)
             return;
         const node = this.world.nodeOf(mb, msg);
-        if (sender ? !this.answerable(sender, msg, node) : /mailer-daemon@|postmaster@/i.test(msg.from) || !!headerOf(node, "auto-submitted"))
+        if (sender ? !this.answerable(sender, msg) : /mailer-daemon@|postmaster@/i.test(msg.from))
             return;
+        const auto = this.automated(node);
         state.received++;
         const view = this.inboundView(mb, msg, state.received);
         const hit = this.select(state, view);
         if (!hit)
             return;
+        // An out-of-office never answers a machine (the loop RFC 3834 prevents); a person does.
+        if (auto && hit.step.kind === "ooo")
+            return;
         state.consumed.add(hit.index);
         for (const step of [hit.step, ...(hit.step.also ?? [])])
             this.respond(mb, view, step);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "esoul-sdk",
-  "version": "0.21.0",
+  "version": "0.21.1",
   "description": "Build a full product on ExternalSoul: your own tables with per-person rules, a viewer on every seam, app roles, access levels, realtime with audiences, durable tasks, and bindings to other apps.",
   "license": "UNLICENSED",
   "type": "module",