Plot Activity intents now take an object that can include examples

Author: KrisBraun

.changeset/cool-candles-brush.md

@@ -0,0 +1,5 @@
+---
+"@plotday/agent": minor
+---
+
+Changed: BREAKING: Plot Activity intents now take an object that can include examples

agents/chat/package.json

@@ -10,7 +10,8 @@
   "private": true,
   "scripts": {
     "deploy": "plot deploy",
-    "lint": "plot lint"
+    "lint": "plot lint",
+    "logs": "plot logs"
   },
   "dependencies": {
     "@plotday/agent": "workspace:^",

agents/chat/src/index.ts

@@ -18,9 +18,15 @@ export default class ChatAgent extends Agent<ChatAgent> {
       plot: build(Plot, {
         activity: {
           access: ActivityAccess.Respond,
-          intents: {
-            "Respond to general questions and requests": this.responsd,
-          },
+          intents: [{
+            description: "Respond to general questions and requests",
+            examples: [
+              "What's the weather like?",
+              "Can you help me plan my day?",
+              "Write me a summary of this article"
+            ],
+            handler: this.responsd,
+          }],
         },
       }),
     };

builder/src/plot.ts

@@ -319,8 +319,9 @@ export type Activity = {
  */
 export type NewActivity = Pick<Activity, "type"> &
   Partial<
-    Omit<Activity, "id" | "author" | "type" | "parent"> & {
+    Omit<Activity, "id" | "author" | "type" | "parent" | "priority"> & {
       parent?: Pick<Activity, "id"> | null;
+      priority?: Pick<Priority, "id">;
     }
   >;
 

builder/src/tools/plot.ts

@@ -45,6 +45,19 @@ export enum ContactAccess {
   Write,
 }
 
+/**
+ * Intent handler for activity mentions.
+ * Defines how the agent should respond when mentioned in an activity.
+ */
+export type ActivityIntentHandler = {
+  /** Human-readable description of what this intent handles */
+  description: string;
+  /** Example phrases or activity content that would match this intent */
+  examples: string[];
+  /** The function to call when this intent is matched */
+  handler: (activity: Activity) => Promise<void>;
+};
+
 /**
  * Built-in tool for interacting with the core Plot data layer.
  *
@@ -107,13 +120,18 @@ export abstract class Plot extends ITool {
        *
        * @example
        * ```typescript
-       * intents: {
-       *   "Schedule or reschedule calendar events": this.onSchedulingRequest,
-       *   "Find available meeting times": this.onAvailabilityRequest
-       * }
+       * intents: [{
+       *   description: "Schedule or reschedule calendar events",
+       *   examples: ["Schedule a meeting tomorrow at 2pm", "Move my 3pm meeting to 4pm"],
+       *   handler: this.onSchedulingRequest
+       * }, {
+       *   description: "Find available meeting times",
+       *   examples: ["When am I free this week?", "Find time for a 1 hour meeting"],
+       *   handler: this.onAvailabilityRequest
+       * }]
        * ```
        */
-      intents?: Record<string, (activity: Activity) => Promise<void>>;
+      intents?: ActivityIntentHandler[];
     };
     priority?: {
       access?: PriorityAccess;