@elementor/editor-agents 4.3.0-1031

package/dist/index.d.mts

@@ -0,0 +1,8 @@
+import * as React from 'react';
+
+declare function init(): void;
+
+declare function AgentsSettingsTab(): React.JSX.Element;
+declare const AGENTS_SITE_SETTINGS_TAB_ID = "settings-agents";
+
+export { AGENTS_SITE_SETTINGS_TAB_ID, AgentsSettingsTab, init };

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import * as React from 'react';
+
+declare function init(): void;
+
+declare function AgentsSettingsTab(): React.JSX.Element;
+declare const AGENTS_SITE_SETTINGS_TAB_ID = "settings-agents";
+
+export { AGENTS_SITE_SETTINGS_TAB_ID, AgentsSettingsTab, init };

package/dist/index.js

@@ -0,0 +1,139 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AGENTS_SITE_SETTINGS_TAB_ID: () => AGENTS_SITE_SETTINGS_TAB_ID,
+  AgentsSettingsTab: () => AgentsSettingsTab,
+  init: () => init
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/init.ts
+var import_editor_site_settings = require("@elementor/editor-site-settings");
+
+// src/components/agents-settings-tab.tsx
+var React = __toESM(require("react"));
+var import_react = require("react");
+var import_editor_v1_adapters = require("@elementor/editor-v1-adapters");
+var import_ui = require("@elementor/ui");
+var import_i18n = require("@wordpress/i18n");
+
+// src/llms-settings.ts
+var import_editor_documents = require("@elementor/editor-documents");
+var AGENTS_SETTINGS_KEY = "agents";
+var LLMS_SETTINGS_KEY = "llms";
+function getSiteSettingsBag() {
+  const settings = (0, import_editor_documents.getV1CurrentDocument)()?.container?.settings;
+  return settings ? settings : null;
+}
+function readAgentsSettings(settings) {
+  const agents = settings?.get(AGENTS_SETTINGS_KEY);
+  return agents && typeof agents === "object" ? { ...agents } : {};
+}
+function omitLlms(agents) {
+  return Object.fromEntries(Object.entries(agents).filter(([key]) => key !== LLMS_SETTINGS_KEY));
+}
+function isEmpty(agents) {
+  return 0 === Object.keys(agents).length;
+}
+function readLlmsContent() {
+  const llms = readAgentsSettings(getSiteSettingsBag())[LLMS_SETTINGS_KEY];
+  return typeof llms === "string" ? llms : "";
+}
+function writeLlmsContent(content) {
+  const settings = getSiteSettingsBag();
+  if (!settings) {
+    return false;
+  }
+  const agents = readAgentsSettings(settings);
+  if ("" === content) {
+    const remainingAgents = omitLlms(agents);
+    settings.set(AGENTS_SETTINGS_KEY, isEmpty(remainingAgents) ? void 0 : remainingAgents);
+  } else {
+    settings.set(AGENTS_SETTINGS_KEY, { ...agents, [LLMS_SETTINGS_KEY]: content });
+  }
+  (0, import_editor_documents.setDocumentModifiedStatus)(true);
+  return true;
+}
+
+// src/components/agents-settings-tab.tsx
+var TAB_ID = "settings-agents";
+var TAB_ROUTE = `panel/global/${TAB_ID}`;
+function AgentsSettingsTab() {
+  const [value, setValue] = (0, import_react.useState)(readLlmsContent);
+  const [isSettingsAvailable, setIsSettingsAvailable] = (0, import_react.useState)(() => null !== getSiteSettingsBag());
+  (0, import_editor_v1_adapters.__privateUseListenTo)([(0, import_editor_v1_adapters.routeOpenEvent)(TAB_ROUTE)], () => {
+    setIsSettingsAvailable(null !== getSiteSettingsBag());
+    setValue(readLlmsContent());
+  });
+  const handleChange = (0, import_react.useCallback)((event) => {
+    const nextValue = event.target.value;
+    setValue(nextValue);
+    writeLlmsContent(nextValue);
+  }, []);
+  return /* @__PURE__ */ React.createElement(import_ui.Box, { sx: { p: 2 } }, /* @__PURE__ */ React.createElement(import_ui.Stack, { spacing: 1.5 }, /* @__PURE__ */ React.createElement(import_ui.Typography, { variant: "subtitle2" }, (0, import_i18n.__)("Agents", "elementor")), /* @__PURE__ */ React.createElement(
+    import_ui.TextField,
+    {
+      label: (0, import_i18n.__)("llms.txt", "elementor"),
+      value,
+      onChange: handleChange,
+      multiline: true,
+      minRows: 12,
+      fullWidth: true,
+      disabled: !isSettingsAvailable,
+      helperText: isSettingsAvailable ? (0, import_i18n.__)("Content served at /llms.txt when saved. Leave empty to disable.", "elementor") : (0, import_i18n.__)("Kit settings are unavailable. Reopen Site Settings and try again.", "elementor")
+    }
+  )));
+}
+var AGENTS_SITE_SETTINGS_TAB_ID = TAB_ID;
+
+// src/init.ts
+var EXPERIMENT_NAME = "agents_llms_txt";
+function isAgentsExperimentActive() {
+  const features = window.elementorCommon?.config?.experimentalFeatures ?? {};
+  return Boolean(features[EXPERIMENT_NAME]);
+}
+function init() {
+  if (!isAgentsExperimentActive()) {
+    return;
+  }
+  (0, import_editor_site_settings.injectSiteSettingsTab)({
+    id: AGENTS_SITE_SETTINGS_TAB_ID,
+    component: AgentsSettingsTab
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AGENTS_SITE_SETTINGS_TAB_ID,
+  AgentsSettingsTab,
+  init
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/init.ts","../src/components/agents-settings-tab.tsx","../src/llms-settings.ts"],"sourcesContent":["export { init } from './init';\nexport { AGENTS_SITE_SETTINGS_TAB_ID, AgentsSettingsTab } from './components/agents-settings-tab';\n","import { injectSiteSettingsTab } from '@elementor/editor-site-settings';\n\nimport { AGENTS_SITE_SETTINGS_TAB_ID, AgentsSettingsTab } from './components/agents-settings-tab';\n\nconst EXPERIMENT_NAME = 'agents_llms_txt';\n\nfunction isAgentsExperimentActive(): boolean {\n\tconst features = window.elementorCommon?.config?.experimentalFeatures ?? {};\n\n\treturn Boolean( features[ EXPERIMENT_NAME ] );\n}\n\nexport function init() {\n\tif ( ! isAgentsExperimentActive() ) {\n\t\treturn;\n\t}\n\n\tinjectSiteSettingsTab( {\n\t\tid: AGENTS_SITE_SETTINGS_TAB_ID,\n\t\tcomponent: AgentsSettingsTab,\n\t} );\n}\n","import * as React from 'react';\nimport { useCallback, useState } from 'react';\nimport { __privateUseListenTo as useListenTo, routeOpenEvent } from '@elementor/editor-v1-adapters';\nimport { Box, Stack, TextField, Typography } from '@elementor/ui';\nimport { __ } from '@wordpress/i18n';\n\nimport { getSiteSettingsBag, readLlmsContent, writeLlmsContent } from '../llms-settings';\n\nconst TAB_ID = 'settings-agents';\nconst TAB_ROUTE = `panel/global/${ TAB_ID }`;\n\nexport function AgentsSettingsTab() {\n\tconst [ value, setValue ] = useState( readLlmsContent );\n\tconst [ isSettingsAvailable, setIsSettingsAvailable ] = useState( () => null !== getSiteSettingsBag() );\n\n\tuseListenTo( [ routeOpenEvent( TAB_ROUTE ) ], () => {\n\t\tsetIsSettingsAvailable( null !== getSiteSettingsBag() );\n\t\tsetValue( readLlmsContent() );\n\t} );\n\n\tconst handleChange = useCallback( ( event: React.ChangeEvent< HTMLInputElement > ) => {\n\t\tconst nextValue = event.target.value;\n\t\tsetValue( nextValue );\n\t\twriteLlmsContent( nextValue );\n\t}, [] );\n\n\treturn (\n\t\t<Box sx={ { p: 2 } }>\n\t\t\t<Stack spacing={ 1.5 }>\n\t\t\t\t<Typography variant=\"subtitle2\">{ __( 'Agents', 'elementor' ) }</Typography>\n\t\t\t\t<TextField\n\t\t\t\t\tlabel={ __( 'llms.txt', 'elementor' ) }\n\t\t\t\t\tvalue={ value }\n\t\t\t\t\tonChange={ handleChange }\n\t\t\t\t\tmultiline\n\t\t\t\t\tminRows={ 12 }\n\t\t\t\t\tfullWidth\n\t\t\t\t\tdisabled={ ! isSettingsAvailable }\n\t\t\t\t\thelperText={\n\t\t\t\t\t\tisSettingsAvailable\n\t\t\t\t\t\t\t? __( 'Content served at /llms.txt when saved. Leave empty to disable.', 'elementor' )\n\t\t\t\t\t\t\t: __( 'Kit settings are unavailable. Reopen Site Settings and try again.', 'elementor' )\n\t\t\t\t\t}\n\t\t\t\t/>\n\t\t\t</Stack>\n\t\t</Box>\n\t);\n}\n\nexport const AGENTS_SITE_SETTINGS_TAB_ID = TAB_ID;\n","import { getV1CurrentDocument, setDocumentModifiedStatus } from '@elementor/editor-documents';\n\nexport const AGENTS_SETTINGS_KEY = 'agents';\nexport const LLMS_SETTINGS_KEY = 'llms';\n\ntype AgentsSettings = Record< string, unknown >;\n\ntype SettingsBag = {\n\tget: ( key: string ) => unknown;\n\tset: ( key: string, value: unknown ) => void;\n};\n\nexport function getSiteSettingsBag(): SettingsBag | null {\n\tconst settings = getV1CurrentDocument()?.container?.settings;\n\n\treturn settings ? ( settings as SettingsBag ) : null;\n}\n\nfunction readAgentsSettings( settings: SettingsBag | null ): AgentsSettings {\n\tconst agents = settings?.get( AGENTS_SETTINGS_KEY );\n\n\treturn agents && typeof agents === 'object' ? { ...( agents as AgentsSettings ) } : {};\n}\n\nfunction omitLlms( agents: AgentsSettings ): AgentsSettings {\n\treturn Object.fromEntries( Object.entries( agents ).filter( ( [ key ] ) => key !== LLMS_SETTINGS_KEY ) );\n}\n\nfunction isEmpty( agents: AgentsSettings ): boolean {\n\treturn 0 === Object.keys( agents ).length;\n}\n\nexport function readLlmsContent(): string {\n\tconst llms = readAgentsSettings( getSiteSettingsBag() )[ LLMS_SETTINGS_KEY ];\n\n\treturn typeof llms === 'string' ? llms : '';\n}\n\nexport function writeLlmsContent( content: string ): boolean {\n\tconst settings = getSiteSettingsBag();\n\n\tif ( ! settings ) {\n\t\treturn false;\n\t}\n\n\tconst agents = readAgentsSettings( settings );\n\n\tif ( '' === content ) {\n\t\tconst remainingAgents = omitLlms( agents );\n\n\t\tsettings.set( AGENTS_SETTINGS_KEY, isEmpty( remainingAgents ) ? undefined : remainingAgents );\n\t} else {\n\t\tsettings.set( AGENTS_SETTINGS_KEY, { ...agents, [ LLMS_SETTINGS_KEY ]: content } );\n\t}\n\n\tsetDocumentModifiedStatus( true );\n\n\treturn true;\n}\n"],"mappings":"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","names":["useListenTo"]}

package/dist/index.mjs

@@ -0,0 +1,100 @@
+// src/init.ts
+import { injectSiteSettingsTab } from "@elementor/editor-site-settings";
+
+// src/components/agents-settings-tab.tsx
+import * as React from "react";
+import { useCallback, useState } from "react";
+import { __privateUseListenTo as useListenTo, routeOpenEvent } from "@elementor/editor-v1-adapters";
+import { Box, Stack, TextField, Typography } from "@elementor/ui";
+import { __ } from "@wordpress/i18n";
+
+// src/llms-settings.ts
+import { getV1CurrentDocument, setDocumentModifiedStatus } from "@elementor/editor-documents";
+var AGENTS_SETTINGS_KEY = "agents";
+var LLMS_SETTINGS_KEY = "llms";
+function getSiteSettingsBag() {
+  const settings = getV1CurrentDocument()?.container?.settings;
+  return settings ? settings : null;
+}
+function readAgentsSettings(settings) {
+  const agents = settings?.get(AGENTS_SETTINGS_KEY);
+  return agents && typeof agents === "object" ? { ...agents } : {};
+}
+function omitLlms(agents) {
+  return Object.fromEntries(Object.entries(agents).filter(([key]) => key !== LLMS_SETTINGS_KEY));
+}
+function isEmpty(agents) {
+  return 0 === Object.keys(agents).length;
+}
+function readLlmsContent() {
+  const llms = readAgentsSettings(getSiteSettingsBag())[LLMS_SETTINGS_KEY];
+  return typeof llms === "string" ? llms : "";
+}
+function writeLlmsContent(content) {
+  const settings = getSiteSettingsBag();
+  if (!settings) {
+    return false;
+  }
+  const agents = readAgentsSettings(settings);
+  if ("" === content) {
+    const remainingAgents = omitLlms(agents);
+    settings.set(AGENTS_SETTINGS_KEY, isEmpty(remainingAgents) ? void 0 : remainingAgents);
+  } else {
+    settings.set(AGENTS_SETTINGS_KEY, { ...agents, [LLMS_SETTINGS_KEY]: content });
+  }
+  setDocumentModifiedStatus(true);
+  return true;
+}
+
+// src/components/agents-settings-tab.tsx
+var TAB_ID = "settings-agents";
+var TAB_ROUTE = `panel/global/${TAB_ID}`;
+function AgentsSettingsTab() {
+  const [value, setValue] = useState(readLlmsContent);
+  const [isSettingsAvailable, setIsSettingsAvailable] = useState(() => null !== getSiteSettingsBag());
+  useListenTo([routeOpenEvent(TAB_ROUTE)], () => {
+    setIsSettingsAvailable(null !== getSiteSettingsBag());
+    setValue(readLlmsContent());
+  });
+  const handleChange = useCallback((event) => {
+    const nextValue = event.target.value;
+    setValue(nextValue);
+    writeLlmsContent(nextValue);
+  }, []);
+  return /* @__PURE__ */ React.createElement(Box, { sx: { p: 2 } }, /* @__PURE__ */ React.createElement(Stack, { spacing: 1.5 }, /* @__PURE__ */ React.createElement(Typography, { variant: "subtitle2" }, __("Agents", "elementor")), /* @__PURE__ */ React.createElement(
+    TextField,
+    {
+      label: __("llms.txt", "elementor"),
+      value,
+      onChange: handleChange,
+      multiline: true,
+      minRows: 12,
+      fullWidth: true,
+      disabled: !isSettingsAvailable,
+      helperText: isSettingsAvailable ? __("Content served at /llms.txt when saved. Leave empty to disable.", "elementor") : __("Kit settings are unavailable. Reopen Site Settings and try again.", "elementor")
+    }
+  )));
+}
+var AGENTS_SITE_SETTINGS_TAB_ID = TAB_ID;
+
+// src/init.ts
+var EXPERIMENT_NAME = "agents_llms_txt";
+function isAgentsExperimentActive() {
+  const features = window.elementorCommon?.config?.experimentalFeatures ?? {};
+  return Boolean(features[EXPERIMENT_NAME]);
+}
+function init() {
+  if (!isAgentsExperimentActive()) {
+    return;
+  }
+  injectSiteSettingsTab({
+    id: AGENTS_SITE_SETTINGS_TAB_ID,
+    component: AgentsSettingsTab
+  });
+}
+export {
+  AGENTS_SITE_SETTINGS_TAB_ID,
+  AgentsSettingsTab,
+  init
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/init.ts","../src/components/agents-settings-tab.tsx","../src/llms-settings.ts"],"sourcesContent":["import { injectSiteSettingsTab } from '@elementor/editor-site-settings';\n\nimport { AGENTS_SITE_SETTINGS_TAB_ID, AgentsSettingsTab } from './components/agents-settings-tab';\n\nconst EXPERIMENT_NAME = 'agents_llms_txt';\n\nfunction isAgentsExperimentActive(): boolean {\n\tconst features = window.elementorCommon?.config?.experimentalFeatures ?? {};\n\n\treturn Boolean( features[ EXPERIMENT_NAME ] );\n}\n\nexport function init() {\n\tif ( ! isAgentsExperimentActive() ) {\n\t\treturn;\n\t}\n\n\tinjectSiteSettingsTab( {\n\t\tid: AGENTS_SITE_SETTINGS_TAB_ID,\n\t\tcomponent: AgentsSettingsTab,\n\t} );\n}\n","import * as React from 'react';\nimport { useCallback, useState } from 'react';\nimport { __privateUseListenTo as useListenTo, routeOpenEvent } from '@elementor/editor-v1-adapters';\nimport { Box, Stack, TextField, Typography } from '@elementor/ui';\nimport { __ } from '@wordpress/i18n';\n\nimport { getSiteSettingsBag, readLlmsContent, writeLlmsContent } from '../llms-settings';\n\nconst TAB_ID = 'settings-agents';\nconst TAB_ROUTE = `panel/global/${ TAB_ID }`;\n\nexport function AgentsSettingsTab() {\n\tconst [ value, setValue ] = useState( readLlmsContent );\n\tconst [ isSettingsAvailable, setIsSettingsAvailable ] = useState( () => null !== getSiteSettingsBag() );\n\n\tuseListenTo( [ routeOpenEvent( TAB_ROUTE ) ], () => {\n\t\tsetIsSettingsAvailable( null !== getSiteSettingsBag() );\n\t\tsetValue( readLlmsContent() );\n\t} );\n\n\tconst handleChange = useCallback( ( event: React.ChangeEvent< HTMLInputElement > ) => {\n\t\tconst nextValue = event.target.value;\n\t\tsetValue( nextValue );\n\t\twriteLlmsContent( nextValue );\n\t}, [] );\n\n\treturn (\n\t\t<Box sx={ { p: 2 } }>\n\t\t\t<Stack spacing={ 1.5 }>\n\t\t\t\t<Typography variant=\"subtitle2\">{ __( 'Agents', 'elementor' ) }</Typography>\n\t\t\t\t<TextField\n\t\t\t\t\tlabel={ __( 'llms.txt', 'elementor' ) }\n\t\t\t\t\tvalue={ value }\n\t\t\t\t\tonChange={ handleChange }\n\t\t\t\t\tmultiline\n\t\t\t\t\tminRows={ 12 }\n\t\t\t\t\tfullWidth\n\t\t\t\t\tdisabled={ ! isSettingsAvailable }\n\t\t\t\t\thelperText={\n\t\t\t\t\t\tisSettingsAvailable\n\t\t\t\t\t\t\t? __( 'Content served at /llms.txt when saved. Leave empty to disable.', 'elementor' )\n\t\t\t\t\t\t\t: __( 'Kit settings are unavailable. Reopen Site Settings and try again.', 'elementor' )\n\t\t\t\t\t}\n\t\t\t\t/>\n\t\t\t</Stack>\n\t\t</Box>\n\t);\n}\n\nexport const AGENTS_SITE_SETTINGS_TAB_ID = TAB_ID;\n","import { getV1CurrentDocument, setDocumentModifiedStatus } from '@elementor/editor-documents';\n\nexport const AGENTS_SETTINGS_KEY = 'agents';\nexport const LLMS_SETTINGS_KEY = 'llms';\n\ntype AgentsSettings = Record< string, unknown >;\n\ntype SettingsBag = {\n\tget: ( key: string ) => unknown;\n\tset: ( key: string, value: unknown ) => void;\n};\n\nexport function getSiteSettingsBag(): SettingsBag | null {\n\tconst settings = getV1CurrentDocument()?.container?.settings;\n\n\treturn settings ? ( settings as SettingsBag ) : null;\n}\n\nfunction readAgentsSettings( settings: SettingsBag | null ): AgentsSettings {\n\tconst agents = settings?.get( AGENTS_SETTINGS_KEY );\n\n\treturn agents && typeof agents === 'object' ? { ...( agents as AgentsSettings ) } : {};\n}\n\nfunction omitLlms( agents: AgentsSettings ): AgentsSettings {\n\treturn Object.fromEntries( Object.entries( agents ).filter( ( [ key ] ) => key !== LLMS_SETTINGS_KEY ) );\n}\n\nfunction isEmpty( agents: AgentsSettings ): boolean {\n\treturn 0 === Object.keys( agents ).length;\n}\n\nexport function readLlmsContent(): string {\n\tconst llms = readAgentsSettings( getSiteSettingsBag() )[ LLMS_SETTINGS_KEY ];\n\n\treturn typeof llms === 'string' ? llms : '';\n}\n\nexport function writeLlmsContent( content: string ): boolean {\n\tconst settings = getSiteSettingsBag();\n\n\tif ( ! settings ) {\n\t\treturn false;\n\t}\n\n\tconst agents = readAgentsSettings( settings );\n\n\tif ( '' === content ) {\n\t\tconst remainingAgents = omitLlms( agents );\n\n\t\tsettings.set( AGENTS_SETTINGS_KEY, isEmpty( remainingAgents ) ? undefined : remainingAgents );\n\t} else {\n\t\tsettings.set( AGENTS_SETTINGS_KEY, { ...agents, [ LLMS_SETTINGS_KEY ]: content } );\n\t}\n\n\tsetDocumentModifiedStatus( true );\n\n\treturn true;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@elementor/editor-agents",
+  "version": "4.3.0-1031",
+  "private": false,
+  "author": "Elementor Team",
+  "homepage": "https://elementor.com/",
+  "license": "GPL-3.0-or-later",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/elementor/elementor.git",
+    "directory": "packages/core/editor-agents"
+  },
+  "bugs": {
+    "url": "https://github.com/elementor/elementor/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "/dist",
+    "/src",
+    "!**/__tests__"
+  ],
+  "scripts": {
+    "build": "tsup --config=../../tsup.build.ts",
+    "dev": "tsup --config=../../tsup.dev.ts"
+  },
+  "dependencies": {
+    "@elementor/editor-documents": "4.3.0-1031",
+    "@elementor/editor-site-settings": "4.3.0-1031",
+    "@elementor/editor-v1-adapters": "4.3.0-1031",
+    "@elementor/ui": "1.37.5",
+    "@wordpress/i18n": "^5.13.0"
+  },
+  "peerDependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5"
+  }
+}

package/src/components/agents-settings-tab.tsx

@@ -0,0 +1,50 @@
+import * as React from 'react';
+import { useCallback, useState } from 'react';
+import { __privateUseListenTo as useListenTo, routeOpenEvent } from '@elementor/editor-v1-adapters';
+import { Box, Stack, TextField, Typography } from '@elementor/ui';
+import { __ } from '@wordpress/i18n';
+
+import { getSiteSettingsBag, readLlmsContent, writeLlmsContent } from '../llms-settings';
+
+const TAB_ID = 'settings-agents';
+const TAB_ROUTE = `panel/global/${ TAB_ID }`;
+
+export function AgentsSettingsTab() {
+	const [ value, setValue ] = useState( readLlmsContent );
+	const [ isSettingsAvailable, setIsSettingsAvailable ] = useState( () => null !== getSiteSettingsBag() );
+
+	useListenTo( [ routeOpenEvent( TAB_ROUTE ) ], () => {
+		setIsSettingsAvailable( null !== getSiteSettingsBag() );
+		setValue( readLlmsContent() );
+	} );
+
+	const handleChange = useCallback( ( event: React.ChangeEvent< HTMLInputElement > ) => {
+		const nextValue = event.target.value;
+		setValue( nextValue );
+		writeLlmsContent( nextValue );
+	}, [] );
+
+	return (
+		<Box sx={ { p: 2 } }>
+			<Stack spacing={ 1.5 }>
+				<Typography variant="subtitle2">{ __( 'Agents', 'elementor' ) }</Typography>
+				<TextField
+					label={ __( 'llms.txt', 'elementor' ) }
+					value={ value }
+					onChange={ handleChange }
+					multiline
+					minRows={ 12 }
+					fullWidth
+					disabled={ ! isSettingsAvailable }
+					helperText={
+						isSettingsAvailable
+							? __( 'Content served at /llms.txt when saved. Leave empty to disable.', 'elementor' )
+							: __( 'Kit settings are unavailable. Reopen Site Settings and try again.', 'elementor' )
+					}
+				/>
+			</Stack>
+		</Box>
+	);
+}
+
+export const AGENTS_SITE_SETTINGS_TAB_ID = TAB_ID;

package/src/index.ts

@@ -0,0 +1,2 @@
+export { init } from './init';
+export { AGENTS_SITE_SETTINGS_TAB_ID, AgentsSettingsTab } from './components/agents-settings-tab';

package/src/init.ts

@@ -0,0 +1,22 @@
+import { injectSiteSettingsTab } from '@elementor/editor-site-settings';
+
+import { AGENTS_SITE_SETTINGS_TAB_ID, AgentsSettingsTab } from './components/agents-settings-tab';
+
+const EXPERIMENT_NAME = 'agents_llms_txt';
+
+function isAgentsExperimentActive(): boolean {
+	const features = window.elementorCommon?.config?.experimentalFeatures ?? {};
+
+	return Boolean( features[ EXPERIMENT_NAME ] );
+}
+
+export function init() {
+	if ( ! isAgentsExperimentActive() ) {
+		return;
+	}
+
+	injectSiteSettingsTab( {
+		id: AGENTS_SITE_SETTINGS_TAB_ID,
+		component: AgentsSettingsTab,
+	} );
+}

package/src/llms-settings.ts

@@ -0,0 +1,59 @@
+import { getV1CurrentDocument, setDocumentModifiedStatus } from '@elementor/editor-documents';
+
+export const AGENTS_SETTINGS_KEY = 'agents';
+export const LLMS_SETTINGS_KEY = 'llms';
+
+type AgentsSettings = Record< string, unknown >;
+
+type SettingsBag = {
+	get: ( key: string ) => unknown;
+	set: ( key: string, value: unknown ) => void;
+};
+
+export function getSiteSettingsBag(): SettingsBag | null {
+	const settings = getV1CurrentDocument()?.container?.settings;
+
+	return settings ? ( settings as SettingsBag ) : null;
+}
+
+function readAgentsSettings( settings: SettingsBag | null ): AgentsSettings {
+	const agents = settings?.get( AGENTS_SETTINGS_KEY );
+
+	return agents && typeof agents === 'object' ? { ...( agents as AgentsSettings ) } : {};
+}
+
+function omitLlms( agents: AgentsSettings ): AgentsSettings {
+	return Object.fromEntries( Object.entries( agents ).filter( ( [ key ] ) => key !== LLMS_SETTINGS_KEY ) );
+}
+
+function isEmpty( agents: AgentsSettings ): boolean {
+	return 0 === Object.keys( agents ).length;
+}
+
+export function readLlmsContent(): string {
+	const llms = readAgentsSettings( getSiteSettingsBag() )[ LLMS_SETTINGS_KEY ];
+
+	return typeof llms === 'string' ? llms : '';
+}
+
+export function writeLlmsContent( content: string ): boolean {
+	const settings = getSiteSettingsBag();
+
+	if ( ! settings ) {
+		return false;
+	}
+
+	const agents = readAgentsSettings( settings );
+
+	if ( '' === content ) {
+		const remainingAgents = omitLlms( agents );
+
+		settings.set( AGENTS_SETTINGS_KEY, isEmpty( remainingAgents ) ? undefined : remainingAgents );
+	} else {
+		settings.set( AGENTS_SETTINGS_KEY, { ...agents, [ LLMS_SETTINGS_KEY ]: content } );
+	}
+
+	setDocumentModifiedStatus( true );
+
+	return true;
+}