json-object-editor 0.10.653 → 0.10.657

package/CHANGELOG.md

@@ -1,3 +1,49 @@
+## 0.10.657
+
+- MCP as an optional layer on all AI surfaces
+  - `ai_prompt`: added MCP config block (`mcp_enabled`, `mcp_toolset`, `mcp_selected_tools`, `mcp_instructions_mode`) so prompts can opt into MCP tools with named toolsets (`read-only`, `minimal`, `all`, `custom`) and auto‑generated tool instructions.
+  - Autofill: field‑level `ai` configs now accept the same MCP keys, enabling per‑field MCP tooling for `_joe.Ai.populateField` runs.
+  - `ai_response`: now records MCP config and `mcp_tools_used[]` for every run, plus `used_openai_file_ids[]` for attached OpenAI Files.
+- Uploader file roles + AI‑aware attachments
+  - Uploader fields can declare `file_roles` (array of `{ value, label?, default? }`); the UI renders a per‑file role `<select>` and persists the choice to `file_role` on each file object.
+  - `executeJOEAiPrompt` now injects an `uploaded_files[]` header into the user input, listing `{ itemtype, field, name, role, openai_file_id }` for each attached file so prompts can distinguish “transcript” vs “summary” sources.
+  - `runWithTools` now applies `attachFilesToResponsesPayload` to both the initial tool‑planning call and the final Responses call (including the token‑limit retry), so MCP runs consistently see file attachments.
+- Storage / history robustness
+  - Hardened `JOE.Storage.save` history diffing by sanitizing cached vs current documents before `$c.changes(...)` to avoid a `craydent-object.equals` edge case where comparing `null`/`undefined` could throw on `.toString()`. This only affects `_history.changes`, not saved documents.
+
+## 0.10.654
+
+- Uploader + OpenAI Files integration
+  - After successful S3 upload, the server now (optionally) uploads the same bytes to OpenAI Files when `OPENAI_API_KEY` is set. Purpose is hard‑coded to `assistants`.
+  - Added `openai_file_id`, `openai_purpose`, and `etag` to the upload response from `/API/plugin/awsConnect`.
+  - Client persists OpenAI metadata on each file object and shows the OpenAI file id directly under the filename in the uploader preview.
+  - Per‑file “Upload to OpenAI” / “Retry OpenAI” action added (visible when no id or when status=error). This calls `POST /API/plugin/chatgpt/filesRetryFromUrl` and updates the file metadata, then quick‑saves.
+  - Removed the previous “OpenAI: OK” status chip to reduce noise; the file id now communicates success.
+
+- Prompts and Responses (OpenAI)
+  - `ai_prompt`: new `attachments_mode` (`direct` | `file_search`) controls how selected files are used.
+    - `direct`: sends files via Responses content parts (`input_file` with `file_id`).
+    - `file_search`: creates a vector store on the fly and attaches it to `file_search` tool resources.
+  - Automatic safety retry: if a model rejects `temperature/top_p`, we strip and retry once.
+  - Select Prompt: prompt discovery now matches by `datasets[]` OR `content_items[].itemtype` (status must be active).
+  - `ai_response`: added read‑only display for `used_openai_file_ids[]`; fixed renderer.
+  - Bugfix: `referenced_objects` now populates for Select Prompt runs (accepts `data.params` shape).
+
+- UX
+  - “Run AI Prompt” and “Run Thought Agent” buttons now disable and show a subtle pulse while running to prevent double‑clicks.
+
+- New ChatGPT plugin helpers
+  - `filesUploadFromBufferHelper({ buffer, filename, contentType, purpose })` – internal helper used by the S3 plugin.
+  - `filesRetryFromUrl({ url, filename?, contentType? })` – public endpoint to (re)upload an existing S3 file to OpenAI (returns `openai_file_id`).
+  - Fixed ESM import error by dynamically importing `got` inside the plugin.
+
+- Uploader polish
+  - “Upload File” button is now shown automatically whenever pending files exist (e.g., base64 present, no URL yet).
+  - UI surfaces verbose OpenAI errors inline on failure.
+
+- Docs updated
+  - README’s File Uploads section expanded to cover OpenAI Files flow, retry endpoint, and how to use file ids.
+
 ## 0.10.653 - JSON field added
 - Added `json` field type for editing/storing JSON subobjects in schemas (object-only, default `{}`).
 - Uses the existing Ace-based code editor in JSON mode with blur/save pretty-printing for consistent formatting.
