@agent-native/core 0.103.1 → 0.105.0

package/dist/extensions/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/extensions/actions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AA8DhE,wBAAgB,4BAA4B,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAsgC1E"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/extensions/actions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AA+DhE,wBAAgB,4BAA4B,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAslC1E"}

package/dist/extensions/actions.js

@@ -1,9 +1,11 @@
 import { ACTION_CHAT_UI_INLINE_EXTENSION_RENDERER } from "../action-ui.js";
+import { AgentActionStopError } from "../action.js";
 import { writeAppState } from "../application-state/script-helpers.js";
 import { readResource } from "../resources/script-helpers.js";
 import { getRequestOrgId, getRequestRunContext, getRequestUserEmail, } from "../server/request-context.js";
 import { resolveAccess } from "../sharing/access.js";
 import { readWorkspaceFile, } from "../workspace-files/store.js";
+import { ExtensionContentEditError } from "./content-patch.js";
 import { getLocalExtension, isLocalExtensionRow, listLocalExtensions, } from "./local.js";
 import { extensionPath } from "./path.js";
 import { addExtensionSlotTarget, installExtensionSlot, uninstallExtensionSlot, listExtensionsForSlot, listSlotsForExtension, } from "./slots/store.js";
@@ -514,7 +516,7 @@ export function createExtensionActionEntries() {
         },
         "update-extension": {
             tool: {
-                description: 'Update an existing sandboxed Alpine.js mini-app extension. If the user is viewing the extension, use the extensionId from <current-screen> or <current-url> directly; do not list extensions first just to find the current id. Prefer granular edits for surgical changes; use full content replacement only for broad rewrites. Supported edits include literal replace, insert-before/after marker, replace-between markers, replace-section/wrap-section/remove-section for <!-- agent-native:section name --> blocks, and regex-replace. Pass format=true to run Prettier on the final HTML. To replace the whole body with a large pasted file, pass contentFromAttachment (the attachment name, or "latest") instead of copying the file into `content` — that avoids re-emitting thousands of tokens.',
+                description: 'Update an existing sandboxed Alpine.js mini-app extension. If the user is viewing the extension, use the extensionId from <current-screen> or <current-url> directly; do not list extensions first just to find the current id. Prefer granular edits for surgical changes; full-body replacement is blocked by default to preserve existing layout, CSS, copy, and interactions during data-only fixes. Use `patches` or `edits` for targeted changes; set `allowFullReplacement=true` only when the user explicitly asks for a visual rewrite or supplies a complete replacement body. Supported edits include literal replace, insert-before/after marker, replace-between markers, replace-section/wrap-section/remove-section for <!-- agent-native:section name --> blocks, and regex-replace. Pass format=true to run Prettier on the final HTML. To replace the whole body with a large pasted file, pass contentFromAttachment (the attachment name, or "latest") instead of copying the file into `content` — that avoids re-emitting thousands of tokens.',
                 parameters: {
                     type: "object",
                     properties: {
@@ -542,13 +544,23 @@ export function createExtensionActionEntries() {
                             type: "string",
                             description: 'Optional full replacement sourced from a workspace/shared resource file, by resource path (e.g. "intuit-analytics-extension.html"). The server reads the full file and uses it as the replacement body. Use instead of `content` when replacing the whole body with a large file that exists as a workspace resource. Ignored when `content` is provided.',
                         },
+                        allowFullReplacement: {
+                            type: "boolean",
+                            description: "Explicitly allow replacing the entire existing body. Omit or set false for data-only repairs so the existing visual design is protected. Use true only when the user explicitly requested a broad visual rewrite or supplied a complete replacement body.",
+                        },
                         patches: {
-                            type: "string",
-                            description: 'Legacy optional JSON array of { "find": "...", "replace": "...", "all"?: true, "expectedMatches"?: 1, "required"?: true } patches. Missing required targets fail instead of silently no-oping.',
+                            anyOf: [
+                                { type: "string" },
+                                { type: "array", items: { type: "object" } },
+                            ],
+                            description: 'Optional patches as a JSON-encoded string or native array of { "find": "...", "replace": "...", "all"?: true, "expectedMatches"?: 1, "required"?: true } objects. Missing required targets fail instead of silently no-oping.',
                         },
                         edits: {
-                            type: "string",
-                            description: 'Preferred optional JSON array of granular edit operations. Examples: { "op": "insert-after", "marker": "<!-- section:metrics -->", "content": "..." }, { "op": "replace-section", "section": "npm-chart", "content": "..." }, { "op": "wrap-section", "section": "charts", "before": "<div>", "after": "</div>" }, { "op": "regex-replace", "pattern": "...", "replace": "...", "expectedMatches": 1 }.',
+                            anyOf: [
+                                { type: "string" },
+                                { type: "array", items: { type: "object" } },
+                            ],
+                            description: 'Preferred optional granular edit operations as a JSON-encoded string or native array. Examples: { "op": "insert-after", "marker": "<!-- section:metrics -->", "content": "..." }, { "op": "replace-section", "section": "npm-chart", "content": "..." }, { "op": "wrap-section", "section": "charts", "before": "<div>", "after": "</div>" }, { "op": "regex-replace", "pattern": "...", "replace": "...", "expectedMatches": 1 }.',
                         },
                         format: {
                             type: "boolean",
@@ -560,8 +572,8 @@ export function createExtensionActionEntries() {
                         },
                         visibility: {
                             type: "string",
-                            description: "Optional sharing visibility.",
-                            enum: ["private", "org", "public"],
+                            description: "Optional sharing visibility. Public extension sharing is not supported; use private or org.",
+                            enum: ["private", "org"],
                         },
                     },
                     required: ["id"],
@@ -574,6 +586,36 @@ export function createExtensionActionEntries() {
                 const localMessage = await localExtensionEditMessage(id);
                 if (localMessage)
                     return localMessage;
+                if (typeof args?.visibility === "string" &&
+                    args.visibility.trim().toLowerCase() === "public") {
+                    const message = "Public extension sharing is not supported. Use visibility=private or visibility=org. No content changes were applied; do not retry visibility=public.";
+                    throw new AgentActionStopError(message, {
+                        errorCode: "extension_public_visibility_unsupported",
+                        toolResult: JSON.stringify({
+                            error: "extension_public_visibility_unsupported",
+                            message,
+                            recoverable: false,
+                            next: "Retry only with visibility=private or visibility=org.",
+                        }, null, 2),
+                    });
+                }
+                const fullReplacementRequested = (typeof args?.content === "string" &&
+                    args.content.trim().length > 0) ||
+                    args?.contentFromAttachment !== undefined ||
+                    args?.contentFromWorkspaceFile !== undefined;
+                if (fullReplacementRequested &&
+                    !coerceBoolean(args?.allowFullReplacement)) {
+                    const message = "Full extension-body replacement was blocked to preserve the existing visual design. Read the current extension and use focused patches/edits for a data-only repair. Only retry with allowFullReplacement=true when the user explicitly requested a broad visual rewrite or supplied a complete replacement body.";
+                    throw new AgentActionStopError(message, {
+                        errorCode: "extension_full_replacement_requires_explicit_intent",
+                        toolResult: JSON.stringify({
+                            error: "extension_full_replacement_requires_explicit_intent",
+                            message,
+                            recoverable: false,
+                            next: "Call get-extension once, then update-extension with patches or edits that change only the data-loading code. Use allowFullReplacement=true only for an explicitly requested visual rewrite.",
+                        }, null, 2),
+                    });
+                }
                 // Full-replacement content can come inline (`content`) or by reference
                 // (`contentFromAttachment`) so the model never has to re-type a large
                 // pasted file. Inline wins only when NON-EMPTY — the docstring tells
@@ -605,12 +647,30 @@ export function createExtensionActionEntries() {
                     if (args?.edits !== undefined && !edits) {
                         return "Error: edits must be a JSON array of supported extension edit operations.";
                     }
-                    result = await updateExtensionContent(id, {
-                        content: replacementContent,
-                        patches,
-                        edits,
-                        format: coerceBoolean(args?.format),
-                    });
+                    try {
+                        result = await updateExtensionContent(id, {
+                            content: replacementContent,
+                            allowFullReplacement: coerceBoolean(args?.allowFullReplacement),
+                            patches,
+                            edits,
+                            format: coerceBoolean(args?.format),
+                        });
+                    }
+                    catch (error) {
+                        if (!(error instanceof ExtensionContentEditError))
+                            throw error;
+                        const message = `The extension edit was not applied: ${error.message} ` +
+                            "Do not retry the same arguments. Read the current extension and submit one focused patch or edit with an exact target.";
+                        throw new AgentActionStopError(message, {
+                            errorCode: "extension_content_edit_failed",
+                            toolResult: JSON.stringify({
+                                error: "extension_content_edit_failed",
+                                message: error.message,
+                                recoverable: false,
+                                next: "Read the current extension with get-extension, then make one focused update-extension patches/edits call. Do not retry unchanged arguments.",
+                            }, null, 2),
+                        });
+                    }
                 }
                 const meta = {};
                 if (args?.name !== undefined)
@@ -1313,7 +1373,7 @@ function coerceLimit(value) {
 function parsePatches(value) {
     if (value === undefined)
         return undefined;
-    const parsed = typeof value === "string" ? JSON.parse(value) : value;
+    const parsed = parseJsonArray(value);
     if (!Array.isArray(parsed))
         return undefined;
     if (parsed.some((patch) => !patch ||
@@ -1326,13 +1386,23 @@ function parsePatches(value) {
 function parseEdits(value) {
     if (value === undefined)
         return undefined;
-    const parsed = typeof value === "string" ? JSON.parse(value) : value;
+    const parsed = parseJsonArray(value);
     if (!Array.isArray(parsed))
         return undefined;
     return parsed.every(isValidContentEdit)
         ? parsed
         : undefined;
 }
+function parseJsonArray(value) {
+    if (typeof value !== "string")
+        return value;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return undefined;
+    }
+}
 function isValidContentEdit(value) {
     if (!value || typeof value !== "object")
         return false;