durable-actors 0.5.2 → 0.5.4

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.4",
         "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.4",
         "react": "^19.3.0",
         "react-dom": "^19.3.0",
         "yjs": "^13.6.32"

package/dist/templates/python/.env.example

@@ -0,0 +1 @@
+DURABLE_ACTORS_ENTRYPOINT=src/actors.py

package/dist/templates/python/README.md

@@ -0,0 +1,7 @@
+# Python actors
+
+Install Node.js 22+, Python 3.11+, and uv. Run `pnpm install`, `uv sync`, then `pnpm exec durable-actors dev`. The shared TypeScript CLI selects `.venv` and checks actor types before starting and reloading.
+
+Edit `src/actors.py`. Write synchronous actor methods with ordinary `def`. Annotated fields persist by default; use `emitted()` for state broadcasts and `ephemeral()` for temporary values such as caches and service clients. From your client application, install `little-actors[codegen]` and run `pnpm exec durable-actors generate` against the running server. Generated Python clients include synchronous typed methods and models. Import `actors` from the generated package and use `actors.Counter.get("one")`; the SDK manages the HTTP connection pool. Actors with emitted fields also expose `actor.subscribe(callback)` for typed live state; close the returned subscription when finished. The CLI runs strict mypy after generation.
+
+Set `DURABLE_ACTORS_PYTHON` to select another interpreter. `DURABLE_ACTORS_BINARY` selects a locally built runtime.

package/dist/templates/python/gitignore

@@ -0,0 +1,6 @@
+node_modules/
+.venv/
+.durable-actors/
+.mypy_cache/
+__pycache__/
+generated/

package/dist/templates/python/package.json

@@ -0,0 +1,11 @@
+{
+    "name": "durable-actors-example-python",
+    "private": true,
+    "dependencies": {
+        "durable-actors": "0.5.4"
+    },
+    "scripts": {
+        "dev": "durable-actors dev",
+        "generate": "durable-actors generate"
+    }
+}

package/dist/templates/python/pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+allowBuilds:
+    esbuild: true

package/dist/templates/python/pyproject.toml

@@ -0,0 +1,8 @@
+[project]
+name = "little-actors-example"
+version = "0.1.0"
+requires-python = ">=3.11"
+dependencies = ["little-actors[codegen]==0.5.4"]
+
+[tool.mypy]
+strict = true

package/dist/templates/python/src/actors.py

@@ -0,0 +1,9 @@
+from little_actors import Actor
+
+
+class Counter(Actor):
+    count: int = 0
+
+    def increment(self, amount: int = 1) -> int:
+        self.count += amount
+        return self.count

package/dist/wire/public-contract.d.ts

@@ -1,4 +1,5 @@
 import type { JSONSchema7 } from "json-schema";
+import type { SandboxOptions } from "../actor/sandbox.js";
 import type { SocketContract } from "./contract.js";
 interface PublicActorContract {
     readonly version: 1;
@@ -11,6 +12,8 @@ interface TypeScriptContract {
 }
 interface ActorApi {
     readonly actorName: string;
+    readonly description?: string;
+    readonly sandbox?: SandboxOptions;
     readonly socket: SocketContract;
     readonly rpc: RpcContract;
 }
@@ -20,6 +23,7 @@ interface RpcContract {
 }
 interface RpcMethod {
     readonly name: string;
+    readonly description?: string;
     readonly parameters: readonly RpcParameter[];
     readonly result: {
         readonly kind: "void";

package/dist/wire/public-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public-contract.d.ts","sourceRoot":"","sources":["../../src/wire/public-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnD,UAAU,mBAAmB;IACzB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAA;IACpC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAA;CAC1C;AAED,UAAU,kBAAkB;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAC1D;AAED,UAAU,QAAQ;IACd,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;CAC5B;AAED,UAAU,WAAW;IACjB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAA;CACzC;AAED,UAAU,SAAS;IACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,CAAA;IAC5C,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;KAAE,CAAA;CACxG;AAED,UAAU,YAAY;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAC/B;AAED,UAAU,aAAa;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACxB;AAED,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,CAAA"}
+{"version":3,"file":"public-contract.d.ts","sourceRoot":"","sources":["../../src/wire/public-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnD,UAAU,mBAAmB;IACzB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAA;IACpC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAA;CAC1C;AAED,UAAU,kBAAkB;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAC1D;AAED,UAAU,QAAQ;IACd,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;CAC5B;AAED,UAAU,WAAW;IACjB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAA;CACzC;AAED,UAAU,SAAS;IACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,CAAA;IAC5C,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;KAAE,CAAA;CACxG;AAED,UAAU,YAAY;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAC/B;AAED,UAAU,aAAa;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACxB;AAED,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "durable-actors",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "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.4"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/dist/actor/invocationContext.d.ts

@@ -1,4 +0,0 @@
-declare function runInActorInvocation<T>(operation: () => T): T;
-declare function currentActorInvocation(): true | undefined;
-export { currentActorInvocation, runInActorInvocation };
-//# sourceMappingURL=invocationContext.d.ts.map

package/dist/actor/invocationContext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"invocationContext.d.ts","sourceRoot":"","sources":["../../src/actor/invocationContext.ts"],"names":[],"mappings":"AAIA,iBAAS,oBAAoB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAEtD;AAED,iBAAS,sBAAsB,IAAI,IAAI,GAAG,SAAS,CAElD;AAED,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,CAAA"}

package/dist/actor/invocationContext.js

@@ -1,10 +0,0 @@
-import { AsyncLocalStorage } from "node:async_hooks";
-const invocationStorage = new AsyncLocalStorage();
-function runInActorInvocation(operation) {
-    return invocationStorage.run(true, operation);
-}
-function currentActorInvocation() {
-    return invocationStorage.getStore();
-}
-export { currentActorInvocation, runInActorInvocation };
-//# sourceMappingURL=invocationContext.js.map

package/dist/actor/invocationContext.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"invocationContext.js","sourceRoot":"","sources":["../../src/actor/invocationContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEpD,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAQ,CAAA;AAEvD,SAAS,oBAAoB,CAAI,SAAkB;IAC/C,OAAO,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;AACjD,CAAC;AAED,SAAS,sBAAsB;IAC3B,OAAO,iBAAiB,CAAC,QAAQ,EAAE,CAAA;AACvC,CAAC;AAED,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,CAAA"}