@@ -996,4 +1042,4 @@ icons added, bug fixes.
 *v0.4.1
 files directory added. defaults to /_files/_
 *V0.4.0
-now ready to be loaded as a node require.
+now ready to be loaded as a node require.

package/_www/mcp-test.html

@@ -1,276 +1,287 @@
-<!doctype html>
-<html>
-<head>
-	<meta charset="utf-8">
-	<title>JOE MCP Test</title>
-	<meta name="viewport" content="width=device-width, initial-scale=1">
-	<style>
-		body{font-family:system-ui,-apple-system,Segoe UI,Roboto,Ubuntu,Cantarell,Noto Sans,sans-serif;margin:20px;}
-		label{display:block;margin:8px 0 4px}
-		select, input, textarea, button{font-size:14px}
-		textarea{width:100%;height:160px;font-family:ui-monospace,Menlo,Consolas,monospace}
-		pre{background:#f6f8fa;border:1px solid #e1e4e8;padding:10px;overflow:auto}
-		.row{display:flex;gap:12px;align-items:center;flex-wrap:wrap}
-		.small{font-size:12px;color:#666}
-		.bad{color:#b00020}
-		.good{color:#0a7d00}
-		.preset{margin:8px 0;}
-	</style>
-</head>
-<body>
-    <div id="mcp-nav"></div>
-    <script src="/JsonObjectEditor/_www/mcp-nav.js"></script>
-    <h1>JOE MCP Test</h1>
-    <div class="small">Use this page to discover tools and call the JSON-RPC endpoint.</div>
-	
-	<h3>Manifest</h3>
-	<div class="row">
-		<label for="base">Base URL</label>
-		<input id="base" value="" placeholder="http://localhost:{{PORT}}" style="min-width:280px"/>
-		<button id="loadManifest">Load manifest</button>
-		<span id="status" class="small"></span>
-	</div>
-	<label for="tool">Tools</label>
-	<select id="tool"></select>
-	<pre id="toolInfo"></pre>
-	
-	<h3>Presets</h3>
-	<div class="preset">
-		<button id="presetFuzzyUser">fuzzySearch users: q="corey hadden"</button>
-		<button id="presetFuzzyHouse">fuzzySearch houses: q="backyard"</button>
-		<button id="presetListApps">listApps: all app definitions</button>
-		<button id="presetGetSchemas">getSchemas: ["client","user"]</button>
-		<button id="presetGetSchemasSummary">getSchemas (summaryOnly): ["task","project"]</button>
-		<button id="presetSearchSlimRecent">search clients (slim, recent)</button>
-		<button id="presetSearchWithCount">search clients (withCount)</button>
-		<button id="presetSearchCountOnly">search clients (countOnly)</button>
-		<button id="presetSaveObjects">saveObjects: batch save (example)</button>
-		<button id="presetUnderstandObject">understandObject: by _id</button>
-		<button id="presetFindByTag">findObjectsByTag: by tags (example)</button>
-		<button id="presetFindByStatus">findObjectsByStatus: by status (example)</button>
-	</div>
-	
-	<h3>Call JSON-RPC</h3>
-	<label for="params">Params (JSON)</label>
-	<textarea id="params">{}</textarea>
-	<div class="row">
-		<button id="call">POST /mcp</button>
-		<span id="callStatus" class="small"></span>
-	</div>
-	<pre id="result"></pre>
-	
-	<script>
-	(function(){
-		const $ = (id)=>document.getElementById(id);
-		const base = $('base');
-		const loadBtn = $('loadManifest');
-		const status = $('status');
-		const toolSel = $('tool');
-		const toolInfo = $('toolInfo');
-		const params = $('params');
-		const callBtn = $('call');
-		const callStatus = $('callStatus');
-		const result = $('result');
-		const presetFuzzyUser = $('presetFuzzyUser');
-		const presetFuzzyHouse = $('presetFuzzyHouse');
-		const presetListApps = $('presetListApps');
-		const presetGetSchemas = $('presetGetSchemas');
-		const presetGetSchemasSummary = $('presetGetSchemasSummary');
-		const presetSearchSlimRecent = $('presetSearchSlimRecent');
-		const presetSearchWithCount = $('presetSearchWithCount');
-		const presetSearchCountOnly = $('presetSearchCountOnly');
-		const presetSaveObjects = $('presetSaveObjects');
-		const presetUnderstandObject = $('presetUnderstandObject');
-		const presetFindByTag = $('presetFindByTag');
-		const presetFindByStatus = $('presetFindByStatus');
-		
-		// Try to infer base from window location
-		base.value = base.value || (location.origin);
-		
-		let manifest = null;
-		let idCounter = 1;
-
-		function ensureTool(name, meta){
-			if (!manifest) { manifest = { tools: [] }; }
-			manifest.tools = manifest.tools || [];
-			var existing = (manifest.tools||[]).find(function(t){ return t && t.name === name; });
-			if (!existing && meta) { manifest.tools.push(meta); }
-			// ensure option exists in select
-			var hasOpt = false;
-			for (var i=0;i<toolSel.options.length;i++){ if (toolSel.options[i].value === name) { hasOpt = true; break; } }
-			if (!hasOpt){ var opt=document.createElement('option'); opt.value=name; opt.textContent=name; toolSel.appendChild(opt); }
-		}
-		
-		function setStatus(el, msg, ok){
-			el.textContent = msg || '';
-			el.className = 'small ' + (ok===true?'good': ok===false?'bad':'');
-		}
-		
-		async function fetchJSON(url, opts){
-			const res = await fetch(url, opts);
-			const ct = res.headers.get('content-type')||'';
-			const isJSON = ct.includes('application/json');
-			if(!res.ok){
-				let detail = isJSON ? await res.json().catch(()=>({})) : await res.text();
-				throw new Error('HTTP '+res.status+': '+(isJSON?JSON.stringify(detail):detail));
-			}
-			return isJSON ? res.json() : res.text();
-		}
-		
-		loadBtn.onclick = async function(){
-			setStatus(status, 'Loading...', null);
-			toolSel.innerHTML = '';
-			toolInfo.textContent='';
-			try{
-				const url = base.value.replace(/\/$/,'') + '/.well-known/mcp/manifest.json';
-				manifest = await fetchJSON(url);
-	            // Instance info handled by shared nav script
-	            (manifest.tools||[]).forEach(t=>{
-					const opt=document.createElement('option');
-					opt.value=t.name; opt.textContent=t.name;
-					toolSel.appendChild(opt);
-				});
-				if((manifest.tools||[]).length){
-					toolSel.selectedIndex=0; renderToolInfo();
-				}
-				setStatus(status, 'Manifest loaded', true);
-			}catch(e){
-				setStatus(status, e.message||String(e), false);
-			}
-		};
-		
-		function renderToolInfo(){
-			const name = toolSel.value;
-			const tool = (manifest.tools||[]).find(t=>t.name===name);
-			toolInfo.textContent = tool ? JSON.stringify(tool, null, 2) : '';
-			// Prefill common params for convenience
-			if(tool && tool.params){
-				params.value = JSON.stringify(Object.fromEntries(Object.keys(tool.params.properties||{}).map(k=>[k, null])), null, 2);
-			}
-			// Hydrate presets UI
-			if (name === 'hydrate') {
-				params.value = JSON.stringify({}, null, 2);
-			}
-		}
-		toolSel.onchange = renderToolInfo;
-
-		presetFuzzyUser.onclick = function(){
-			toolSel.value = 'fuzzySearch';
-			renderToolInfo();
-			params.value = JSON.stringify({ q: 'corey hadden', filters: { itemtype: 'user' }, threshold: 0.5 }, null, 2);
-		};
-		presetFuzzyHouse.onclick = function(){
-			toolSel.value = 'fuzzySearch';
-			renderToolInfo();
-			params.value = JSON.stringify({ q: 'backyard', filters: { itemtype: 'house' }, threshold: 0.5 }, null, 2);
-		};
-		presetListApps.onclick = function(){
-			toolSel.value = 'listApps';
-			renderToolInfo();
-			params.value = JSON.stringify({}, null, 2);
-		};
-
-		presetGetSchemas.onclick = function(){
-			ensureTool('getSchemas', {
-				name: 'getSchemas',
-				description: 'Retrieve multiple schema definitions. If omitted, returns all.',
-				params: { type: 'object', properties: { names: { type: 'array', items: { type: 'string' } } } },
-				returns: { type: 'object' }
-			});
-			toolSel.value = 'getSchemas';
-			renderToolInfo();
-			params.value = JSON.stringify({ names: ["client", "user"] }, null, 2);
-		};
-
-		presetGetSchemasSummary.onclick = function(){
-			ensureTool('getSchemas', {
-				name: 'getSchemas',
-				description: 'Retrieve multiple schemas. With summaryOnly=true, returns summaries; if names omitted, returns all.',
-				params: { type: 'object', properties: { names: { type: 'array', items: { type: 'string' } }, summaryOnly: { type: 'boolean' } } },
-				returns: { type: 'object' }
-			});
-			toolSel.value = 'getSchemas';
-			renderToolInfo();
-			params.value = JSON.stringify({ names: ["task", "project"], summaryOnly: true }, null, 2);
-		};
-
-        presetSearchSlimRecent.onclick = function(){
-			toolSel.value = 'search';
-			renderToolInfo();
-            params.value = JSON.stringify({ itemtype: 'client', source: 'cache', query: { itemtype: 'client' }, limit: 25, sortBy: 'joeUpdated', sortDir: 'desc', slim: true }, null, 2);
-		};
-
-		presetSearchWithCount.onclick = function(){
-			toolSel.value = 'search';
-			renderToolInfo();
-            params.value = JSON.stringify({ itemtype: 'client', source: 'cache', query: { itemtype: 'client' }, limit: 25, withCount: true, sortBy: 'joeUpdated', sortDir: 'desc' }, null, 2);
-		};
-
-		presetSearchCountOnly.onclick = function(){
-			toolSel.value = 'search';
-			renderToolInfo();
-            params.value = JSON.stringify({ itemtype: 'client', source: 'cache', query: { itemtype: 'client' }, countOnly: true }, null, 2);
-		};
-
-		presetSaveObjects.onclick = function(){
-			toolSel.value = 'saveObjects';
-			renderToolInfo();
-			// Example: two minimal objects; adjust itemtype/fields as needed
-			params.value = JSON.stringify({
-				objects: [
-					{ itemtype: "client", name: "Batch Client A" },
-					{ itemtype: "client", name: "Batch Client B" }
-				],
-				stopOnError: false,
-				concurrency: 5
-			}, null, 2);
-		};
-
-		presetUnderstandObject.onclick = function(){
-			toolSel.value = 'understandObject';
-			renderToolInfo();
-			// Provide a template; user should replace _id with a real object id.
-			params.value = JSON.stringify({ _id: "REPLACE_WITH_OBJECT_ID", depth: 2 }, null, 2);
-		};
-
-		presetFindByTag.onclick = function(){
-			toolSel.value = 'findObjectsByTag';
-			renderToolInfo();
-			// Example: find objects with all of these tags
-			params.value = JSON.stringify({ tags: ["REPLACE_WITH_TAG_ID_1", "REPLACE_WITH_TAG_ID_2"], itemtype: "task" }, null, 2);
-		};
-
-		presetFindByStatus.onclick = function(){
-			toolSel.value = 'findObjectsByStatus';
-			renderToolInfo();
-			// Example: find objects with this status
-			params.value = JSON.stringify({ status: "REPLACE_WITH_STATUS_ID", itemtype: "task" }, null, 2);
-		};
-		
-		callBtn.onclick = async function(){
-			setStatus(callStatus, 'Calling...', null);
-			result.textContent='';
-			try{
-				const url = base.value.replace(/\/$/,'') + '/mcp';
-				let p = {};
-				try{ p = params.value ? JSON.parse(params.value) : {}; }catch(e){ throw new Error('Invalid JSON in params'); }
-				const body = {
-					jsonrpc: '2.0',
-					id: String(idCounter++),
-					method: toolSel.value,
-					params: p
-				};
-				const resp = await fetchJSON(url, { method:'POST', headers:{'Content-Type':'application/json'}, body: JSON.stringify(body)});
-				result.textContent = JSON.stringify(resp, null, 2);
-				setStatus(callStatus, 'OK', true);
-			}catch(e){
-				setStatus(callStatus, e.message||String(e), false);
-			}
-		};
-		
-		// Auto-load manifest on open
-		setTimeout(()=>loadBtn.click(), 50);
-		})();
-	</script>
-</body>
-</html>
+<!doctype html>
+<html>
+<head>
+	<meta charset="utf-8">
+	<title>JOE MCP Test</title>
+	<meta name="viewport" content="width=device-width, initial-scale=1">
+	<style>
+		body{font-family:system-ui,-apple-system,Segoe UI,Roboto,Ubuntu,Cantarell,Noto Sans,sans-serif;margin:20px;}
+		label{display:block;margin:8px 0 4px}
+		select, input, textarea, button{font-size:14px}
+		textarea{width:100%;height:160px;font-family:ui-monospace,Menlo,Consolas,monospace}
+		pre{background:#f6f8fa;border:1px solid #e1e4e8;padding:10px;overflow:auto}
+		.row{display:flex;gap:12px;align-items:center;flex-wrap:wrap}
+		.small{font-size:12px;color:#666}
+		.bad{color:#b00020}
+		.good{color:#0a7d00}
+		.preset{margin:8px 0;}
+	</style>
+</head>
+<body>
+    <div id="mcp-nav"></div>
+    <script src="/JsonObjectEditor/_www/mcp-nav.js"></script>
+    <h1>JOE MCP Test</h1>
+    <div class="small">Use this page to discover tools and call the JSON-RPC endpoint.</div>
+    
+    <h3>Toolsets (from manifest)</h3>
+    <pre id="toolsets"></pre>
+
+	<h3>Manifest</h3>
+	<div class="row">
+		<label for="base">Base URL</label>
+		<input id="base" value="" placeholder="http://localhost:{{PORT}}" style="min-width:280px"/>
+		<button id="loadManifest">Load manifest</button>
+		<span id="status" class="small"></span>
+	</div>
+	<label for="tool">Tools</label>
+	<select id="tool"></select>
+	<pre id="toolInfo"></pre>
+	
+	<h3>Presets</h3>
+	<div class="preset">
+		<button id="presetFuzzyUser">fuzzySearch users: q="corey hadden"</button>
+		<button id="presetFuzzyHouse">fuzzySearch houses: q="backyard"</button>
+		<button id="presetListApps">listApps: all app definitions</button>
+		<button id="presetGetSchemas">getSchemas: ["client","user"]</button>
+		<button id="presetGetSchemasSummary">getSchemas (summaryOnly): ["task","project"]</button>
+		<button id="presetSearchSlimRecent">search clients (slim, recent)</button>
+		<button id="presetSearchWithCount">search clients (withCount)</button>
+		<button id="presetSearchCountOnly">search clients (countOnly)</button>
+		<button id="presetSaveObjects">saveObjects: batch save (example)</button>
+		<button id="presetUnderstandObject">understandObject: by _id</button>
+		<button id="presetFindByTag">findObjectsByTag: by tags (example)</button>
+		<button id="presetFindByStatus">findObjectsByStatus: by status (example)</button>
+	</div>
+	
+	<h3>Call JSON-RPC</h3>
+	<label for="params">Params (JSON)</label>
+	<textarea id="params">{}</textarea>
+	<div class="row">
+		<button id="call">POST /mcp</button>
+		<span id="callStatus" class="small"></span>
+	</div>
+	<pre id="result"></pre>
+	
+	<script>
+	(function(){
+		const $ = (id)=>document.getElementById(id);
+		const base = $('base');
+		const loadBtn = $('loadManifest');
+        const toolsetsEl = document.getElementById('toolsets');
+		const status = $('status');
+		const toolSel = $('tool');
+		const toolInfo = $('toolInfo');
+		const params = $('params');
+		const callBtn = $('call');
+		const callStatus = $('callStatus');
+		const result = $('result');
+		const presetFuzzyUser = $('presetFuzzyUser');
+		const presetFuzzyHouse = $('presetFuzzyHouse');
+		const presetListApps = $('presetListApps');
+		const presetGetSchemas = $('presetGetSchemas');
+		const presetGetSchemasSummary = $('presetGetSchemasSummary');
+		const presetSearchSlimRecent = $('presetSearchSlimRecent');
+		const presetSearchWithCount = $('presetSearchWithCount');
+		const presetSearchCountOnly = $('presetSearchCountOnly');
+		const presetSaveObjects = $('presetSaveObjects');
+		const presetUnderstandObject = $('presetUnderstandObject');
+		const presetFindByTag = $('presetFindByTag');
+		const presetFindByStatus = $('presetFindByStatus');
+		
+		// Try to infer base from window location
+		base.value = base.value || (location.origin);
+		
+		let manifest = null;
+		let idCounter = 1;
+
+		function ensureTool(name, meta){
+			if (!manifest) { manifest = { tools: [] }; }
+			manifest.tools = manifest.tools || [];
+			var existing = (manifest.tools||[]).find(function(t){ return t && t.name === name; });
+			if (!existing && meta) { manifest.tools.push(meta); }
+			// ensure option exists in select
+			var hasOpt = false;
+			for (var i=0;i<toolSel.options.length;i++){ if (toolSel.options[i].value === name) { hasOpt = true; break; } }
+			if (!hasOpt){ var opt=document.createElement('option'); opt.value=name; opt.textContent=name; toolSel.appendChild(opt); }
+		}
+		
+		function setStatus(el, msg, ok){
+			el.textContent = msg || '';
+			el.className = 'small ' + (ok===true?'good': ok===false?'bad':'');
+		}
+		
+		async function fetchJSON(url, opts){
+			const res = await fetch(url, opts);
+			const ct = res.headers.get('content-type')||'';
+			const isJSON = ct.includes('application/json');
+			if(!res.ok){
+				let detail = isJSON ? await res.json().catch(()=>({})) : await res.text();
+				throw new Error('HTTP '+res.status+': '+(isJSON?JSON.stringify(detail):detail));
+			}
+			return isJSON ? res.json() : res.text();
+		}
+		
+		loadBtn.onclick = async function(){
+			setStatus(status, 'Loading...', null);
+			toolSel.innerHTML = '';
+			toolInfo.textContent='';
+			try{
+				const url = base.value.replace(/\/$/,'') + '/.well-known/mcp/manifest.json';
+				manifest = await fetchJSON(url);
+	            // Instance info handled by shared nav script
+	            (manifest.tools||[]).forEach(t=>{
+					const opt=document.createElement('option');
+					opt.value=t.name; opt.textContent=t.name;
+					toolSel.appendChild(opt);
+				});
+				if((manifest.tools||[]).length){
+					toolSel.selectedIndex=0; renderToolInfo();
+				}
+                if (toolsetsEl) {
+                    try{
+                        toolsetsEl.textContent = JSON.stringify(manifest.toolsets || {}, null, 2);
+                    }catch(_e){
+                        toolsetsEl.textContent = '';
+                    }
+                }
+				setStatus(status, 'Manifest loaded', true);
+			}catch(e){
+				setStatus(status, e.message||String(e), false);
+			}
+		};
+		
+		function renderToolInfo(){
+			const name = toolSel.value;
+			const tool = (manifest.tools||[]).find(t=>t.name===name);
+			toolInfo.textContent = tool ? JSON.stringify(tool, null, 2) : '';
+			// Prefill common params for convenience
+			if(tool && tool.params){
+				params.value = JSON.stringify(Object.fromEntries(Object.keys(tool.params.properties||{}).map(k=>[k, null])), null, 2);
+			}
+			// Hydrate presets UI
+			if (name === 'hydrate') {
+				params.value = JSON.stringify({}, null, 2);
+			}
+		}
+		toolSel.onchange = renderToolInfo;
+
+		presetFuzzyUser.onclick = function(){
+			toolSel.value = 'fuzzySearch';
+			renderToolInfo();
+			params.value = JSON.stringify({ q: 'corey hadden', filters: { itemtype: 'user' }, threshold: 0.5 }, null, 2);
+		};
+		presetFuzzyHouse.onclick = function(){
+			toolSel.value = 'fuzzySearch';
+			renderToolInfo();
+			params.value = JSON.stringify({ q: 'backyard', filters: { itemtype: 'house' }, threshold: 0.5 }, null, 2);
+		};
+		presetListApps.onclick = function(){
+			toolSel.value = 'listApps';
+			renderToolInfo();
+			params.value = JSON.stringify({}, null, 2);
+		};
+
+		presetGetSchemas.onclick = function(){
+			ensureTool('getSchemas', {
+				name: 'getSchemas',
+				description: 'Retrieve multiple schema definitions. If omitted, returns all.',
+				params: { type: 'object', properties: { names: { type: 'array', items: { type: 'string' } } } },
+				returns: { type: 'object' }
+			});
+			toolSel.value = 'getSchemas';
+			renderToolInfo();
+			params.value = JSON.stringify({ names: ["client", "user"] }, null, 2);
+		};
+
+		presetGetSchemasSummary.onclick = function(){
+			ensureTool('getSchemas', {
+				name: 'getSchemas',
+				description: 'Retrieve multiple schemas. With summaryOnly=true, returns summaries; if names omitted, returns all.',
+				params: { type: 'object', properties: { names: { type: 'array', items: { type: 'string' } }, summaryOnly: { type: 'boolean' } } },
+				returns: { type: 'object' }
+			});
+			toolSel.value = 'getSchemas';
+			renderToolInfo();
+			params.value = JSON.stringify({ names: ["task", "project"], summaryOnly: true }, null, 2);
+		};
+
+        presetSearchSlimRecent.onclick = function(){
+			toolSel.value = 'search';
+			renderToolInfo();
+            params.value = JSON.stringify({ itemtype: 'client', source: 'cache', query: { itemtype: 'client' }, limit: 25, sortBy: 'joeUpdated', sortDir: 'desc', slim: true }, null, 2);
+		};
+
+		presetSearchWithCount.onclick = function(){
+			toolSel.value = 'search';
+			renderToolInfo();
+            params.value = JSON.stringify({ itemtype: 'client', source: 'cache', query: { itemtype: 'client' }, limit: 25, withCount: true, sortBy: 'joeUpdated', sortDir: 'desc' }, null, 2);
+		};
+
+		presetSearchCountOnly.onclick = function(){
+			toolSel.value = 'search';
+			renderToolInfo();
+            params.value = JSON.stringify({ itemtype: 'client', source: 'cache', query: { itemtype: 'client' }, countOnly: true }, null, 2);
+		};
+
+		presetSaveObjects.onclick = function(){
+			toolSel.value = 'saveObjects';
+			renderToolInfo();
+			// Example: two minimal objects; adjust itemtype/fields as needed
+			params.value = JSON.stringify({
+				objects: [
+					{ itemtype: "client", name: "Batch Client A" },
+					{ itemtype: "client", name: "Batch Client B" }
+				],
+				stopOnError: false,
+				concurrency: 5
+			}, null, 2);
+		};
+
+		presetUnderstandObject.onclick = function(){
+			toolSel.value = 'understandObject';
+			renderToolInfo();
+			// Provide a template; user should replace _id with a real object id.
+			params.value = JSON.stringify({ _id: "REPLACE_WITH_OBJECT_ID", depth: 2 }, null, 2);
+		};
+
+		presetFindByTag.onclick = function(){
+			toolSel.value = 'findObjectsByTag';
+			renderToolInfo();
+			// Example: find objects with all of these tags
+			params.value = JSON.stringify({ tags: ["REPLACE_WITH_TAG_ID_1", "REPLACE_WITH_TAG_ID_2"], itemtype: "task" }, null, 2);
+		};
+
+		presetFindByStatus.onclick = function(){
+			toolSel.value = 'findObjectsByStatus';
+			renderToolInfo();
+			// Example: find objects with this status
+			params.value = JSON.stringify({ status: "REPLACE_WITH_STATUS_ID", itemtype: "task" }, null, 2);
+		};
+		
+		callBtn.onclick = async function(){
+			setStatus(callStatus, 'Calling...', null);
+			result.textContent='';
+			try{
+				const url = base.value.replace(/\/$/,'') + '/mcp';
+				let p = {};
+				try{ p = params.value ? JSON.parse(params.value) : {}; }catch(e){ throw new Error('Invalid JSON in params'); }
+				const body = {
+					jsonrpc: '2.0',
+					id: String(idCounter++),
+					method: toolSel.value,
+					params: p
+				};
+				const resp = await fetchJSON(url, { method:'POST', headers:{'Content-Type':'application/json'}, body: JSON.stringify(body)});
+				result.textContent = JSON.stringify(resp, null, 2);
+				setStatus(callStatus, 'OK', true);
+			}catch(e){
+				setStatus(callStatus, e.message||String(e), false);
+			}
+		};
+		
+		// Auto-load manifest on open
+		setTimeout(()=>loadBtn.click(), 50);
+		})();
+	</script>
+</body>
+</html>