@adminforth/agent 1.6.0 → 1.7.0

package/agent/systemPrompt.ts

@@ -57,9 +57,10 @@ export async function buildAgentSystemPrompt(adminforth: IAdminForth) {
     listBundledSkillManifests(),
   ]);
   const alwaysAvailableTools = ALWAYS_AVAILABLE_API_TOOL_NAMES.join(", ");
+  const adminBasePath = adminforth.config.baseUrlSlashed;
   const sections = [
     DEFAULT_AGENT_SYSTEM_PROMPT,
-    `BASE_URL: ${adminforth.config.baseUrl}`,
+    `ADMIN_BASE_PATH: ${adminBasePath}`,
     `List of resources:\n${formatResources(adminforth.config.resources)}`,
     `You have always-available base tools: ${alwaysAvailableTools}.`,
     primarySkills.length > 0
@@ -76,6 +77,8 @@ export async function buildAgentSystemPrompt(adminforth: IAdminForth) {
     "If a fetched skill lists a non-base tool you need, call fetch_tool_schema for it immediately instead of telling the user the tool is unavailable.",
     "For example: for record creation load mutate_data, read its tool list, call fetch_tool_schema for create_record, and then use create_record after confirmation.",
     "When fetch_tool_schema succeeds, that tool becomes available on the next step.",
+    "All admin links must be relative paths and must start with ADMIN_BASE_PATH.",
+    "Build record links as ADMIN_BASE_PATH + resource/{resourceId}/show/{primary key}. Do not prepend any extra slash before resource.",
     "Try to call as many tools as possible in parallel in one step.",
   ];
 

package/build.log

@@ -29,5 +29,5 @@ custom/skills/fetch_data/SKILL.md
 custom/skills/mutate_data/
 custom/skills/mutate_data/SKILL.md
 
-sent 170,361 bytes  received 413 bytes  341,548.00 bytes/sec
-total size is 168,687  speedup is 0.99
+sent 170,560 bytes  received 413 bytes  341,946.00 bytes/sec
+total size is 168,886  speedup is 0.99

package/custom/skills/fetch_data/SKILL.md

@@ -12,4 +12,4 @@ To find specific data record you should use filters. ILIKE filters are preferred
 
 For long texts show only several first words and add "..." at the end (only if user did not request this field specifically).
 
-Also when you communicate with user about record, add related link to this record. For example /{BASE_URL}/resource/{resourceId}/show/{primary key}. Use _label from `get_resource_data` as anchor text for link (use markdown link). Links shoudl be always relative path, starting with slash.
+Also when you communicate with user about record, add related link to this record. Build it as `{ADMIN_BASE_PATH}resource/{resourceId}/show/{primary key}`. Use _label from `get_resource_data` as anchor text for link (use markdown link). Links should always be relative paths and must start with `ADMIN_BASE_PATH`. Do not add an extra slash after `ADMIN_BASE_PATH`.

package/custom/skills/mutate_data/SKILL.md

@@ -21,7 +21,7 @@ Use `start_custom_action` and `start_custom_bulk_action` for resource actions.
 Before performing any state mutation including action calls edit/delete please fetch record which is going to be edited/deleted and show user record in format field → value (show several most important fields which can help user to understand what exactly record he is going to edit or delete). 
 
 For field values with long texts show only several first words and add "..." at the end.
-Also please add related link to record with will be changed. For example /{BASE_URL}/resource/{resourceId}/show/{primary key}. Use _label from `get_resource_data` as anchor text for link (use markdown link). Links shoudl be always relative path, starting with slash.
+Also please add related link to record with will be changed. Build it as `{ADMIN_BASE_PATH}resource/{resourceId}/show/{primary key}`. Use _label from `get_resource_data` as anchor text for link (use markdown link). Links should always be relative paths and must start with `ADMIN_BASE_PATH`. Do not add an extra slash after `ADMIN_BASE_PATH`.
 
 And in the same message ask user for final confirmation.
 
@@ -62,7 +62,7 @@ If you want to block some user you can confirm that this action by saying:
 * IP Country: USA
 * Currently blocked: No // show this field only if it exists in user record
 
-View [John Doe](/resource/users/show/123)
+View [John Doe]({ADMIN_BASE_PATH}resource/users/show/123)
 Are you sure?
 ```
 
@@ -85,7 +85,7 @@ I am going to update user:
 * IP Country: USA
 I am going to change email from john_doe@example.com to new_email@example.com
 
-View [John Doe](/admin/resource/users/show/123)
+View [John Doe]({ADMIN_BASE_PATH}resource/users/show/123)
 
 Are you sure?
 ```
@@ -105,7 +105,7 @@ If you gonna delete user record, in confirmation please share full user info (no
 * Signed up: 2024 Jan 1
 * IP Country: USA
 
-View [John Doe](/admin/resource/users/show/123)
+View [John Doe]({ADMIN_BASE_PATH}resource/users/show/123)
 
 Are you sure?
 ```
@@ -130,7 +130,7 @@ I am going to create user:
 * Username: john_doe
 * Email: john_doe@example.com
 
-View [John Doe](/admin/resource/users/show/421) # 421 is id of new created record
+View [John Doe]({ADMIN_BASE_PATH}resource/users/show/421) # 421 is id of new created record
 
 Are you sure?
 ```

package/dist/agent/systemPrompt.js

@@ -52,9 +52,10 @@ export function buildAgentSystemPrompt(adminforth) {
             listBundledSkillManifests(),
         ]);
         const alwaysAvailableTools = ALWAYS_AVAILABLE_API_TOOL_NAMES.join(", ");
+        const adminBasePath = adminforth.config.baseUrlSlashed;
         const sections = [
             DEFAULT_AGENT_SYSTEM_PROMPT,
-            `BASE_URL: ${adminforth.config.baseUrl}`,
+            `ADMIN_BASE_PATH: ${adminBasePath}`,
             `List of resources:\n${formatResources(adminforth.config.resources)}`,
             `You have always-available base tools: ${alwaysAvailableTools}.`,
             primarySkills.length > 0
@@ -71,6 +72,8 @@ export function buildAgentSystemPrompt(adminforth) {
             "If a fetched skill lists a non-base tool you need, call fetch_tool_schema for it immediately instead of telling the user the tool is unavailable.",
             "For example: for record creation load mutate_data, read its tool list, call fetch_tool_schema for create_record, and then use create_record after confirmation.",
             "When fetch_tool_schema succeeds, that tool becomes available on the next step.",
+            "All admin links must be relative paths and must start with ADMIN_BASE_PATH.",
+            "Build record links as ADMIN_BASE_PATH + resource/{resourceId}/show/{primary key}. Do not prepend any extra slash before resource.",
             "Try to call as many tools as possible in parallel in one step.",
         ];
         return sections.filter(Boolean).join("\n\n");

package/dist/custom/skills/fetch_data/SKILL.md

@@ -12,4 +12,4 @@ To find specific data record you should use filters. ILIKE filters are preferred
 
 For long texts show only several first words and add "..." at the end (only if user did not request this field specifically).
 
-Also when you communicate with user about record, add related link to this record. For example /{BASE_URL}/resource/{resourceId}/show/{primary key}. Use _label from `get_resource_data` as anchor text for link (use markdown link). Links shoudl be always relative path, starting with slash.
+Also when you communicate with user about record, add related link to this record. Build it as `{ADMIN_BASE_PATH}resource/{resourceId}/show/{primary key}`. Use _label from `get_resource_data` as anchor text for link (use markdown link). Links should always be relative paths and must start with `ADMIN_BASE_PATH`. Do not add an extra slash after `ADMIN_BASE_PATH`.

package/dist/custom/skills/mutate_data/SKILL.md

@@ -21,7 +21,7 @@ Use `start_custom_action` and `start_custom_bulk_action` for resource actions.
 Before performing any state mutation including action calls edit/delete please fetch record which is going to be edited/deleted and show user record in format field → value (show several most important fields which can help user to understand what exactly record he is going to edit or delete). 
 
 For field values with long texts show only several first words and add "..." at the end.
-Also please add related link to record with will be changed. For example /{BASE_URL}/resource/{resourceId}/show/{primary key}. Use _label from `get_resource_data` as anchor text for link (use markdown link). Links shoudl be always relative path, starting with slash.
+Also please add related link to record with will be changed. Build it as `{ADMIN_BASE_PATH}resource/{resourceId}/show/{primary key}`. Use _label from `get_resource_data` as anchor text for link (use markdown link). Links should always be relative paths and must start with `ADMIN_BASE_PATH`. Do not add an extra slash after `ADMIN_BASE_PATH`.
 
 And in the same message ask user for final confirmation.
 
@@ -62,7 +62,7 @@ If you want to block some user you can confirm that this action by saying:
 * IP Country: USA
 * Currently blocked: No // show this field only if it exists in user record
 
-View [John Doe](/resource/users/show/123)
+View [John Doe]({ADMIN_BASE_PATH}resource/users/show/123)
 Are you sure?
 ```
 
@@ -85,7 +85,7 @@ I am going to update user:
 * IP Country: USA
 I am going to change email from john_doe@example.com to new_email@example.com
 
-View [John Doe](/admin/resource/users/show/123)
+View [John Doe]({ADMIN_BASE_PATH}resource/users/show/123)
 
 Are you sure?
 ```
@@ -105,7 +105,7 @@ If you gonna delete user record, in confirmation please share full user info (no
 * Signed up: 2024 Jan 1
 * IP Country: USA
 
-View [John Doe](/admin/resource/users/show/123)
+View [John Doe]({ADMIN_BASE_PATH}resource/users/show/123)
 
 Are you sure?
 ```
@@ -130,7 +130,7 @@ I am going to create user:
 * Username: john_doe
 * Email: john_doe@example.com
 
-View [John Doe](/admin/resource/users/show/421) # 421 is id of new created record
+View [John Doe]({ADMIN_BASE_PATH}resource/users/show/421) # 421 is id of new created record
 
 Are you sure?
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adminforth/agent",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",