npm - json-object-editor - Versions diffs - 0.10.504 → 0.10.506 - Mend

json-object-editor 0.10.504 → 0.10.506

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -29,6 +29,15 @@
  	- Added privacy_policy_url and terms_of_service_url to manifest; added public /privacy and /terms pages
 	- New Setting: PRIVACY_CONTACT used for contact email on /privacy and /terms
+	505 - Prompt page and shared nav consolidation
+	- Added /mcp-prompt.html (concise starter instructions for Custom GPT/Assistants)
+	- Extracted shared nav to /JsonObjectEditor/_www/mcp-nav.js and used across Test/Export/Privacy/Terms
+	- Nav now shows instance name/version/host and links to Privacy/Terms (named windows)
+	506 - Agent context + search count
+	- Added concise JOE context block for agent prompts (schema-first decisions, IDs, query strategy, writes, autonomy)
+	- search now supports { countOnly: true } to return only a count for large-result checks
 ### 0.10.500
 	500 - MCP integration (initial)
 	- MCP core module with JSON-RPC 2.0 endpoint (/mcp) protected by auth

package/_www/mcp-export.html CHANGED Viewed

@@ -19,17 +19,10 @@
 	</style>
 </head>
 <body>
-	<nav style="display:flex;gap:10px;align-items:center;margin-bottom:8px">
-		<a href="/mcp-test.html">MCP Test</a>
-		<a href="/mcp-export.html">MCP Export</a>
-		<span style="margin-left:auto"></span>
-		<a href="/privacy" target="privacy_win" rel="noopener">Privacy</a>
-		<a href="/terms" target="terms_win" rel="noopener">Terms</a>
-	</nav>
+    <div id="mcp-nav"></div>
+    <script src="/JsonObjectEditor/_www/mcp-nav.js"></script>
 	<h1>JOE MCP → Assistant Config Export</h1>
-	<div class="small">Generate copy/paste config for Custom GPT Actions (OpenAPI) and Assistants (tools array).</div>
-	<pre id="instanceInfo" class="small">Loading instance info…</pre>
+    <div class="small">Generate copy/paste config for Custom GPT Actions (OpenAPI) and Assistants (tools array).</div>
 	<div class="grid">
 		<section>
@@ -177,9 +170,7 @@
       const url = base.value.replace(/\/$/,'') + manifestPath.value;
       const manifest = await fetchJSON(url);
-      if (manifest.joe){
-        $('instanceInfo').textContent = `Name: ${manifest.joe.name}\nVersion: ${manifest.joe.version}\nHost: ${manifest.joe.hostname}`;
-      }
+      // Instance info handled by shared nav script
       manifestOut.style.display='block';
       manifestOut.textContent = JSON.stringify(manifest, null, 2);
@@ -189,22 +180,24 @@
       const openapi = buildOpenAPI(manifest, base.value);
       openapiEl.value = JSON.stringify(openapi, null, 2);
