@agent-native/core 0.24.10 → 0.26.0

package/dist/server/agent-chat-plugin.js

@@ -37,6 +37,14 @@ async function lazyFs() {
     return _fs;
 }
 const SHARED_PROMPT_RESOURCE_MAX_CHARS = 30_000;
+const COMPACT_PROMPT_RESOURCE_MAX_CHARS = 12_000;
+const MAX_ACTION_SUMMARY_DESCRIPTION_CHARS = 140;
+function compactPromptLine(value, maxChars) {
+    const line = value.replace(/\s+/g, " ").trim();
+    if (line.length <= maxChars)
+        return line;
+    return `${line.slice(0, maxChars - 1)}…`;
+}
 const SHARED_RESOURCE_INDEX_LIMIT = 40;
 function normalizeResourcePathForPrompt(path) {
     return path.replace(/^\/+/, "").trim();
@@ -44,18 +52,20 @@ function normalizeResourcePathForPrompt(path) {
 function escapeXmlAttribute(value) {
     return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;");
 }
-function truncatePromptResourceContent(content, path, maxChars = SHARED_PROMPT_RESOURCE_MAX_CHARS) {
+function truncatePromptResourceContent(content, path, maxChars = SHARED_PROMPT_RESOURCE_MAX_CHARS, readHint) {
     const trimmed = content.trim();
     if (trimmed.length <= maxChars)
         return trimmed;
     const omitted = trimmed.length - maxChars;
-    return `${trimmed.slice(0, maxChars)}\n\n[Resource ${path} truncated after ${maxChars.toLocaleString()} characters; ${omitted.toLocaleString()} characters omitted. Use resource-read --path "${path}" with the resource's scope for the full content.]`;
+    const hint = readHint ??
+        `Use resource-read --path "${path}" with the resource's scope for the full content.`;
+    return `${trimmed.slice(0, maxChars)}\n\n[Resource ${path} truncated after ${maxChars.toLocaleString()} characters; ${omitted.toLocaleString()} characters omitted. ${hint}]`;
 }
 function promptResourceBlock(input) {
     const normalizedPath = input.path
         ? normalizeResourcePathForPrompt(input.path)
         : undefined;
-    const content = truncatePromptResourceContent(input.content, normalizedPath ?? input.name, input.maxChars);
+    const content = truncatePromptResourceContent(input.content, normalizedPath ?? input.name, input.maxChars, input.readHint);
     if (!content)
         return null;
     const pathAttr = normalizedPath
@@ -112,7 +122,7 @@ function resourceScopeForOwner(owner, currentOwner) {
         return "personal";
     return "resource";
 }
-async function loadAgentsResourceForPrompt(owner, scope) {
+async function loadAgentsResourceForPrompt(owner, scope, maxChars = SHARED_PROMPT_RESOURCE_MAX_CHARS) {
     try {
         const agents = await resourceGetByPath(owner, "AGENTS.md");
         if (!agents?.content?.trim())
@@ -122,13 +132,14 @@ async function loadAgentsResourceForPrompt(owner, scope) {
             scope,
             path: "AGENTS.md",
             content: agents.content,
+            maxChars,
         });
     }
     catch {
         return null;
     }
 }
-async function loadInstructionResourcesForPrompt(owner, scope) {
+async function loadInstructionResourcesForPrompt(owner, scope, maxChars = SHARED_PROMPT_RESOURCE_MAX_CHARS) {
     try {
         const resources = await resourceList(owner, "instructions/");
         const blocks = [];
@@ -144,6 +155,7 @@ async function loadInstructionResourcesForPrompt(owner, scope) {
                 scope,
                 path: resource.path,
                 content: full.content,
+                maxChars,
             });
             if (block)
                 blocks.push(block);
@@ -2019,17 +2031,38 @@ const DEFAULT_SYSTEM_PROMPT = PROD_FRAMEWORK_PROMPT;
 export async function loadResourcesForPrompt(owner, compact = false, selfAppId) {
     await ensurePersonalDefaults(owner);
     const sections = [];
+    const promptResourceMaxChars = compact
+        ? COMPACT_PROMPT_RESOURCE_MAX_CHARS
+        : SHARED_PROMPT_RESOURCE_MAX_CHARS;
     // 1. Workspace AGENTS.md + skills merged into the template bundle.
     try {
         const { loadAgentsBundle, generateSkillsPromptBlock } = await import("./agents-bundle.js");
         const bundle = await loadAgentsBundle();
         // Workspace-core AGENTS.md (enterprise-wide instructions), if present.
         if (bundle.workspaceAgentsMd && bundle.workspaceAgentsMd.trim()) {
-            sections.push(`<resource name="AGENTS.md" scope="workspace">\n${bundle.workspaceAgentsMd.trim()}\n</resource>`);
+            const block = promptResourceBlock({
+                name: "AGENTS.md",
+                scope: "workspace",
+                path: "AGENTS.md",
+                content: bundle.workspaceAgentsMd,
+                maxChars: promptResourceMaxChars,
+                readHint: 'Use docs-search --slug "agents-workspace" to read the full workspace AGENTS.md.',
+            });
+            if (block)
+                sections.push(block);
         }
         // 2. Template AGENTS.md — always included (critical template instructions).
         if (bundle.agentsMd.trim()) {
-            sections.push(`<resource name="AGENTS.md" scope="template">\n${bundle.agentsMd.trim()}\n</resource>`);
+            const block = promptResourceBlock({
+                name: "AGENTS.md",
+                scope: "template",
+                path: "AGENTS.md",
+                content: bundle.agentsMd,
+                maxChars: promptResourceMaxChars,
+                readHint: 'Use docs-search --slug "agents-template" to read the full template AGENTS.md.',
+            });
+            if (block)
+                sections.push(block);
         }
         // In compact mode, skip the full skills block — the agent can use
         // `docs-search` to find skills when it needs them.
@@ -2048,23 +2081,23 @@ export async function loadResourcesForPrompt(owner, compact = false, selfAppId)
     catch { }
     // 3. Runtime workspace resources from SQL. These are global defaults
     // inherited by every app in the workspace, not copied into app scopes.
-    const workspaceAgents = await loadAgentsResourceForPrompt(WORKSPACE_OWNER, "workspace");
+    const workspaceAgents = await loadAgentsResourceForPrompt(WORKSPACE_OWNER, "workspace", promptResourceMaxChars);
     if (workspaceAgents)
         sections.push(workspaceAgents);
-    sections.push(...(await loadInstructionResourcesForPrompt(WORKSPACE_OWNER, "workspace-instruction")));
+    sections.push(...(await loadInstructionResourcesForPrompt(WORKSPACE_OWNER, "workspace-instruction", promptResourceMaxChars)));
     // 4. Runtime shared/app/org resources from SQL. These come after workspace
     // defaults so app/team-specific guidance can override or narrow them.
-    const sharedAgents = await loadAgentsResourceForPrompt(SHARED_OWNER, "shared");
+    const sharedAgents = await loadAgentsResourceForPrompt(SHARED_OWNER, "shared", promptResourceMaxChars);
     if (sharedAgents)
         sections.push(sharedAgents);
-    sections.push(...(await loadInstructionResourcesForPrompt(SHARED_OWNER, "shared-instruction")));
+    sections.push(...(await loadInstructionResourcesForPrompt(SHARED_OWNER, "shared-instruction", promptResourceMaxChars)));
     // 5. Personal SQL resources. These come last in the instruction stack so a
     // user can narrow or override organization/app and workspace defaults.
     if (owner !== SHARED_OWNER && owner !== WORKSPACE_OWNER) {
-        const personalAgents = await loadAgentsResourceForPrompt(owner, "personal");
+        const personalAgents = await loadAgentsResourceForPrompt(owner, "personal", promptResourceMaxChars);
         if (personalAgents)
             sections.push(personalAgents);
-        sections.push(...(await loadInstructionResourcesForPrompt(owner, "personal-instruction")));
+        sections.push(...(await loadInstructionResourcesForPrompt(owner, "personal-instruction", promptResourceMaxChars)));
     }
     const resourceSkillsBlock = await loadResourceSkillsPromptBlock(owner);
     if (resourceSkillsBlock)
@@ -2154,84 +2187,59 @@ const DEFAULT_DEV_PROMPT = "";
 function generateActionsPrompt(registry, mode = "tool") {
     if (!registry || Object.keys(registry).length === 0)
         return "";
-    const lines = Object.entries(registry).map(([name, entry]) => {
+    const actionEntries = Object.entries(registry);
+    if (mode === "tool") {
+        const summaryLines = actionEntries.map(([name, entry]) => {
+            const desc = compactPromptLine(entry.tool.description, MAX_ACTION_SUMMARY_DESCRIPTION_CHARS);
+            return `- \`${name}\` — ${desc}`;
+        });
+        return `\n\n## Available Actions
+
+**Use these actions directly as tool calls.** They handle database access, validation, and business logic internally. The native tool schemas contain the full parameter details.
+
+${summaryLines.join("\n")}`;
+    }
+    const lines = actionEntries.map(([name, entry]) => {
         const desc = entry.tool.description;
         const params = entry.tool.parameters?.properties;
         const requiredFields = new Set(entry.tool.parameters?.required ?? []);
-        if (mode === "cli") {
-            // CLI mode: emit `pnpm action <name> --required <type> [--optional <type>]`
-            if (!params || Object.keys(params).length === 0) {
-                return `- \`pnpm action ${name}\` — ${desc}`;
+        // CLI mode: emit `pnpm action <name> --required <type> [--optional <type>]`
+        if (!params || Object.keys(params).length === 0) {
+            return `- \`pnpm action ${name}\` — ${desc}`;
+        }
+        const entries = Object.entries(params);
+        // Required first (alphabetical), then optional (alphabetical)
+        entries.sort(([a], [b]) => {
+            const ar = requiredFields.has(a) ? 0 : 1;
+            const br = requiredFields.has(b) ? 0 : 1;
+            if (ar !== br)
+                return ar - br;
+            return a.localeCompare(b);
+        });
+        const required = [];
+        const optional = [];
+        const requiredNames = [];
+        for (const [k, v] of entries) {
+            const type = v.type ?? "any";
+            const flag = `--${k} <${type}>`;
+            if (requiredFields.has(k)) {
+                required.push(flag);
+                requiredNames.push(`--${k}`);
             }
-            const entries = Object.entries(params);
-            // Required first (alphabetical), then optional (alphabetical)
-            entries.sort(([a], [b]) => {
-                const ar = requiredFields.has(a) ? 0 : 1;
-                const br = requiredFields.has(b) ? 0 : 1;
-                if (ar !== br)
-                    return ar - br;
-                return a.localeCompare(b);
-            });
-            const required = [];
-            const optional = [];
-            const requiredNames = [];
-            for (const [k, v] of entries) {
-                const type = v.type ?? "any";
-                const flag = `--${k} <${type}>`;
-                if (requiredFields.has(k)) {
-                    required.push(flag);
-                    requiredNames.push(`--${k}`);
-                }
-                else {
-                    optional.push(`[${flag}]`);
-                }
+            else {
+                optional.push(`[${flag}]`);
             }
-            const cmd = ["pnpm action " + name, ...required, ...optional].join(" ");
-            const requiredNote = requiredNames.length > 0
-                ? ` Required: ${requiredNames.join(", ")}.`
-                : "";
-            return `- \`${cmd}\` — ${desc}.${requiredNote}`;
         }
-        // tool mode (production / native tool calls)
-        if (params) {
-            // Order required params first, then optional. Mark required with "*"
-            // and include type + description so the agent knows exactly how to call.
-            const entries = Object.entries(params);
-            entries.sort(([a], [b]) => {
-                const ar = requiredFields.has(a) ? 0 : 1;
-                const br = requiredFields.has(b) ? 0 : 1;
-                if (ar !== br)
-                    return ar - br;
-                return a.localeCompare(b);
-            });
-            const paramList = entries
-                .map(([k, v]) => {
-                const isRequired = requiredFields.has(k);
-                const type = v.type ?? "any";
-                const marker = isRequired ? "*" : "?";
-                const descPart = v.description ? ` — ${v.description}` : "";
-                return `${k}${marker}: ${type}${descPart}`;
-            })
-                .join("; ");
-            return `- \`${name}\`(${paramList}) — ${desc}`;
-        }
-        return `- \`${name}\`() — ${desc}`;
+        const cmd = ["pnpm action " + name, ...required, ...optional].join(" ");
+        const requiredNote = requiredNames.length > 0 ? ` Required: ${requiredNames.join(", ")}.` : "";
+        return `- \`${cmd}\` — ${desc}.${requiredNote}`;
     });
-    if (mode === "cli") {
-        return `\n\n## Available Actions
+    return `\n\n## Available Actions
 
 **These template actions are NOT exposed as direct tools in dev mode. To run any of them, use the \`bash\` tool with the exact command shown below.** Example: \`bash(command="pnpm action add-slide --deckId abc --content 'Hello'")\`.
 
 Do NOT try to call these by name as if they were tools — they will not exist in your tool list. Always go through \`bash\`.
 
-${lines.join("\n")}`;
-    }
-    return `\n\n## Available Actions
-
-**Use these actions directly as tool calls.** They are your primary tools — they handle database access, validation, and business logic internally. Prefer these over lower-level tools like \`web-request\` or \`db-query\`.
-
-Parameter notation: \`name*\` = required, \`name?\` = optional. Pass parameters as a JSON object.
-
 ${lines.join("\n")}`;
 }
 /**