@casey.gowrie/eve-ext-notes 0.1.0

package/README.md

@@ -0,0 +1,41 @@
+# @casey.gowrie/eve-ext-notes
+
+An [eve](https://github.com/vercel/eve) extension: a durable **notes toolkit**.
+It contributes tools, a hook, and a skill that compose into any consuming agent
+under a namespace.
+
+## Contents
+
+- **Tools** — `add_note`, `list_notes`, `clear_notes`. Notes persist in
+  extension-scoped [`defineState`](https://eve.dev/docs), so they survive across
+  a session and never collide with the host agent's state.
+- **Hook** — `audit`: observe-only logging of every successful note save.
+- **Skill** — `daily-standup`: turns saved notes into a standup summary.
+
+## Config
+
+Bound once when the consumer mounts the extension:
+
+| key        | type   | default | meaning                      |
+| ---------- | ------ | ------- | ---------------------------- |
+| `maxNotes` | number | `50`    | Cap on stored notes.         |
+
+## Install & mount
+
+```bash
+npm install @casey.gowrie/eve-ext-notes
+```
+
+```ts title="agent/extensions/notes.ts"
+import notes from "@casey.gowrie/eve-ext-notes";
+
+export default notes({ maxNotes: 25 });
+```
+
+The mount file's basename is the namespace, so tools compose as `notes__add_note`,
+`notes__list_notes`, and `notes__clear_notes`.
+
+## Requirements
+
+`eve` is a **peer dependency** (`^0.22.3`): the consuming app supplies the single
+eve install that resolves this extension's `eve/*` imports.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+// Generated by eve. Do not edit by hand.
+
+export { default } from "../ext/extension.js";
+export { default as eve_ext_notes } from "../ext/extension.js";

package/dist/index.mjs

@@ -0,0 +1,18 @@
+import { fileURLToPath as __eveFileURLToPath } from "node:url";
+import { dirname as __eveDirname } from "node:path";
+import { createRequire as __eveCreateRequire } from "node:module";
+__eveDirname(__eveFileURLToPath(import.meta.url));
+__eveCreateRequire(import.meta.url);
+import { defineExtension } from "eve/extension";
+import { z } from "zod";
+//#region \0eve-ext-scope:extension:casey.gowrie-eve-ext-notes
+function defineExtension$1(options, namespace) {
+	return defineExtension(options, namespace === void 0 ? "casey.gowrie-eve-ext-notes" : namespace);
+}
+//#endregion
+//#region ext/extension.ts
+var extension_default = defineExtension$1({ config: z.object({ maxNotes: z.number().int().positive().default(50) }) });
+//#endregion
+export { extension_default as default, extension_default as eve_ext_notes };
+
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJuYW1lcyI6WyJkZWZpbmVFeHRlbnNpb24iXSwic291cmNlcyI6WyIuLi9leHQvZXh0ZW5zaW9uLnRzIl0sInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IGRlZmluZUV4dGVuc2lvbiB9IGZyb20gXCJldmUvZXh0ZW5zaW9uXCI7XG5pbXBvcnQgeyB6IH0gZnJvbSBcInpvZFwiO1xuXG5leHBvcnQgZGVmYXVsdCBkZWZpbmVFeHRlbnNpb24oe1xuICBjb25maWc6IHoub2JqZWN0KHtcbiAgICBtYXhOb3Rlczogei5udW1iZXIoKS5pbnQoKS5wb3NpdGl2ZSgpLmRlZmF1bHQoNTApLFxuICB9KSxcbn0pO1xuIl0sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7O0FBR0EsSUFBQSxvQkFBQSxrQkFBQSxFQUFBLFFBQUEsRUFBQSxPQUFBLEVBQUEsVUFBQSxFQUFBLE9BQUEsQ0FBQSxDQUFBLElBQUEsQ0FBQSxDQUFBLFNBQUEsQ0FBQSxDQUFBLFFBQUEsRUFBQSxFQUFBLENBQUEsRUFBQSxDQUFBIn0=

package/dist/tools/index.d.ts

@@ -0,0 +1,5 @@
+// Generated by eve. Do not edit by hand.
+
+export { default as add_note } from "../../ext/tools/add_note.js";
+export { default as clear_notes } from "../../ext/tools/clear_notes.js";
+export { default as list_notes } from "../../ext/tools/list_notes.js";

package/dist/tools/index.mjs

@@ -0,0 +1,73 @@
+import { fileURLToPath as __eveFileURLToPath } from "node:url";
+import { dirname as __eveDirname } from "node:path";
+import { createRequire as __eveCreateRequire } from "node:module";
+__eveDirname(__eveFileURLToPath(import.meta.url));
+__eveCreateRequire(import.meta.url);
+import { defineTool } from "eve/tools";
+import { z } from "zod";
+import { defineExtension } from "eve/extension";
+import { defineState } from "eve/context";
+//#region \0eve-ext-scope:extension:casey.gowrie-eve-ext-notes
+function defineExtension$1(options, namespace) {
+	return defineExtension(options, namespace === void 0 ? "casey.gowrie-eve-ext-notes" : namespace);
+}
+//#endregion
+//#region ext/extension.ts
+var extension_default = defineExtension$1({ config: z.object({ maxNotes: z.number().int().positive().default(50) }) });
+//#endregion
+//#region \0eve-ext-scope:context:casey.gowrie-eve-ext-notes
+function defineState$1(name, initial) {
+	return defineState("casey.gowrie-eve-ext-notes." + name, initial);
+}
+//#endregion
+//#region ext/lib/store.ts
+const notes = defineState$1("notes", () => []);
+//#endregion
+//#region ext/tools/add_note.ts
+var add_note_default = defineTool({
+	description: "Save a short note to the durable notes list for later recall.",
+	inputSchema: z.object({ text: z.string().min(1).describe("The note to remember.") }),
+	async execute({ text }) {
+		const { maxNotes } = extension_default.config;
+		if (notes.get().length >= maxNotes) return {
+			ok: false,
+			reason: `note limit reached (${maxNotes})`
+		};
+		notes.update((list) => [...list, {
+			text,
+			createdAt: new Date().toISOString()
+		}]);
+		return {
+			ok: true,
+			count: notes.get().length
+		};
+	}
+});
+//#endregion
+//#region ext/tools/clear_notes.ts
+var clear_notes_default = defineTool({
+	description: "Delete all saved notes and report how many were removed.",
+	inputSchema: z.object({}),
+	async execute() {
+		const cleared = notes.get().length;
+		notes.update(() => []);
+		return { cleared };
+	}
+});
+//#endregion
+//#region ext/tools/list_notes.ts
+var list_notes_default = defineTool({
+	description: "List every saved note, oldest first.",
+	inputSchema: z.object({}),
+	async execute() {
+		const list = notes.get();
+		return {
+			count: list.length,
+			notes: list
+		};
+	}
+});
+//#endregion
+export { add_note_default as add_note, clear_notes_default as clear_notes, list_notes_default as list_notes };
+
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJuYW1lcyI6WyJkZWZpbmVFeHRlbnNpb24iLCJkZWZpbmVTdGF0ZSIsImV4dGVuc2lvbiJdLCJzb3VyY2VzIjpbIi4uL2V4dC9leHRlbnNpb24udHMiLCIuLi9leHQvbGliL3N0b3JlLnRzIiwiLi4vZXh0L3Rvb2xzL2FkZF9ub3RlLnRzIiwiLi4vZXh0L3Rvb2xzL2NsZWFyX25vdGVzLnRzIiwiLi4vZXh0L3Rvb2xzL2xpc3Rfbm90ZXMudHMiXSwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgZGVmaW5lRXh0ZW5zaW9uIH0gZnJvbSBcImV2ZS9leHRlbnNpb25cIjtcbmltcG9ydCB7IHogfSBmcm9tIFwiem9kXCI7XG5cbmV4cG9ydCBkZWZhdWx0IGRlZmluZUV4dGVuc2lvbih7XG4gIGNvbmZpZzogei5vYmplY3Qoe1xuICAgIG1heE5vdGVzOiB6Lm51bWJlcigpLmludCgpLnBvc2l0aXZlKCkuZGVmYXVsdCg1MCksXG4gIH0pLFxufSk7XG4iLCJpbXBvcnQgeyBkZWZpbmVTdGF0ZSB9IGZyb20gXCJldmUvY29udGV4dFwiO1xuXG5leHBvcnQgaW50ZXJmYWNlIE5vdGUge1xuICB0ZXh0OiBzdHJpbmc7XG4gIGNyZWF0ZWRBdDogc3RyaW5nO1xufVxuXG4vLyBkZWZpbmVTdGF0ZSBpbiBhbiBleHRlbnNpb24gaXMgYXV0b21hdGljYWxseSBzY29wZWQgdG8gdGhpcyBwYWNrYWdlLCBzbyB0aGVcbi8vIFwibm90ZXNcIiBrZXkgbmV2ZXIgY29sbGlkZXMgd2l0aCB0aGUgY29uc3VtaW5nIGFnZW50IG9yIGFub3RoZXIgZXh0ZW5zaW9uLlxuZXhwb3J0IGNvbnN0IG5vdGVzID0gZGVmaW5lU3RhdGU8Tm90ZVtdPihcIm5vdGVzXCIsICgpID0+IFtdKTtcbiIsImltcG9ydCB7IGRlZmluZVRvb2wgfSBmcm9tIFwiZXZlL3Rvb2xzXCI7XG5pbXBvcnQgeyB6IH0gZnJvbSBcInpvZFwiO1xuXG5pbXBvcnQgZXh0ZW5zaW9uIGZyb20gXCIuLi9leHRlbnNpb25cIjtcbmltcG9ydCB7IG5vdGVzIH0gZnJvbSBcIi4uL2xpYi9zdG9yZVwiO1xuXG5leHBvcnQgZGVmYXVsdCBkZWZpbmVUb29sKHtcbiAgZGVzY3JpcHRpb246IFwiU2F2ZSBhIHNob3J0IG5vdGUgdG8gdGhlIGR1cmFibGUgbm90ZXMgbGlzdCBmb3IgbGF0ZXIgcmVjYWxsLlwiLFxuICBpbnB1dFNjaGVtYTogei5vYmplY3Qoe1xuICAgIHRleHQ6IHouc3RyaW5nKCkubWluKDEpLmRlc2NyaWJlKFwiVGhlIG5vdGUgdG8gcmVtZW1iZXIuXCIpLFxuICB9KSxcbiAgYXN5bmMgZXhlY3V0ZSh7IHRleHQgfSkge1xuICAgIGNvbnN0IHsgbWF4Tm90ZXMgfSA9IGV4dGVuc2lvbi5jb25maWc7XG4gICAgaWYgKG5vdGVzLmdldCgpLmxlbmd0aCA+PSBtYXhOb3Rlcykge1xuICAgICAgcmV0dXJuIHsgb2s6IGZhbHNlIGFzIGNvbnN0LCByZWFzb246IGBub3RlIGxpbWl0IHJlYWNoZWQgKCR7bWF4Tm90ZXN9KWAgfTtcbiAgICB9XG4gICAgbm90ZXMudXBkYXRlKChsaXN0KSA9PiBbLi4ubGlzdCwgeyB0ZXh0LCBjcmVhdGVkQXQ6IG5ldyBEYXRlKCkudG9JU09TdHJpbmcoKSB9XSk7XG4gICAgcmV0dXJuIHsgb2s6IHRydWUgYXMgY29uc3QsIGNvdW50OiBub3Rlcy5nZXQoKS5sZW5ndGggfTtcbiAgfSxcbn0pO1xuIiwiaW1wb3J0IHsgZGVmaW5lVG9vbCB9IGZyb20gXCJldmUvdG9vbHNcIjtcbmltcG9ydCB7IHogfSBmcm9tIFwiem9kXCI7XG5cbmltcG9ydCB7IG5vdGVzIH0gZnJvbSBcIi4uL2xpYi9zdG9yZVwiO1xuXG5leHBvcnQgZGVmYXVsdCBkZWZpbmVUb29sKHtcbiAgZGVzY3JpcHRpb246IFwiRGVsZXRlIGFsbCBzYXZlZCBub3RlcyBhbmQgcmVwb3J0IGhvdyBtYW55IHdlcmUgcmVtb3ZlZC5cIixcbiAgaW5wdXRTY2hlbWE6IHoub2JqZWN0KHt9KSxcbiAgYXN5bmMgZXhlY3V0ZSgpIHtcbiAgICBjb25zdCBjbGVhcmVkID0gbm90ZXMuZ2V0KCkubGVuZ3RoO1xuICAgIG5vdGVzLnVwZGF0ZSgoKSA9PiBbXSk7XG4gICAgcmV0dXJuIHsgY2xlYXJlZCB9O1xuICB9LFxufSk7XG4iLCJpbXBvcnQgeyBkZWZpbmVUb29sIH0gZnJvbSBcImV2ZS90b29sc1wiO1xuaW1wb3J0IHsgeiB9IGZyb20gXCJ6b2RcIjtcblxuaW1wb3J0IHsgbm90ZXMgfSBmcm9tIFwiLi4vbGliL3N0b3JlXCI7XG5cbmV4cG9ydCBkZWZhdWx0IGRlZmluZVRvb2woe1xuICBkZXNjcmlwdGlvbjogXCJMaXN0IGV2ZXJ5IHNhdmVkIG5vdGUsIG9sZGVzdCBmaXJzdC5cIixcbiAgaW5wdXRTY2hlbWE6IHoub2JqZWN0KHt9KSxcbiAgYXN5bmMgZXhlY3V0ZSgpIHtcbiAgICBjb25zdCBsaXN0ID0gbm90ZXMuZ2V0KCk7XG4gICAgcmV0dXJuIHsgY291bnQ6IGxpc3QubGVuZ3RoLCBub3RlczogbGlzdCB9O1xuICB9LFxufSk7XG4iXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7OztBQUdBLElBQUEsb0JBQUEsa0JBQUEsRUFBQSxRQUFBLEVBQUEsT0FBQSxFQUFBLFVBQUEsRUFBQSxPQUFBLENBQUEsQ0FBQSxJQUFBLENBQUEsQ0FBQSxTQUFBLENBQUEsQ0FBQSxRQUFBLEVBQUEsRUFBQSxDQUFBLEVBQUEsQ0FBQTs7Ozs7Ozs7QUNNQSxNQUFBLFFBQUEsY0FBQSxlQUFBLENBQUEsQ0FBQTs7O0FDSEEsSUFBQSxtQkFBQSxXQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFhQSxDQUFBOzs7QUNkQSxJQUFBLHNCQUFBLFdBQUE7Ozs7Ozs7O0FBUUEsQ0FBQTs7O0FDUkEsSUFBQSxxQkFBQSxXQUFBOzs7Ozs7Ozs7O0FBT0EsQ0FBQSJ9

package/ext/extension.ts

@@ -0,0 +1,8 @@
+import { defineExtension } from "eve/extension";
+import { z } from "zod";
+
+export default defineExtension({
+  config: z.object({
+    maxNotes: z.number().int().positive().default(50),
+  }),
+});

package/ext/hooks/audit.ts

@@ -0,0 +1,18 @@
+import { defineHook } from "eve/hooks";
+import { toolResultFrom } from "eve/tools";
+
+import addNote from "../tools/add_note";
+
+// Observe-only: log every successful note save. `toolResultFrom` keys off the
+// tool definition, so it matches the namespaced result (`<mount>__add_note`)
+// regardless of how the consuming agent names the mount.
+export default defineHook({
+  events: {
+    "action.result"(event) {
+      const saved = toolResultFrom(event.data.result, addNote);
+      if (saved?.output.ok) {
+        console.info("[notes] saved note", { count: saved.output.count });
+      }
+    },
+  },
+});

package/ext/instructions.md

@@ -0,0 +1,3 @@
+When the user shares something worth remembering, save it with the notes tools.
+Recall saved notes with `list_notes`, and load the `daily-standup` skill when
+they ask for a summary of what they noted.

package/ext/lib/store.ts

@@ -0,0 +1,10 @@
+import { defineState } from "eve/context";
+
+export interface Note {
+  text: string;
+  createdAt: string;
+}
+
+// defineState in an extension is automatically scoped to this package, so the
+// "notes" key never collides with the consuming agent or another extension.
+export const notes = defineState<Note[]>("notes", () => []);

package/ext/skills/daily-standup/SKILL.md

@@ -0,0 +1,18 @@
+---
+description: Turn the saved notes into a concise daily standup summary.
+---
+
+# Daily standup
+
+Use this when the user asks for a standup, daily summary, or "what did I note".
+
+1. Call `list_notes` to retrieve every saved note.
+2. If there are no notes, say so plainly and stop — do not invent activity.
+3. Otherwise, group the notes into three sections, inferring placement from each
+   note's wording:
+   - **Done** — completed work.
+   - **In progress** — ongoing work.
+   - **Blockers / next** — anything that reads as stuck, waiting, or a to-do.
+4. Render each section as a short bullet list. Keep the original wording; do not
+   embellish. Omit a section that has no matching notes.
+5. End with a one-line count, e.g. "5 notes since <earliest createdAt>".

package/ext/tools/add_note.ts

@@ -0,0 +1,20 @@
+import { defineTool } from "eve/tools";
+import { z } from "zod";
+
+import extension from "../extension";
+import { notes } from "../lib/store";
+
+export default defineTool({
+  description: "Save a short note to the durable notes list for later recall.",
+  inputSchema: z.object({
+    text: z.string().min(1).describe("The note to remember."),
+  }),
+  async execute({ text }) {
+    const { maxNotes } = extension.config;
+    if (notes.get().length >= maxNotes) {
+      return { ok: false as const, reason: `note limit reached (${maxNotes})` };
+    }
+    notes.update((list) => [...list, { text, createdAt: new Date().toISOString() }]);
+    return { ok: true as const, count: notes.get().length };
+  },
+});

package/ext/tools/clear_notes.ts

@@ -0,0 +1,14 @@
+import { defineTool } from "eve/tools";
+import { z } from "zod";
+
+import { notes } from "../lib/store";
+
+export default defineTool({
+  description: "Delete all saved notes and report how many were removed.",
+  inputSchema: z.object({}),
+  async execute() {
+    const cleared = notes.get().length;
+    notes.update(() => []);
+    return { cleared };
+  },
+});

package/ext/tools/list_notes.ts

@@ -0,0 +1,13 @@
+import { defineTool } from "eve/tools";
+import { z } from "zod";
+
+import { notes } from "../lib/store";
+
+export default defineTool({
+  description: "List every saved note, oldest first.",
+  inputSchema: z.object({}),
+  async execute() {
+    const list = notes.get();
+    return { count: list.length, notes: list };
+  },
+});

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@casey.gowrie/eve-ext-notes",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "eve extension: durable notes toolkit (tools + hook + skill).",
+  "license": "MIT",
+  "keywords": [
+    "eve",
+    "eve-extension",
+    "agent",
+    "notes"
+  ],
+  "eve": {
+    "extension": "./ext"
+  },
+  "files": [
+    "ext",
+    "dist"
+  ],
+  "peerDependencies": {
+    "eve": "^0.22.3"
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "eve": "^0.22.3",
+    "typescript": "^5",
+    "@types/node": "^22"
+  },
+  "scripts": {
+    "build": "eve build",
+    "prepare": "eve build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.mjs"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "default": "./dist/tools/index.mjs"
+    }
+  }
+}