-      // Starter prompt
+      // Starter prompt (concise)
       const joeName = (manifest.joe && manifest.joe.name) || 'JOE';
       const starter = [
         `You are a data assistant for ${joeName} (JOE). Use only the provided tools.`,
         '',
-        'Workflow:',
-        '1) hydrate {} to see core field definitions, schemas, statuses, tags.',
-        '2) listSchemas {} and getSchema { "name": "<schema>" } for field shapes.',
-        '3) search { "query": { "itemtype": "<schema>" }, "limit": 10 } (cache).',
-        '   Use { "source": "storage" } when results must be authoritative.',
-        '4) getObject { "_id": "<id>", "schema": "<schema>" } for a single item.',
-        '5) saveObject only on explicit user request; reflect changes and confirm first.',
+        'Autonomy:',
+        '- Act autonomously; if a tool can answer, call it immediately (no permission prompts).',
+        '- Do not offer multiple-choice options; pick the best action.',
+        '- Ask one brief clarification only if a required parameter is missing.',
+        '- On a new session: call hydrate {} first, then proceed.',
+        '- Keep results scoped (limit 10–25). Flatten is optional and off by default; enable only when needed.',
+        '- Never expose secrets/tokens. Confirm with the user before saveObject.',
         '',
-        'Defaults:',
-        '- search: cache by default; keep limits small (10–25).',
-        '- flatten is optional and off by default; enable only if you need expanded refs.',
+        'Typical flow:',
+        '- listSchemas {}, getSchema { "name": "<schema>" }',
+        '- search { "query": { "itemtype": "<schema>" }, "limit": 10 } (cache) or { "source": "storage" } when authoritative results are needed',
+        '- getObject { "_id": "<id>", "schema": "<schema>" } for a single item',
+        '- saveObject { "object": { ... } } only on explicit user request',
         '',
         'Examples:',
         '- listSchemas {}',

package/_www/mcp-nav.js ADDED Viewed

@@ -0,0 +1,42 @@
+;(function(){
+  function buildNav(){
+    var nav = document.createElement('nav');
+    nav.setAttribute('style','display:flex;gap:10px;align-items:center;margin-bottom:8px');
+    nav.innerHTML = [
+      '<a href="/mcp-test.html" target="mcp_test_win" rel="noopener">MCP Test</a>',
+      '<a href="/mcp-export.html" target="mcp_export_win" rel="noopener">MCP Export</a>',
+      '<a href="/mcp-prompt.html" target="mcp_prompt_win" rel="noopener">MCP Prompt</a>',
+      '<span style="margin-left:auto"></span>',
+      '<span id="mcp-nav-info" class="small" style="opacity:.8;margin-right:10px"></span>',
+      '<a href="/privacy" target="privacy_win" rel="noopener">Privacy</a>',
+      '<a href="/terms" target="terms_win" rel="noopener">Terms</a>'
+    ].join('');
+    return nav;
+  }
+  function insert(){
+    var placeholder = document.getElementById('mcp-nav');
+    var nav = buildNav();
+    if(placeholder){
+      placeholder.parentNode.replaceChild(nav, placeholder);
+    }else{
+      document.body.insertBefore(nav, document.body.firstChild);
+    }
+  }
+  async function updateInstance(){
+    try{
+      var res = await fetch('/.well-known/mcp/manifest.json');
+      if(!res.ok) return;
+      var m = await res.json();
+      var info = document.getElementById('mcp-nav-info');
+      if(info && m && m.joe){
+        info.textContent = 'Name: '+(m.joe.name||'JOE')+' | Version: '+(m.joe.version||'')+' | Host: '+(m.joe.hostname||'');
+      }
+    }catch(e){}
+  }
+  if(document.readyState === 'loading'){
+    document.addEventListener('DOMContentLoaded', insert);
+    document.addEventListener('DOMContentLoaded', updateInstance);
+  }else{ insert(); updateInstance(); }
+})();

package/_www/mcp-prompt.html ADDED Viewed

@@ -0,0 +1,29 @@
+<!doctype html>
+<html>
+<head>
+    <meta charset="utf-8">
+    <title>JOE MCP Prompt</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;}
+        textarea{width:100%;height:360px;font-family:ui-monospace,Menlo,Consolas,monospace}
+        .small{font-size:12px;color:#666}
+    </style>
+    </head>
+<body>
+    <div id="mcp-nav"></div>
+    <script src="/JsonObjectEditor/_www/mcp-nav.js"></script>
+    <h1>Starter Agent Instructions</h1>
+    <div class="small">Copy into your Custom GPT or Assistant system prompt. Adjust as needed.</div>
+    <textarea readonly id="prompt"></textarea>
+    <script>
+    (function(){
+        const text = [
+`You are a data assistant for JOE. Use only the provided tools.\n\nAutonomy:\n- Act autonomously; if a tool can answer, call it immediately (no permission prompts).\n- Do not offer multiple-choice options; pick the best action.\n- Ask one brief clarification only if a required parameter is missing.\n- On a new session: call hydrate {} first, then proceed.\n- Keep results scoped (limit 10–25). Flatten is optional and off by default; enable only when needed.\n- Never expose secrets/tokens. Confirm with the user before saveObject.\n\nTypical flow:\n- listSchemas {}, getSchema { "name": "<schema>" }\n- search { "query": { "itemtype": "<schema>" }, "limit": 10 } (cache) or { "source": "storage" } for authoritative results\n- getObject { "_id": "<id>", "schema": "<schema>" }\n- saveObject { "object": { ... } } only on explicit user request\n\nExamples:\n- listSchemas {}\n- getSchema { "name": "client" }\n- search { "schema": "client", "source": "storage", "query": { "status": "active" }, "limit": 10 }\n- getObject { "_id": "123", "schema": "client" }`
+        ].join('\n');
+        document.getElementById('prompt').value = text;
+    })();
+    </script>
+</body>
+</html>

package/_www/mcp-test.html CHANGED Viewed

@@ -17,16 +17,10 @@
 	</style>
 </head>
 <body>
-    <nav style="display:flex;gap:10px;align-items:center;margin-bottom:8px">
-        <a href="/mcp-test.html">MCP Test</a>
-        <a href="/mcp-export.html">MCP Export</a>
-        <span style="margin-left:auto"></span>
-        <a href="/privacy" target="privacy_win" rel="noopener">Privacy</a>
-        <a href="/terms" target="terms_win" rel="noopener">Terms</a>
-    </nav>
+    <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>
-    <pre id="instanceInfo" class="small">Loading instance info…</pre>
 	<h3>Manifest</h3>
 	<div class="row">
@@ -90,10 +84,7 @@
 			try{
 				const url = base.value.replace(/\/$/,'') + '/.well-known/mcp/manifest.json';
 				manifest = await fetchJSON(url);
-                // Instance info
-                if (manifest.joe){
-                    $('instanceInfo').textContent = `Name: ${manifest.joe.name} | Version: ${manifest.joe.version} | Host: ${manifest.joe.hostname}`;
-                }
+                // Instance info handled by shared nav script
                 (manifest.tools||[]).forEach(t=>{
 					const opt=document.createElement('option');
 					opt.value=t.name; opt.textContent=t.name;

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "json-object-editor",
-  "version": "0.10.504",
+  "version": "0.10.506",
   "description": "JOE the Json Object Editor | Platform Edition",
   "main": "app.js",
   "scripts": {

package/server/modules/MCP.js CHANGED Viewed

@@ -91,7 +91,7 @@ MCP.tools = {
   */
   // Unified search: defaults to cache; set source="storage" to query DB for a schema
-  search: async ({ schema, query = {}, ids, source = 'cache', limit = 50, flatten = false, depth = 1 }, _ctx) => {
+  search: async ({ schema, query = {}, ids, source = 'cache', limit = 50, flatten = false, depth = 1, countOnly = false }, _ctx) => {
     const useCache = !source || source === 'cache';
     const useStorage = source === 'storage';
@@ -113,6 +113,9 @@ MCP.tools = {
       if (flatten && JOE && JOE.Utils && JOE.Utils.flattenObject) {
         try { items = ids.map(id => JOE.Utils.flattenObject(id, { recursive: true, depth })); } catch (e) {}
       }
+      if (countOnly) {
+        return { count: (items || []).length };
+      }
       const sliced = (typeof limit === 'number' && limit > 0) ? items.slice(0, limit) : items;
       return { items: sanitizeItems(sliced) };
     }
@@ -122,6 +125,9 @@ MCP.tools = {
       if (!JOE || !JOE.Cache || !JOE.Cache.search) throw new Error('Cache not initialized');
       let results = JOE.Cache.search(query || {});
       if (schema) results = (results || []).filter(i => i && i.itemtype === schema);
+      if (countOnly) {
+        return { count: (results || []).length };
+      }
       const sliced = (typeof limit === 'number' && limit > 0) ? results.slice(0, limit) : results;
       return { items: sanitizeItems(sliced) };
     }
@@ -129,6 +135,9 @@ MCP.tools = {
     if (useStorage) {
       if (!schema) throw new Error("'schema' is required when source=storage");
       const results = await loadFromStorage(schema, query || {});
+      if (countOnly) {
+        return { count: (results || []).length };
+      }
       const sliced = (typeof limit === 'number' && limit > 0) ? (results || []).slice(0, limit) : (results || []);
       if (flatten && JOE && JOE.Utils && JOE.Utils.flattenObject) {
         try { return { items: sanitizeItems(sliced.map(it => JOE.Utils.flattenObject(it && it._id, { recursive: true, depth }))) }; } catch (e) {}
@@ -225,7 +234,8 @@ MCP.params = {
       source: { type: "string", enum: ["cache","storage"] },
       limit: { type: "integer" },
       flatten: { type: "boolean" },
-      depth: { type: "integer" }
+      depth: { type: "integer" },
+      countOnly: { type: "boolean" }
     },
     required: []
   },
@@ -255,6 +265,7 @@ MCP.returns = {
       items: { type: "array", items: { type: "object" } }
     }
   },
+  // When countOnly is true, search returns { count }
   saveObject: { type: "object" },
   hydrate: { type: "object" }
 };

package/server/modules/Server.js CHANGED Viewed

@@ -114,6 +114,8 @@ server.get(['/privacy','/privacy-policy'],function(req,res){
 <!doctype html>
 <html><head><meta charset="utf-8"><title>Privacy Policy - ${name}</title></head>
 <body style="font-family:system-ui,Segoe UI,Roboto,Arial,sans-serif;padding:20px;max-width:900px;line-height:1.6">
+  <div id="mcp-nav"></div>
+  <script src="${JOE.webconfig.joepath}_www/mcp-nav.js"></script>
   <h1>Privacy Policy for JOE MCP Interface</h1>
   <p><em>Last updated: ${updated}</em></p>
   <h3>Data Processed</h3>
@@ -139,6 +141,8 @@ server.get(['/terms','/terms-of-service'],function(req,res){
 <!doctype html>
 <html><head><meta charset="utf-8"><title>Terms of Service - ${name}</title></head>
 <body style="font-family:system-ui,Segoe UI,Roboto,Arial,sans-serif;padding:20px;max-width:900px;line-height:1.6">
+  <div id="mcp-nav"></div>
+  <script src="${JOE.webconfig.joepath}_www/mcp-nav.js"></script>
   <h1>Terms of Service for JOE MCP Interface</h1>
   <p><em>Last updated: ${updated}</em></p>
   <p>Use of this interface implies consent to log and process structured data requests for schema and object retrieval purposes. Access is governed by your JOE configuration and authentication. Do not submit sensitive data unless you are authorized to do so.</p>