@economic/agents 0.0.1-beta.1 → 0.0.1-beta.2

package/README.md

@@ -202,6 +202,18 @@ When `fastModel` is set, compaction runs automatically with a default threshold
 
 When `fastModel` is `undefined` (the default), compaction is disabled regardless of `maxMessagesBeforeCompaction`.
 
+### `getConversations` (callable)
+
+`AIChatAgent` exposes a [callable method](https://developers.cloudflare.com/agents/api-reference/callable-methods/) via the Agents SDK `@callable()` decorator (`agents` package). From any connected client (for example the object returned by `useAgent` / `useAIChatAgent`), invoke:
+
+```typescript
+const rows = await agent.call("getConversations");
+```
+
+- **User scope**: `userId` is taken from the segment before the first `:` in the Durable Object name (`userId:chatId`), the same format enforced in `onConnect`.
+- **Data**: Reads from `AGENT_DB`, returning all `conversations` rows whose `durable_object_name` matches `userId:%`, ordered by `updated_at` descending (newest first). Each row includes `durable_object_name`, `title`, `summary`, `created_at`, and `updated_at`.
+- **No D1**: If `AGENT_DB` is not bound, the method returns `undefined` and does not throw.
+
 ### `getLoadedSkills()`
 
 Protected method on `AIChatAgent`. Returns skill names persisted from previous turns (read from DO SQLite). Used internally by `this.buildLLMParams()`.
@@ -546,12 +558,14 @@ No subclass code is needed — this runs automatically when `AGENT_DB` is bound
 
 ### Querying conversation lists
 
-To fetch all conversations for a user, ordered by most recent:
+From a connected agent client, prefer the built-in callable (see **`getConversations` (callable)** under [`AIChatAgent`](#aichatagent)): `await agent.call("getConversations")`.
+
+To query D1 directly (same logic as the callable), filter by `durable_object_name` prefix — one row per chat, keyed as `userId:chatId`:
 
 ```sql
-SELECT durable_object_id, title, summary, created_at, updated_at
+SELECT durable_object_name, title, summary, created_at, updated_at
 FROM conversations
-WHERE user_id = '148583_matt'
+WHERE durable_object_name LIKE '148583_matt:%'
 ORDER BY updated_at DESC;
 ```
 
@@ -563,9 +577,9 @@ If `userId` is not set on the request body, the upsert is skipped and a `console
 
 ### Classes
 
-| Export        | Description                                                                                                           |
-| ------------- | --------------------------------------------------------------------------------------------------------------------- |
-| `AIChatAgent` | Abstract CF Durable Object base class. Implement `onChatMessage`. Manages skill state, history replay, and audit log. |
+| Export        | Description                                                                                                                                                                                                                               |
+| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `AIChatAgent` | Abstract CF Durable Object base class. Implement `onChatMessage`. Manages skill state, history replay, audit log, and D1 `conversations` upserts. Exposes callable `getConversations` for listing a user’s conversations from the client. |
 
 ### Functions
 

package/dist/index.mjs

@@ -39,6 +39,14 @@ function buildActivateSkillDescription(skills) {
 		skills.map((s) => `• ${s.name} — ${s.description}`).join("\n")
 	].join("\n");
 }
+function buildAvailableSkillList(skills) {
+	return [
+		"**Loading More Tools:**",
+		"Use `activate_skill` to load these categories (BE PROACTIVE on requesting tools based on the user's request AND you DON'T need to mention that you are loading more tools):",
+		"",
+		skills.map((s) => `**${s.name}**: ${s.description}`).join("\n")
+	].join("\n");
+}
 const LIST_CAPABILITIES_DESCRIPTION = "List all tools currently available to you, which skills are loaded, and which can still be loaded. Call this when the user asks about your capabilities or what you can do.";
 /**
 * Sentinel appended to a successful activate_skill result.
@@ -63,6 +71,7 @@ function createSkills(config) {
 	const { tools: alwaysOnTools, skills } = config;
 	const loadedSkills = new Set(config.initialLoadedSkills ?? []);
 	const skillMap = new Map(skills.map((s) => [s.name, s]));
+	const availableSkillList = skills.length > 0 ? buildAvailableSkillList(skills) : "";
 	const allTools = {};
 	Object.assign(allTools, alwaysOnTools);
 	for (const skill of skills) Object.assign(allTools, skill.tools);
@@ -80,12 +89,26 @@ function createSkills(config) {
 		return names;
 	}
 	function getLoadedGuidance() {
-		return [...loadedSkills].map((name) => skillMap.get(name)?.guidance).filter((g) => Boolean(g)).join("\n\n");
+		const sections = [...loadedSkills].flatMap((name) => {
+			const skill = skillMap.get(name);
+			if (!skill?.guidance) return [];
+			return [`**${skill.name}**\n${skill.guidance}`];
+		});
+		if (sections.length === 0) return "";
+		return [
+			"**Loaded skill instructions**",
+			"The following skills are currently active. Apply their instructions when using the corresponding tools.",
+			"",
+			sections.join("\n\n")
+		].join("\n");
 	}
 	function getSystem() {
 		const guidance = getLoadedGuidance();
-		if (!config.systemPrompt) return guidance;
-		return guidance ? `${config.systemPrompt}\n\n${guidance}` : config.systemPrompt;
+		return [
+			config.systemPrompt,
+			availableSkillList,
+			guidance
+		].filter(Boolean).join("\n\n");
 	}
 	allTools[ACTIVATE_SKILL] = tool({
 		description: buildActivateSkillDescription(skills),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@economic/agents",
-  "version": "0.0.1-beta.1",
+  "version": "0.0.1-beta.2",
   "description": "A starter for creating a TypeScript package.",
   "license": "MIT",
   "files": [