state

Author: elithrar

src/content/docs/agents/examples/manage-and-sync-state.mdx

@@ -62,7 +62,7 @@ import { Agent } from "@cloudflare/agents";
 
 interface Env {}
 
-//
+// Define a type for your Agent's state
 interface FlightRecord {
 	id: string;
 	departureIata: string;
@@ -73,7 +73,18 @@ interface FlightRecord {
 
 // Pass in the type of your Agent's state
 export class MyAgent extends Agent<Env, FlightRecord> {
-  // This allows this.setState and
+  // This allows this.setState and the onStateUpdate method to
+  // be typed:
+ 	async onStateUpdate(state: FlightRecord) {
+  	console.log("state updated", state);
+  }
+
+  async someOtherMethod() {
+  	this.setState({
+  		...this.state,
+  		price: this.state.price + 10,
+  	});
+  }
 }
 ```
 

src/content/docs/agents/examples/schedule-tasks.mdx

@@ -37,6 +37,12 @@ export class SchedulingAgent extends Agent {
 ```
 </TypeScriptExample>
 
+:::caution
+
+Tasks that set a callback for a method that does not exist wil throw an exception.
+
+:::
+
 You can schedule tasks in multiple ways:
 
 <TypeScriptExample>
@@ -60,12 +66,6 @@ this.cancelSchedule(task.id);
 
 </TypeScriptExample>
 
-:::caution
-
-Tasks that set a callback for a method that does not exist will fail silently.
-
-:::
-
 Calling `await this.schedule` returns a `Schedule`, which includes the task's randomly generated `id`. You can use this `id` to retrieve or cancel the task in the future. It also provides a `type` property that indicates the type of schedule, for example, one of `"scheduled" | "delayed" | "cron"`.
 
 :::note[Maximum scheduled tasks]