@agent-native/core 0.130.2 → 0.131.3

package/dist/extensions/actions.js

@@ -20,6 +20,10 @@ import { createExtension, deleteExtension, ensureExtensionsTables, findRecentDup
 // the surrounding metadata and indentation while still bounding tool context.
 const GET_EXTENSION_MAX_RESULT_CHARS = 500_000;
 const GET_EXTENSION_HISTORY_MAX_RESULT_CHARS = 2_000_000;
+const LARGE_EXTENSION_INLINE_CONTENT_MAX_CHARS = 60_000;
+const EXTENSION_CONTENT_MATCH_LIMIT = 8;
+const DEFAULT_EXTENSION_CONTENT_CONTEXT_CHARS = 1_500;
+const MAX_EXTENSION_CONTENT_CONTEXT_CHARS = 4_000;
 export function createExtensionActionEntries() {
     return {
         "list-extensions": {
@@ -90,7 +94,7 @@ export function createExtensionActionEntries() {
         },
         "get-extension": {
             tool: {
-                description: "Get one existing extension by id. Use this when <current-screen> or <current-url> contains extensionId for the current extension; do not call list-extensions just to rediscover that id. Defaults to including the full Alpine.js content once per run so you can make a targeted update-extension edit; repeated unchanged reads return compact metadata unless forceContent=true.",
+                description: "Get one existing extension by id. Use this when <current-screen> or <current-url> contains extensionId for the current extension; do not call list-extensions just to rediscover that id. Small extensions include their full Alpine.js content once per run. Large extensions return compact metadata first; pass contentQuery with a function, variable, section marker, or literal text to retrieve bounded source excerpts for a targeted update-extension edit. Repeated unchanged full reads return compact metadata unless forceContent=true.",
                 parameters: {
                     type: "object",
                     properties: {
@@ -104,7 +108,15 @@ export function createExtensionActionEntries() {
                         },
                         forceContent: {
                             type: "boolean",
-                            description: "Return full content even if this run already read the same unchanged body. Use sparingly; prefer update-extension edits after the first read.",
+                            description: "Return full content even when the extension is large or this run already read the same unchanged body. Use only for a broad rewrite; prefer contentQuery plus focused update-extension edits.",
+                        },
+                        contentQuery: {
+                            type: "string",
+                            description: "Literal, case-insensitive source text to find. Returns bounded excerpts around up to 8 matches without loading the full extension.",
+                        },
+                        contentContextChars: {
+                            type: "number",
+                            description: "Characters of context before and after each contentQuery match. Defaults to 1500 and is capped at 4000.",
                         },
                     },
                     required: ["id"],
@@ -118,11 +130,13 @@ export function createExtensionActionEntries() {
                     ? true
                     : coerceBoolean(args.includeContent);
                 const forceContent = coerceBoolean(args?.forceContent);
+                const contentQuery = String(args?.contentQuery ?? "").trim();
+                const contentContextChars = normalizeExtensionContentContextChars(args?.contentContextChars);
                 const localExtension = await getLocalExtension(id);
                 if (localExtension) {
                     return {
                         ok: true,
-                        extension: await summarizeExtensionForAgentRead(localExtension, new Set(), includeContent, forceContent),
+                        extension: await summarizeExtensionForAgentRead(localExtension, new Set(), includeContent, forceContent, contentQuery, contentContextChars),
                     };
                 }
                 const extension = await getExtension(id);
@@ -131,7 +145,7 @@ export function createExtensionActionEntries() {
                 const hiddenIds = await getHiddenExtensionIdsForCurrentUser();
                 return {
                     ok: true,
-                    extension: await summarizeExtensionForAgentRead(extension, hiddenIds, includeContent, forceContent),
+                    extension: await summarizeExtensionForAgentRead(extension, hiddenIds, includeContent, forceContent, contentQuery, contentContextChars),
                 };
             },
             // Result is JSON including the full Alpine content; account for JSON
@@ -1223,11 +1237,38 @@ async function summarizeExtension(row, hiddenIds, includeContent) {
         ...(includeContent ? { content: row.content } : {}),
     };
 }
-async function summarizeExtensionForAgentRead(row, hiddenIds, includeContent, forceContent) {
+async function summarizeExtensionForAgentRead(row, hiddenIds, includeContent, forceContent, contentQuery, contentContextChars) {
+    const fingerprint = contentFingerprint(row.content);
+    if (contentQuery) {
+        const summary = await summarizeExtension(row, hiddenIds, false);
+        return {
+            ...summary,
+            contentMatches: findExtensionContentMatches(row.content, contentQuery, contentContextChars),
+            contentOmitted: {
+                reason: "targeted-content-read",
+                contentHash: fingerprint,
+                contentLength: row.content.length,
+                next: 'Use the returned excerpts to call update-extension with operation="edit" and focused edits. Call get-extension again with a different contentQuery when another source area is needed.',
+            },
+        };
+    }
     if (!includeContent) {
         return summarizeExtension(row, hiddenIds, false);
     }
-    const fingerprint = contentFingerprint(row.content);
+    if (!forceContent &&
+        row.content.length > LARGE_EXTENSION_INLINE_CONTENT_MAX_CHARS) {
+        const summary = await summarizeExtension(row, hiddenIds, false);
+        return {
+            ...summary,
+            contentOmitted: {
+                reason: "large-content-requires-targeted-read",
+                contentHash: fingerprint,
+                contentLength: row.content.length,
+                inlineContentLimit: LARGE_EXTENSION_INLINE_CONTENT_MAX_CHARS,
+                next: "Call get-extension again with contentQuery set to the relevant function, variable, section marker, or literal text. Use forceContent=true only for a broad rewrite that truly needs the entire body.",
+            },
+        };
+    }
     const runCtx = getRequestRunContext();
     const reads = runCtx ? (runCtx.extensionContentReads ??= {}) : undefined;
     const alreadySent = !forceContent && reads?.[row.id] === fingerprint;
@@ -1247,6 +1288,41 @@ async function summarizeExtensionForAgentRead(row, hiddenIds, includeContent, fo
         },
     };
 }
+function normalizeExtensionContentContextChars(value) {
+    const numeric = Number(value);
+    if (!Number.isFinite(numeric)) {
+        return DEFAULT_EXTENSION_CONTENT_CONTEXT_CHARS;
+    }
+    return Math.min(MAX_EXTENSION_CONTENT_CONTEXT_CHARS, Math.max(250, Math.floor(numeric)));
+}
+function findExtensionContentMatches(content, query, contextChars) {
+    const lowerContent = content.toLowerCase();
+    const lowerQuery = query.toLowerCase();
+    const matches = [];
+    let searchFrom = 0;
+    while (matches.length < EXTENSION_CONTENT_MATCH_LIMIT) {
+        const matchStart = lowerContent.indexOf(lowerQuery, searchFrom);
+        if (matchStart < 0)
+            break;
+        const matchEnd = matchStart + query.length;
+        const excerptStart = Math.max(0, matchStart - contextChars);
+        const excerptEnd = Math.min(content.length, matchEnd + contextChars);
+        matches.push({
+            matchStart,
+            matchEnd,
+            excerptStart,
+            excerptEnd,
+            excerpt: content.slice(excerptStart, excerptEnd),
+        });
+        searchFrom = matchEnd;
+    }
+    return {
+        query,
+        matches,
+        hasMore: matches.length === EXTENSION_CONTENT_MATCH_LIMIT &&
+            lowerContent.indexOf(lowerQuery, searchFrom) >= 0,
+    };
+}
 function compactExtensionHistoryDetail(detail, includeContent) {
     const diffMaxLines = 400;
     const fullDiff = detail.diff ?? [];