durable-actors 0.5.2 → 0.5.3

package/README.md

@@ -1,4 +1,4 @@
-<div align="center">
+<div align="left">
   <a href="https://github.com/TerseAI/durable-actors/blob/main/.github/assets/team-agent.gif">
     <picture>
       <source media="(prefers-reduced-motion: reduce)" srcset="https://raw.githubusercontent.com/TerseAI/durable-actors/main/.github/assets/team-agent.png">
@@ -9,7 +9,7 @@
   <h1>Durable Actors</h1>
 
   <p><strong>Durable state for collaborative apps and AI agents.</strong></p>
-  <p>TypeScript actors. Rust runtime. Built by Terse.</p>
+  <p>TypeScript actors. Rust runtime.</p>
 
   <p>
     <a href="https://github.com/TerseAI/durable-actors/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/TerseAI/durable-actors?style=flat&amp;logo=github&amp;color=f5a623"></a>
@@ -97,17 +97,9 @@ console.log(await counter.increment())
 
 For complete sample applications, see [AI Chat](https://github.com/TerseAI/durable-actors/tree/main/examples/ai-chat), [Collaborative documents](https://github.com/TerseAI/durable-actors/tree/main/examples/documents), and [Chatroom](https://github.com/TerseAI/durable-actors/tree/main/examples/chat).
 
-## Define an Actor
+## Define an actor
 
-Install `ai` in your actor project:
-
-```sh
-pnpm install ai
-# Or with npm:
-npm install ai
-```
-
-Define and export actors in your actor project’s `src/actors.ts`, the default entrypoint loaded by `durable-actors dev`. For example, a chat history actor:
+Install `ai` in your actor project, then define actors in `src/actors.ts`. This chat history stores completed exchanges in one persisted array:
 
 ```ts
 import type { UIMessage } from "ai"
@@ -120,16 +112,15 @@ export class ChatHistory extends Actor {
         return this.messages
     }
 
-    async append(message: UIMessage) {
-        this.messages.push(message)
-        return this.messages
+    async append(...messages: UIMessage[]) {
+        this.messages.push(...messages)
     }
 }
 ```
 
-## Stream from the backend (Express)
+## Stream from your backend
 
-After adding `ChatHistory`, rerun `npx durable-actors generate` in your application and use its generated client:
+Generate a type-safe client with `npx durable-actors generate`. In your Express backend, load the conversation, stream a reply, and save the prompt and reply together when the stream succeeds:
 
 ```ts
 import { openai } from "@ai-sdk/openai"
@@ -149,7 +140,8 @@ app.post("/api/chat", async (request, response) => {
     const [message] = await validateUIMessages({ messages: [request.body.messages.at(-1)] })
     if (message.role !== "user") return response.sendStatus(400)
     const chat = actors.ChatHistory.get(request.body.id)
-    const messages = await chat.append(message)
+    const messages = [...(await chat.load()), message]
+    let failed = false
     const result = streamText({
         model: openai("gpt-5-mini"),
         messages: await convertToModelMessages(messages)
@@ -160,15 +152,23 @@ app.post("/api/chat", async (request, response) => {
             stream: result.stream,
             originalMessages: messages,
             generateMessageId: generateId,
+            onError: () => {
+                failed = true
+                return "Reply failed. Check the API key and try again."
+            },
             onEnd: async ({ responseMessage, outcome }) => {
-                if (outcome.status === "completed") await chat.append(responseMessage)
+                if (!failed && outcome.status === "completed") await chat.append(message, responseMessage)
             }
         })
     })
 })
 ```
 
-## Connect the frontend (React)
+Failed or interrupted attempts are not saved. Each completed exchange is persisted in one actor call.
+
+## Connect the frontend
+
+The AI SDK's `useChat` handles streaming and retries:
 
 ```tsx
 import { useChat } from "@ai-sdk/react"
@@ -177,7 +177,7 @@ import type { UIMessage } from "ai"
 const history: UIMessage[] = await fetch("/api/chat/lobby").then(response => response.json())
 
 function Chat() {
-    const { messages, sendMessage, status } = useChat({ id: "lobby", messages: history })
+    const { messages, sendMessage, regenerate, status, error } = useChat({ id: "lobby", messages: history })
     const busy = status === "submitted" || status === "streaming"
 
     return (
@@ -187,14 +187,11 @@ function Chat() {
                     {message.role}: {message.parts.map(part => (part.type === "text" ? part.text : "")).join("")}
                 </p>
             ))}
-            <form
-                action={async form => {
-                    await sendMessage({ text: String(form.get("message")) })
-                }}
-            >
+            <form action={async form => { await sendMessage({ text: String(form.get("message")) }) }}>
                 <input name="message" aria-label="Message" required disabled={busy} />
                 <button disabled={busy}>Send</button>
             </form>
+            {error && <p role="alert">{error.message} <button onClick={() => regenerate()} disabled={busy}>Retry</button></p>}
         </>
     )
 }

package/dist/cli/actor-source-watcher.d.ts

@@ -1,11 +1,25 @@
+import { watch } from "chokidar";
 interface ActorSourceWatcherOptions {
     projectDirectory: string;
     dataDirectory?: string;
 }
-interface ActorSourceWatcher {
+declare function watchActorSources(options: ActorSourceWatcherOptions, refresh: () => Promise<void>): Promise<ActorSourceWatcher>;
+declare class ActorSourceWatcher {
+    private readonly options;
+    private readonly refresh;
+    private readonly createWatcher;
+    private readonly warn;
+    private watcher?;
+    private timer?;
+    private updates;
+    private closing?;
+    private disabled;
+    constructor(options: ActorSourceWatcherOptions, refresh: () => Promise<void>, createWatcher: typeof watch, warn: (message: string) => void);
+    start(): Promise<void>;
     close(): Promise<void>;
+    private scheduleRefresh;
+    private waitUntilReady;
+    private disable;
 }
-declare function watchActorSources(options: ActorSourceWatcherOptions, refresh: () => Promise<void>): Promise<ActorSourceWatcher>;
-export { watchActorSources };
-export type { ActorSourceWatcher };
+export { ActorSourceWatcher, watchActorSources };
 //# sourceMappingURL=actor-source-watcher.d.ts.map

package/dist/cli/actor-source-watcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actor-source-watcher.d.ts","sourceRoot":"","sources":["../../src/cli/actor-source-watcher.ts"],"names":[],"mappings":"AAGA,UAAU,yBAAyB;IAC/B,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,UAAU,kBAAkB;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,iBAAe,iBAAiB,CAC5B,OAAO,EAAE,yBAAyB,EAClC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC7B,OAAO,CAAC,kBAAkB,CAAC,CAkC7B;AAqBD,OAAO,EAAE,iBAAiB,EAAE,CAAA;AAC5B,YAAY,EAAE,kBAAkB,EAAE,CAAA"}
+{"version":3,"file":"actor-source-watcher.d.ts","sourceRoot":"","sources":["../../src/cli/actor-source-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,EAAE,MAAM,UAAU,CAAA;AAGhD,UAAU,yBAAyB;IAC/B,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,iBAAe,iBAAiB,CAC5B,OAAO,EAAE,yBAAyB,EAClC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC7B,OAAO,CAAC,kBAAkB,CAAC,CAI7B;AAED,cAAM,kBAAkB;IAQhB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAVzB,OAAO,CAAC,OAAO,CAAC,CAAW;IAC3B,OAAO,CAAC,KAAK,CAAC,CAA+B;IAC7C,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,OAAO,CAAC,CAAe;IAC/B,OAAO,CAAC,QAAQ,CAAQ;gBAGH,OAAO,EAAE,yBAAyB,EAClC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC5B,aAAa,EAAE,OAAO,KAAK,EAC3B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;IAG9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,cAAc;YAgBR,OAAO;CAUxB;AAyBD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/cli/actor-source-watcher.js

@@ -1,39 +1,97 @@
 import { watch } from "chokidar";
 import path from "node:path";
 async function watchActorSources(options, refresh) {
-    const watcher = watch(options.projectDirectory, {
-        ignored: (watchedPath, stats) => ignoredActorPath(watchedPath, options) ||
-            (stats !== undefined && !stats.isDirectory() && (!stats.isFile() || !isActorSource(watchedPath))),
-        ignoreInitial: true,
-        followSymlinks: false,
-        atomic: true,
-        awaitWriteFinish: { stabilityThreshold: 100, pollInterval: 20 }
-    });
-    let timer;
-    let updates = Promise.resolve();
-    watcher.on("all", (_event, changedPath) => {
-        if (!isActorSource(changedPath))
+    const watcher = new ActorSourceWatcher(options, refresh, watch, message => console.warn(message));
+    await watcher.start();
+    return watcher;
+}
+class ActorSourceWatcher {
+    options;
+    refresh;
+    createWatcher;
+    warn;
+    watcher;
+    timer;
+    updates = Promise.resolve();
+    closing;
+    disabled = false;
+    constructor(options, refresh, createWatcher, warn) {
+        this.options = options;
+        this.refresh = refresh;
+        this.createWatcher = createWatcher;
+        this.warn = warn;
+    }
+    async start() {
+        try {
+            this.watcher = this.createWatcher(this.options.projectDirectory, {
+                ignored: (watchedPath, stats) => ignoredActorPath(watchedPath, this.options) ||
+                    (stats !== undefined && !stats.isDirectory() && (!stats.isFile() || !isActorSource(watchedPath))),
+                ignoreInitial: true,
+                followSymlinks: false,
+                atomic: true,
+                awaitWriteFinish: { stabilityThreshold: 100, pollInterval: 20 }
+            });
+            this.watcher.on("all", (_event, changedPath) => this.scheduleRefresh(changedPath));
+            await this.waitUntilReady(this.watcher);
+        }
+        catch (error) {
+            if (isWatchLimit(error))
+                await this.disable(error);
+            else {
+                await this.close();
+                throw error;
+            }
+        }
+    }
+    async close() {
+        this.disabled = true;
+        clearTimeout(this.timer);
+        if (!this.closing) {
+            this.closing = this.watcher?.close() ?? Promise.resolve();
+            // Chokidar removes listeners on close, but pending filesystem operations can still emit errors.
+            this.watcher?.on("error", () => { });
+        }
+        await this.closing;
+        await this.updates;
+    }
+    scheduleRefresh(changedPath) {
+        if (this.disabled || !isActorSource(changedPath))
             return;
-        clearTimeout(timer);
-        timer = setTimeout(() => {
-            updates = updates.then(refresh).catch(reportWatchError);
+        clearTimeout(this.timer);
+        this.timer = setTimeout(() => {
+            this.updates = this.updates.then(this.refresh).catch(reportWatchError);
         }, 75);
-    });
-    await new Promise((resolve, reject) => {
-        watcher.once("ready", resolve);
-        watcher.once("error", reject);
-    }).catch(async (error) => {
-        await watcher.close();
-        throw error;
-    });
-    watcher.on("error", reportWatchError);
-    return {
-        async close() {
-            clearTimeout(timer);
-            await watcher.close();
-            await updates;
-        }
-    };
+    }
+    waitUntilReady(watcher) {
+        return new Promise((resolve, reject) => {
+            let ready = false;
+            watcher.once("ready", () => {
+                ready = true;
+                resolve();
+            });
+            watcher.on("error", error => {
+                if (this.disabled)
+                    return;
+                if (isWatchLimit(error))
+                    void this.disable(error).then(resolve, reject);
+                else if (!ready)
+                    reject(error);
+                else
+                    reportWatchError(error);
+            });
+        });
+    }
+    async disable(error) {
+        if (!this.disabled)
+            this.warn(`Actor source watcher reached the OS file/watch limit (${error.code}). Automatic reload is disabled; ` +
+                "the development server will continue running. Restart it to apply source changes. " +
+                "Close other watchers or raise your OS file/watch limit, then restart to restore automatic reload. " +
+                "Use --no-watch to disable watching explicitly.");
+        await this.close();
+    }
+}
+function isWatchLimit(error) {
+    return error instanceof Error && "code" in error && ["EMFILE", "ENFILE", "ENOSPC"].includes(String(error.code));
 }
 function ignoredActorPath(candidate, options) {
     const relative = path.relative(options.projectDirectory, candidate);
@@ -55,5 +113,5 @@ function isActorSource(candidate) {
 function reportWatchError(error) {
     console.error(`Actor source update failed: ${error instanceof Error ? error.message : String(error)}`);
 }
-export { watchActorSources };
+export { ActorSourceWatcher, watchActorSources };
 //# sourceMappingURL=actor-source-watcher.js.map

package/dist/cli/actor-source-watcher.js.map

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

package/dist/templates/actor/package.json

@@ -10,7 +10,7 @@
         "check": "tsc --noEmit"
     },
     "dependencies": {
-        "durable-actors": "0.5.2"
+        "durable-actors": "0.5.3"
     },
     "devDependencies": {
         "@types/node": "^22.0.0",

package/dist/templates/ai-chat/README.md

@@ -29,36 +29,14 @@ Open [localhost:3000](http://127.0.0.1:3000), send a message, and reload after t
 
 ## Save the conversation
 
-[ChatHistory](src/actors.ts) keeps one conversation per actor ID:
+[ChatHistory](src/actors.ts) stores messages in one `@Persisted` array. The [backend](src/backend.ts) streams the model's reply, then saves the user message and completed reply together in one actor call.
 
-```ts
-import type { UIMessage } from "ai"
-import { Actor, Persisted } from "durable-actors"
-
-export class ChatHistory extends Actor {
-    @Persisted private messages: UIMessage[] = []
-
-    async load() {
-        return this.messages
-    }
-
-    async append(message: UIMessage) {
-        this.messages.push(message)
-        return this.messages
-    }
-}
-```
-
-## Stream the reply
-
-The [Express backend](src/backend.ts) appends the user message, sends the saved conversation to the model, and streams the reply. It saves the assistant message when the reply completes.
-
-The [React client](src/Chat.tsx) loads saved messages and uses `useChat` to display the stream. In-progress streams are not resumed after a reload.
+Failed or interrupted attempts are not saved. The [React client](src/Chat.tsx) shows the error and uses the AI SDK's built-in retry action. Reloading restores only completed exchanges; streams are not resumed.
 
 The lobby is shared and has no authentication. Add authentication and chat ownership checks before using it for private conversations.
 
 ## Development
 
-Both processes read `.env`; actor state lives in `.durable-actors/`. Actor code reloads automatically; restart `npm run dev` after editing the actor class imported by the backend. For multiple examples, set distinct `PORT`, `DURABLE_ACTORS_PORT`, and matching control-plane URLs; see [Run the examples together](../README.md).
+Both processes read `.env`; actor state lives in `.durable-actors/`. Actor code reloads automatically; restart `npm run dev` after editing the actor class imported by the backend. For multiple examples, set distinct `PORT`, `DURABLE_ACTORS_PORT`, and matching control-plane URLs; see [Run the examples together](https://github.com/TerseAI/durable-actors/tree/main/examples#run-the-examples-together).
 
 `npm run build` checks TypeScript and builds the frontend.

package/dist/templates/ai-chat/package.json

@@ -15,7 +15,7 @@
         "@ai-sdk/react": "^4.0.100",
         "ai": "^7.0.97",
         "express": "^5.2.1",
-        "durable-actors": "0.5.2",
+        "durable-actors": "0.5.3",
         "react": "^19.3.0",
         "react-dom": "^19.3.0"
     },

package/dist/templates/ai-chat/src/Chat.tsx

@@ -6,7 +6,7 @@ import type { UIMessage } from "ai"
 const initialMessages: UIMessage[] = await fetch("/api/chat/lobby").then(response => response.json())
 
 function Chat() {
-    const { messages, sendMessage, status, error } = useChat({ id: "lobby", messages: initialMessages })
+    const { messages, sendMessage, regenerate, status, error } = useChat({ id: "lobby", messages: initialMessages })
     const busy = status === "submitted" || status === "streaming"
 
     return (
@@ -29,7 +29,14 @@ function Chat() {
                 </label>
                 <button disabled={busy}>{busy ? "Thinking…" : "Send"}</button>
             </form>
-            {error && <p role="alert">{error.message}</p>}
+            {error && (
+                <p role="alert">
+                    {error.message}{" "}
+                    <button onClick={() => regenerate()} disabled={busy}>
+                        Retry
+                    </button>
+                </p>
+            )}
         </main>
     )
 }

package/dist/templates/ai-chat/src/actors.ts

@@ -8,8 +8,7 @@ export class ChatHistory extends Actor {
         return this.messages
     }
 
-    async append(message: UIMessage) {
-        this.messages.push(message)
-        return this.messages
+    async append(...messages: UIMessage[]) {
+        this.messages.push(...messages)
     }
 }

package/dist/templates/ai-chat/src/backend.ts

@@ -19,7 +19,8 @@ app.post("/api/chat", async (request, response) => {
     const [message] = await validateUIMessages({ messages: [request.body.messages.at(-1)] })
     if (message.role !== "user") return response.sendStatus(400)
     const chat = ChatHistory.get(request.body.id)
-    const messages = await chat.append(message)
+    const messages = [...(await chat.load()), message]
+    let failed = false
     const result = streamText({
         model: openai("gpt-5-mini"),
         messages: await convertToModelMessages(messages)
@@ -30,8 +31,12 @@ app.post("/api/chat", async (request, response) => {
             stream: result.stream,
             originalMessages: messages,
             generateMessageId: generateId,
+            onError: () => {
+                failed = true
+                return "Reply failed. Check the API key and try again."
+            },
             onEnd: async ({ responseMessage, outcome }) => {
-                if (outcome.status === "completed") await chat.append(responseMessage)
+                if (!failed && outcome.status === "completed") await chat.append(message, responseMessage)
             }
         })
     })

package/dist/templates/chat/README.md

@@ -69,6 +69,6 @@ Everyone joins as a guest. Add authentication and room access checks before issu
 
 ## Development
 
-Both processes read `.env`; saved state lives in `.durable-actors/`. Actor code reloads automatically. After changing public actor types, restart `npm run dev` to regenerate the client. For multiple examples, set distinct `PORT`, `DURABLE_ACTORS_PORT`, and matching control-plane URLs; see [Run the examples together](../README.md).
+Both processes read `.env`; saved state lives in `.durable-actors/`. Actor code reloads automatically. After changing public actor types, restart `npm run dev` to regenerate the client. For multiple examples, set distinct `PORT`, `DURABLE_ACTORS_PORT`, and matching control-plane URLs; see [Run the examples together](https://github.com/TerseAI/durable-actors/tree/main/examples#run-the-examples-together).
 
 `npm run build` generates clients, checks TypeScript, and builds the frontend.

package/dist/templates/chat/package.json

@@ -12,7 +12,7 @@
     },
     "dependencies": {
         "express": "^5.2.1",
-        "durable-actors": "0.5.2",
+        "durable-actors": "0.5.3",
         "react": "^19.3.0",
         "react-dom": "^19.3.0"
     },

package/dist/templates/documents/README.md

@@ -48,6 +48,6 @@ Editing pauses while disconnected. Reload to reconnect; unsaved edits are not st
 
 ## Development
 
-Both processes read `.env`; saved state lives in `.durable-actors/`. Actor code reloads automatically. After changing public actor types, restart `npm run dev` to regenerate the client. For multiple examples, set distinct `PORT`, `DURABLE_ACTORS_PORT`, and matching control-plane URLs; see [Run the examples together](../README.md).
+Both processes read `.env`; saved state lives in `.durable-actors/`. Actor code reloads automatically. After changing public actor types, restart `npm run dev` to regenerate the client. For multiple examples, set distinct `PORT`, `DURABLE_ACTORS_PORT`, and matching control-plane URLs; see [Run the examples together](https://github.com/TerseAI/durable-actors/tree/main/examples#run-the-examples-together).
 
 `npm run build` generates clients, checks TypeScript, and builds the frontend.

package/dist/templates/documents/package.json

@@ -19,7 +19,7 @@
         "@tiptap/y-tiptap": "^3.0.7",
         "express": "^5.2.1",
         "lib0": "^0.2.117",
-        "durable-actors": "0.5.2",
+        "durable-actors": "0.5.3",
         "react": "^19.3.0",
         "react-dom": "^19.3.0",
         "yjs": "^13.6.32"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "durable-actors",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "Provider-neutral actors for sandbox compute",
   "type": "module",
   "license": "MIT",
@@ -93,7 +93,7 @@
     "vite": "^8.3.0",
     "ws": "^8.18.3",
     "zod": "^4.3.6",
-    "durable-actors-observer": "0.5.2"
+    "durable-actors-observer": "0.5.3"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",