json-object-editor 0.10.520 → 0.10.521

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.10.521
+- MCP
+  - Added `saveObjects` batch save tool (bounded concurrency, stopOnError). Updated MCP Test preset and Export starter instructions.
+  
 ## 0.10.520
 - added mcp schemas page
 - summarized core schemas
@@ -20,6 +24,8 @@
   - MCP Prompt now loads system instructions from `docs/joe_agent_custom_gpt_instructions_v_2.md`
   - Added docs: `joe_agent_spec_v_2.2.md`, `schema_summary_guidelines.md`
 
+
+
 - Summaries added/refined
   - Sitebuilder: `site`, `page`, `layout`, `block`, `include`, `post`
   - Finance: `transaction`, `ledger`, `financial_account`, `budget` (additive clarified)

package/_www/mcp-export.html

@@ -197,19 +197,20 @@
         '- 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.',
+        '- Never expose secrets/tokens. Confirm with the user before saveObject/saveObjects.',
         '',
         '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',
+        '- saveObject { "object": { ... } } or saveObjects { "objects": [ ... ], "concurrency": 5 } only on explicit user request',
         '',
         'Examples:',
         '- listSchemas {}',
         '- getSchema { "name": "client" }',
         '- search { "schema": "client", "source": "storage", "query": { "status": "active" }, "limit": 10 }',
-        '- getObject { "_id": "123", "schema": "client" }'
+        '- getObject { "_id": "123", "schema": "client" }',
+        '- saveObjects { "objects": [{ "itemtype":"client", "name":"Batch A" }], "stopOnError": false, "concurrency": 5 }'
       ].join('\n');
       $('starter').value = starter;
 

package/_www/mcp-nav.js

@@ -1,17 +1,20 @@
 ;(function(){
   function buildNav(){
     var nav = document.createElement('nav');
-    nav.setAttribute('style','display:flex;gap:10px;align-items:center;margin-bottom:8px');
-    nav.innerHTML = [
+    nav.setAttribute('style','display:flex;flex-direction:column;gap:6px;margin-bottom:8px');
+    var infoRow = '<div id="mcp-nav-info" class="small" style="opacity:.8"></div>';
+    var linksRow = [
+      '<div style="display:flex;gap:10px;align-items:center">',
       '<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-schemas.html" target="mcp_schemas_win" rel="noopener">Schemas</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>'
+      '<a href="/terms" target="terms_win" rel="noopener">Terms</a>',
+      '</div>'
     ].join('');
+    nav.innerHTML = infoRow + linksRow;
     return nav;
   }
   function insert(){

package/_www/mcp-test.html

@@ -44,6 +44,7 @@
 		<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>
 	</div>
 	
 	<h3>Call JSON-RPC</h3>
@@ -75,6 +76,7 @@
 		const presetSearchSlimRecent = $('presetSearchSlimRecent');
 		const presetSearchWithCount = $('presetSearchWithCount');
 		const presetSearchCountOnly = $('presetSearchCountOnly');
+		const presetSaveObjects = $('presetSaveObjects');
 		
 		// Try to infer base from window location
 		base.value = base.value || (location.origin);
@@ -203,6 +205,20 @@
 			renderToolInfo();
 			params.value = JSON.stringify({ schema: '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);
+		};
 		
 		callBtn.onclick = async function(){
 			setStatus(callStatus, 'Calling...', null);

package/package.json

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

package/readme.md

@@ -1,470 +1,526 @@
-<img src="http://joe.craydent.com/JsonObjectEditor/img/svgs/joe_banner_o.svg"/>
-
-# Json Object Editor
-JOE is software that allows you to manage data models via JSON objects. There are two flavors, the client-side version and nodejs server platform.
-
-
-
-## Architecture & Mental Model (Server)
-
-- Global JOE
-  - Created in `server/init.js`; exposes subsystems like `JOE.Utils`, `JOE.Schemas`, `JOE.Storage`, `JOE.Mongo`/`JOE.MySQL`, `JOE.Cache`, `JOE.Apps`, `JOE.Server` (Express), `JOE.Sites`, `JOE.io` (Socket), and `JOE.auth`.
-- Init pattern
-  - Modules can optionally export `init()`; `init.js` loads/watches modules and calls `init()` after `JOE.Server` is ready. This enables hot-reload and keeps `Server.js` thin.
-- Schemas & events
-  - `JOE.Schemas` loads from `server/schemas/` and app schema dir into `JOE.Schemas.schema` with names in `JOE.Schemas.schemaList`. Raw copies live in `JOE.Schemas.raw_schemas` for event hooks.
-  - `JOE.Storage.save()` triggers schema events (`create`, `save`, `status`, `delete`) via `JOE.Schemas.events()` and writes history documents to `_history`.
-- Storage & cache
-  - `JOE.Storage.load(collection, query, cb)` chooses backend per schema `storage.type` (`mongo`, `mysql`, `file`, `api`), with Mongo/file fallback.
-  - `JOE.Storage.save(item, collection, cb, { user, history })` emits `item_updated` to sockets, records history, and fires events.
-  - `JOE.Cache.update(cb, collections)` populates `JOE.Data`, flattens a `list`, and builds `lookup`. Use `JOE.Cache.findByID(collection, idOrCsv)` for fast lookups; `JOE.Cache.search(query)` for in-memory filtering.
-- Auth
-  - `JOE.auth` middleware checks cookie token or Basic Auth; many API routes (and `/mcp`) are protected.
-- Shorthand `$J`
-  - Server and client convenience: `$J.get(_id)`, `$J.search(query)`, `$J.schema(name)`.
-  - On server, provided by `server/modules/UniversalShorthand.js` and assigned to `global.$J` in `init.js`.
-- MCP overview
-  - Manifest: `/.well-known/mcp/manifest.json`; JSON-RPC: `POST /mcp` (auth-protected). Tools map to real JOE APIs (`Schemas`, `Storage`, `Cache`) and sanitize sensitive fields.
-
-## MCP routes and local testing
-
-- Endpoints
-  - Manifest (public): `GET /.well-known/mcp/manifest.json`
-  - JSON-RPC (auth): `POST /mcp`
-  - Privacy (public): `/privacy` (uses Setting `PRIVACY_CONTACT` for contact email)
-  - Terms (public): `/terms`
-
-- Auth
-  - If users exist, `POST /mcp` requires cookie or Basic Auth (same as other APIs). If no users configured, it is effectively open.
-
-- Test page
-  - JOE ships a simple tester at `/_www/mcp-test.html` inside the package.
-  - Access via JOE path: `http://localhost:<PORT>/JsonObjectEditor/_www/mcp-test.html`
-  - If your host app serves its own `_www`, the tester can also be available at the root (fallback) if running with the updated server that mounts JOE’s `_www` as a secondary static directory. Then: `http://localhost:<PORT>/mcp-test.html`
-
-- Tools
-  - `listSchemas(name?)`, `getSchema(name)`
-  - `getObject(_id, schema?)` (supports optional `flatten` and `depth`)
-  - `search` (exact): unified tool for cache and storage
-    - Params: `{ schema?, query?, ids?, source?: 'cache'|'storage', limit?, flatten?, depth? }`
-    - Defaults to cache across all collections; add `schema` to filter; set `source:"storage"` to query a specific schema in the DB. Use `fuzzySearch` for typo-tolerant free text.
-  - `fuzzySearch` (typo-tolerant free text across weighted fields)
-    - Params: `{ schema?, q, filters?, fields?, threshold?, limit?, offset?, highlight?, minQueryLength? }`
-    - Defaults: `fields` resolved from schema `searchables` (plural) if present; otherwise weights `name:0.6, info:0.3, description:0.1`. `threshold:0.5`, `limit:50`, `minQueryLength:2`.
-    - Returns: `{ items, count }`. Each item may include `_score` (0..1) and `_matches` when `highlight` is true.
-  - `saveObject({ object })`
-
-- Quick tests (PowerShell)
-  - Prepare headers if using Basic Auth:
-    ```powershell
-    $pair = "user:pass"; $b64 = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes($pair))
-    $h = @{ Authorization = "Basic $b64"; "Content-Type" = "application/json" }
-    $base = "http://localhost:<PORT>"
-    ```
-  - Manifest:
-    ```powershell
-    Invoke-RestMethod "$base/.well-known/mcp/manifest.json"
-    ```
-  - listSchemas:
-    ```powershell
-    $body = @{ jsonrpc="2.0"; id="1"; method="listSchemas"; params=@{} } | ConvertTo-Json -Depth 6
-    Invoke-RestMethod -Method Post -Uri "$base/mcp" -Headers $h -Body $body
-    ```
-  - getSchema:
-    ```powershell
-    $body = @{ jsonrpc="2.0"; id="2"; method="getSchema"; params=@{ name="<schemaName>" } } | ConvertTo-Json -Depth 6
-    Invoke-RestMethod -Method Post -Uri "$base/mcp" -Headers $h -Body $body
-    ```
-  - search (cache default):
-    ```powershell
-    $body = @{ jsonrpc="2.0"; id="3"; method="search"; params=@{ query=@{ itemtype="<schemaName>" }; limit=10 } } | ConvertTo-Json -Depth 10
-    Invoke-RestMethod -Method Post -Uri "$base/mcp" -Headers $h -Body $body
-    ```
-  - fuzzySearch (cache):
-    ```powershell
-    $body = @{ jsonrpc="2.0"; id="6"; method="fuzzySearch"; params=@{ schema="<schemaName>"; q="st paal"; threshold=0.35; limit=10 } } | ConvertTo-Json -Depth 10
-    Invoke-RestMethod -Method Post -Uri "$base/mcp" -Headers $h -Body $body
-    ```
-  - search (storage):
-    ```powershell
-    $body = @{ jsonrpc="2.0"; id="4"; method="search"; params=@{ schema="<schemaName>"; source="storage"; query=@{ }; limit=10 } } | ConvertTo-Json -Depth 10
-    Invoke-RestMethod -Method Post -Uri "$base/mcp" -Headers $h -Body $body
-    ```
-  - search (ids + flatten):
-    ```powershell
-    $body = @{ jsonrpc="2.0"; id="5"; method="search"; params=@{ schema="<schemaName>"; ids=@("<id1>","<id2>"); flatten=$true; depth=2 } } | ConvertTo-Json -Depth 10
-    Invoke-RestMethod -Method Post -Uri "$base/mcp" -Headers $h -Body $body
-    ```
-  - saveObject:
-    ```powershell
-    $object = @{ itemtype="<schemaName>"; name="Test via MCP" }
-    $body = @{ jsonrpc="2.0"; id="4"; method="saveObject"; params=@{ object=$object } } | ConvertTo-Json -Depth 10
-    Invoke-RestMethod -Method Post -Uri "$base/mcp" -Headers $h -Body $body
-    ```
-
-- Quick tests (curl)
-  - Manifest:
-    ```bash
-    curl -s http://localhost:<PORT>/.well-known/mcp/manifest.json | jq
-    ```
-  - listSchemas:
-  - search (cache):
-    ```bash
-    curl -s -X POST http://localhost:<PORT>/mcp \
-      -H 'Content-Type: application/json' \
-      -d '{"jsonrpc":"2.0","id":"3","method":"search","params":{"query":{"itemtype":"<schemaName>"},"limit":10}}' | jq
-    ```
-  - fuzzySearch:
-    ```bash
-    curl -s -X POST http://localhost:<PORT>/mcp \
-      -H 'Content-Type: application/json' \
-      -d '{"jsonrpc":"2.0","id":"6","method":"fuzzySearch","params":{"schema":"<schemaName>","q":"st paal","threshold":0.35,"limit":10}}' | jq
-    ```
-  - search (storage):
-    ```bash
-    curl -s -X POST http://localhost:<PORT>/mcp \
-      -H 'Content-Type: application/json' \
-      -d '{"jsonrpc":"2.0","id":"4","method":"search","params":{"schema":"<schemaName>","source":"storage","query":{},"limit":10}}' | jq
-    ```
-    ```bash
-    curl -s -X POST http://localhost:<PORT>/mcp \
-      -H 'Content-Type: application/json' \
-      -d '{"jsonrpc":"2.0","id":"1","method":"listSchemas","params":{}}' | jq
-    ```
-
-- Troubleshooting
-  - If you see a payload like `{ originalURL: "/...", site: "no site found" }`, the request hit the Sites catch-all. Ensure MCP routes are initialized before Sites (handled by default in `server/init.js` via `MCP.init()`), and use the correct URL: `/.well-known/mcp/manifest.json` or `/mcp`.
-  - To update contact email on /privacy and /terms, set Setting `PRIVACY_CONTACT`.
-
-## SERVER/PLATFORM mode
-	check port 2099
-	/JOE/
-	/JsonObjectEditor/docs.html
-	*Should auto-open on start
-
-Json Object Editor (Universal-esque software)
-(requires connection to a mongo server for full functionality)
-
-
-
-### JOE server instantiation (add to entry point js file)
-	var joe = require('json-object-editor');
-	or here's a custom example
-	var joe = require('json-object-editor')({
-		name:'name_your_joe' (JOE),
-    	joedb:'local_custom_database_name' // {{mongoURL}}' if using mongolab or remote mongodb,
-    	port:'4099', (2099)
-    	socketPort:'4098', (2098)
-    	sitesPort:'4100' (2100),
-		clusters:1,
-		hostname:'server name if not localhost'(localhost)
-	});
-
-## $J (universal) Shorthand JOE
-	$J to access helper funtions on client and server. (callbacks are optional)
-	$J.get(itemId,[callback])
-	$J.schema(schemaname,[callback])
-
-# Client-Side (front end only)
-
-## js client only instantiation
-	var specs = {
-		fields:{
-			species:{label:'Species',type:'select', values:['cat','dog','rat','thing'], onchange:adjustSchema},
-			gender:{type:'select', values:['male','female']},
-			legs:{label:'# of Legs',type:'int', onblur:logit},
-			weight:{label:' Weight (lbs)',type:'number', onblur:logit},
-			name:{label:' pet Name', onkeyup:logValue},
-			//id:{label:'ID',type:'text', locked:true},
-			id:{label:'ID',type:'guid'},
-			
-		//example of select that takes function (function is passed item)	
-			animalLink:{label:'Link to other animal',type:'select', values:getAnimals},
-			hiddenizer:{hidden:true}
-		},
-		schemas:{
-			animal:animalschema,
-			thing:thingschema			
-		},
-		container:string ('body'),
-        compact:false,
-        useBackButton:true,
-		autosave:2000,
-        listSubMenu:{filters:{}},
-        useHashlink:true,
-        title:'${itemtype} | ${display}'
-	}
-	var JOE = new JsonObjectEditor(specs);
-	JOE.init();
-
-##JOE CONFIG
-##specs
-- useBackButton:[false] if true, back button moves through joe panels when joe has history to go to (is open).
-- useHashlink:[false], true or a template for hashlinks. 
-    default template is '${schema_name}_${_id}'
-	default server tempalte is '${schema_name}/${_id}'
-##SCHEMA CONFIG
-###fields
-Properties for all Fields
-
-- `label / display`: what the field should display as
-    *If the field type is boolean, label controls checkbox/boolean label
-- `value`: default value if not one in object
-- `default`: default value for field || function(object)
-- `type`: what type of field should JOE show
-- `hidden`: boolean / function, value will be added (but unsees by user)
-- `locked`: boolean
-- `condition`: boolean
-- `width`: used for layout control.
-	- can use pixels or percentages (as string)
-- `comment`: a commentthat shows up at the beginning of the field
-- `tooltip`: hover/clickable tooltip that shows up next to name
-
-**field types:**
-
-- `rendering`: for css html and js
-- `text`: default single line text.
-	- autocomplete: boolean // obj of specs (template, idprop)
-		- values:array of possibilities
-	-maxlength:string
-- `int`: integer field
-- `number`: number (float) field
-- `select`: select list. 
-	- multiple(bool)
-	- values(array of objects, [{value:"",name/display:""]), can be a function
-		- disabled:boolean(func acceptable)
-	- idprop: string of prop name
-- `geo`: shows a map
-	- *takes a string array "[lat,lon]"*
-	- center:[lat,lon], center of map
-	- zoom: zoom level (higher zooms in more)
-	- returns "[lat,lon]"
--`image` : shows an image and HxW as th image url is typed in.
-- `multisorter` : allows arrays of objects to be selected and sorted in right bin.
-	- values(array of objects, [{value:"",name/display:""]), can be a function
-- `content` : show content on in the editor
-    - run: function to be run(current_object,field_properties)
-    - template: html template for fillTemplate(template,current_object);
-- `objectlist` : a table of objects with editable properties
-    - properties: array of objects|strings for the object property names
-        -name: value in object
-        -display: header in objectList
-    - max: integer, number or items that can be added. use zero for infinite.
-    - hideHeadings: don't show table headings
-- `objectReference` : a list of object ids
-    - template
-    - autocomplete_template
-    - idprop
-    - values
-    - max(0 unlimited)
-    - sortable(true)
-- `code` :
-	- language
-	
-- `boolean`:
-	- label:controls checkbox label
-- `preview` :
-	-content: string or function(current joe object) to replace everything on page (template).
-	-bodycontent: same as content, only replaces body content.
-	-url: preview page if not the default one.
-	- encoded: boolean, if pre uriencoded
-**labels:**
-
-- pass an object instead of a string to the fields array.
-
-
-    {label:'Name of the following properties section'}
-
-##page sections
-    {section_start: 'SectionName',
-       section_label:'Section Name with Labels',
-       condition:function(item){
-           return item.show;}
-    },
-    {section_end: 'CreativeBrief'}
-
-- pass an object instead of a string to the fields array. these show up on the details view as anchors.
-
-
-- Object Properties
-    - `section_start`: name/id of section
-    - `'section_label`:use instead of section_start for display name
-    - `section_end`: name/id of section(str)
-    - template: html template for fillTemplate(template,current_object);
-    
-##page sidebar
-    {sidebar_start: 'SectionName',
-       sidebar_label:'Section Name with Labels',
-       condition:function(item){
-           return item.show;}
-    },
-    {sidebar_end: 'CreativeBrief'}
-
-- pass an object instead of a string to the fields array. these show up on the details view as anchors.
-
-
-- Object Properties
-    - `sidebar_start`: name/id of sidebar
-    - `sidebar_label`:use instead of sidebar_start for display name
-    - `sidebar_end`: name/id of sidebar(str)
-    - template: html template for fillTemplate(template,current_object);
-    
-###defaultProfile
-overwrites the default profile
-
-#schemas 
-
-a list of schema objects that can configure the editor fields, these can be given properties that are delegated to all the corresponding fields.
-
-	var animalschema = 
-	{
-		title:'Animal', *what shows as the panel header* 
-		fields:['id','name','legs','species','weight','color','gender','animalLink'], *list of visible fields*
-		_listID:'id', *the id for finding the object*
-		_listTitle:'${name} ${species}', *how to display items in the list*
-		menu:[array of menu buttons],
-		listMenuTitle: (string) template forjoe window title in list view,
-		listmenu:[array of menu buttons] (multi-edit and select all always show),
-		/*callback:function(obj){
-			alert(obj.name);
-		},*/
-		onblur:logit,
-		
-		hideNumbers:boolean *toggle list numbers*
-		multipleCallback:function to be called after a multi-edit. passed list of edited items.
-		onUpdate: callback for after update. passed single edited items.
-		onMultipleUpdate:callback for after multi update.passed list of edited items.
-                filters: array of objects
-		checkChanges:(bool) whether or not to check for changes via interval and on leave
-	}
-##Table View
-	- add tableView object to a schema;
-	-cols = [strings||objects]
-		-string is the name and value
-		-display/header is the column title
-		-property/name = object property 
-###Pre-formating
-you can preformat at the joe call or schema level. The data item will be affected by the passed function (which should return the preformated item). 
-
-##menu##
-an array of menu buttons
-
-    //the default save button
-    //this is the dom object, 
-    //use _joe.current.object for current object
-    condition:function(field,object) to call
-    self = Joe object
-    var __saveBtn__ = {name:'save',label:'Save', action:'_joe.updateObject(this);', css:'joe-save-button'};
-
-##itemMenu##
-as array of buttons for each item in list views
-	- name
-	- action (action string)
-	- url (instead of js action)
-	- condition
-
-##itemExpander##
-template or run for content to be shown under the main list item block.
-
-
-###Addition properties
-**Changing the schema on the fly?**
-
-	_joe.resetSchema(new schema name);
-
-
-
-**css (included) options**
-
-- joe-left-button
-- joe-right-button
-
-##FIELDS
-
-    {extend:'name',specs:{display:'Request Title'}},//extends the field 'name' with the specs provided.
-##usage
-### a | adding a new object
-
-	_joe.show({},{schema:'animal',callback:addAnimal); 
-	//or goJoe(object,specs)
-
-	...
-	function addAnimal(obj){
-		animals.push(obj);
-	}
-
-### b | viewing a list of objects
-
-	goJoe([array of objects],specs:{schema,subsets,subset})
-	goJoe.show(animals,{schema:'animal',subsets:[{name:'Two-Legged',filter:{legs:2}}]});
-	//use the specs property subset to pre-select a subset by name
-
-**properties**
-
-- _listWindowTitle: the title of the window (can be passed in with the schema);
-- _listCount: added to the current object and can be used in the title.
-- _listTitle:'${name} ${species}', *how to display items in the list*
-- _icon: [str] template for a list item icon (standard min 50x50), 'http://www.icons.com/${itemname}', can be obj with width, height, url 
-- listSubMenu:a function or object that represents the list submenu
-- stripeColor:string or function that returns valid css color descriptor.
-- bgColor:string or function that returns valid css color descriptor.
-- subsets: name:string, filter:object 
-- subMenu:a function or object that represents the single item submenu
-
-- _listTemplate: html template that uses ${var} to write out the item properties for the list item.
-	- standard css class `joe-panel-content-option`
-
-
-###c | Conditional select that changes the item schema
-
-	fields:{
-		species:{label:'Species',type:'select', values:['cat','dog','rat','thing'], onchange:adjustSchema},
-		[field_id]:{
-			
-			+label : STR
-			+type : STR
-			value : STR (default value)
-			+values : ARRAY/FUNC (for select)
-			
-			//modifiers
-			+hidden:BOOL/STRING(name of field that toggles this) //don't show, but value is passed
-			+locked:BOOL // show, but uneditable
-			//events
-			+onchange : FUNC
-			+onblur : FUNC
-			+onkeypress : FUNC
-			+rerender : STRING // name of field to rerender
-		}
-	}
-
-	function adjustSchema(dom){
-		var species = $(dom).val();
-		if(species == "thing"){
-			JOE.resetSchema('thing')
-		}
-		else{
-			JOE.resetSchema('animal')
-		
-		}
-	}
-
-###d | duplicating an item
-
-	//duplicates the currently active object (being edited)
-	_joe.duplicateObject(specs);
-
-**specs**
-
-- `deletes`:array of properties to clear for new item
-	- note that you will need to delete guid/id fields or the id will be the same.	
-
-
-
-### e | exporting an object in pretty format json (or minified)
-JOE.exportJSON = function(object,objvarname,minify)
-
-##Useful Functions
-_joe.reload(hideMessage,specs)
-- use specs.overwreite object to extend reloaded object.
-
+<img src="http://joe.craydent.com/JsonObjectEditor/img/svgs/joe_banner_o.svg"/>
+
+# Json Object Editor
+JOE is software that allows you to manage data models via JSON objects. There are two flavors, the client-side version and nodejs server platform.
+
+
+
+## Architecture & Mental Model (Server)
+
+- Global JOE
+  - Created in `server/init.js`; exposes subsystems like `JOE.Utils`, `JOE.Schemas`, `JOE.Storage`, `JOE.Mongo`/`JOE.MySQL`, `JOE.Cache`, `JOE.Apps`, `JOE.Server` (Express), `JOE.Sites`, `JOE.io` (Socket), and `JOE.auth`.
+- Init pattern
+  - Modules can optionally export `init()`; `init.js` loads/watches modules and calls `init()` after `JOE.Server` is ready. This enables hot-reload and keeps `Server.js` thin.
+- Schemas & events
+  - `JOE.Schemas` loads from `server/schemas/` and app schema dir into `JOE.Schemas.schema` with names in `JOE.Schemas.schemaList`. Raw copies live in `JOE.Schemas.raw_schemas` for event hooks.
+  - `JOE.Storage.save()` triggers schema events (`create`, `save`, `status`, `delete`) via `JOE.Schemas.events()` and writes history documents to `_history`.
+- Storage & cache
+  - `JOE.Storage.load(collection, query, cb)` chooses backend per schema `storage.type` (`mongo`, `mysql`, `file`, `api`), with Mongo/file fallback.
+  - `JOE.Storage.save(item, collection, cb, { user, history })` emits `item_updated` to sockets, records history, and fires events.
+  - `JOE.Cache.update(cb, collections)` populates `JOE.Data`, flattens a `list`, and builds `lookup`. Use `JOE.Cache.findByID(collection, idOrCsv)` for fast lookups; `JOE.Cache.search(query)` for in-memory filtering.
+- Auth
+  - `JOE.auth` middleware checks cookie token or Basic Auth; many API routes (and `/mcp`) are protected.
+- Shorthand `$J`
+  - Server and client convenience: `$J.get(_id)`, `$J.search(query)`, `$J.schema(name)`.
+  - On server, provided by `server/modules/UniversalShorthand.js` and assigned to `global.$J` in `init.js`.
+- MCP overview
+  - Manifest: `/.well-known/mcp/manifest.json`; JSON-RPC: `POST /mcp` (auth-protected). Tools map to real JOE APIs (`Schemas`, `Storage`, `Cache`) and sanitize sensitive fields.
+
+## MCP routes and local testing
+
+- Endpoints
+  - Manifest (public): `GET /.well-known/mcp/manifest.json`
+  - JSON-RPC (auth): `POST /mcp`
+  - Privacy (public): `/privacy` (uses Setting `PRIVACY_CONTACT` for contact email)
+  - Terms (public): `/terms`
+
+- Auth
+  - If users exist, `POST /mcp` requires cookie or Basic Auth (same as other APIs). If no users configured, it is effectively open.
+
+- Test page
+  - JOE ships a simple tester at `/_www/mcp-test.html` inside the package.
+  - Access via JOE path: `http://localhost:<PORT>/JsonObjectEditor/_www/mcp-test.html`
+  - If your host app serves its own `_www`, the tester can also be available at the root (fallback) if running with the updated server that mounts JOE’s `_www` as a secondary static directory. Then: `http://localhost:<PORT>/mcp-test.html`
+
+- Tools
+  - `listSchemas(name?)`, `getSchema(name)`
+  - `getObject(_id, schema?)` (supports optional `flatten` and `depth`)
+  - `search` (exact): unified tool for cache and storage
+    - Params: `{ schema?, query?, ids?, source?: 'cache'|'storage', limit?, flatten?, depth? }`
+    - Defaults to cache across all collections; add `schema` to filter; set `source:"storage"` to query a specific schema in the DB. Use `fuzzySearch` for typo-tolerant free text.
+  - `fuzzySearch` (typo-tolerant free text across weighted fields)
+    - Params: `{ schema?, q, filters?, fields?, threshold?, limit?, offset?, highlight?, minQueryLength? }`
+    - Defaults: `fields` resolved from schema `searchables` (plural) if present; otherwise weights `name:0.6, info:0.3, description:0.1`. `threshold:0.5`, `limit:50`, `minQueryLength:2`.
+    - Returns: `{ items, count }`. Each item may include `_score` (0..1) and `_matches` when `highlight` is true.
+  - `saveObject({ object })`
+  - `saveObjects({ objects, stopOnError?, concurrency? })`
+    - Batch save with per-item history/events. Defaults: `stopOnError=false`, `concurrency=5`.
+    - Each object must include `itemtype`; `_id` and `joeUpdated` are set when omitted.
+    - Return shape: `{ results, errors, saved, failed }`.
+
+- Quick tests (PowerShell)
+  - Prepare headers if using Basic Auth:
+    ```powershell
+    $pair = "user:pass"; $b64 = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes($pair))
+    $h = @{ Authorization = "Basic $b64"; "Content-Type" = "application/json" }
+    $base = "http://localhost:<PORT>"
+    ```
+  - Manifest:
+    ```powershell
+    Invoke-RestMethod "$base/.well-known/mcp/manifest.json"
+    ```
+  - listSchemas:
+    ```powershell
+    $body = @{ jsonrpc="2.0"; id="1"; method="listSchemas"; params=@{} } | ConvertTo-Json -Depth 6
+    Invoke-RestMethod -Method Post -Uri "$base/mcp" -Headers $h -Body $body
+    ```
+  - getSchema:
+    ```powershell
+    $body = @{ jsonrpc="2.0"; id="2"; method="getSchema"; params=@{ name="<schemaName>" } } | ConvertTo-Json -Depth 6
+    Invoke-RestMethod -Method Post -Uri "$base/mcp" -Headers $h -Body $body
+    ```
+  - search (cache default):
+    ```powershell
+    $body = @{ jsonrpc="2.0"; id="3"; method="search"; params=@{ query=@{ itemtype="<schemaName>" }; limit=10 } } | ConvertTo-Json -Depth 10
+    Invoke-RestMethod -Method Post -Uri "$base/mcp" -Headers $h -Body $body
+    ```
+  - fuzzySearch (cache):
+    ```powershell
+    $body = @{ jsonrpc="2.0"; id="6"; method="fuzzySearch"; params=@{ schema="<schemaName>"; q="st paal"; threshold=0.35; limit=10 } } | ConvertTo-Json -Depth 10
+    Invoke-RestMethod -Method Post -Uri "$base/mcp" -Headers $h -Body $body
+    ```
+  - search (storage):
+    ```powershell
+    $body = @{ jsonrpc="2.0"; id="4"; method="search"; params=@{ schema="<schemaName>"; source="storage"; query=@{ }; limit=10 } } | ConvertTo-Json -Depth 10
+    Invoke-RestMethod -Method Post -Uri "$base/mcp" -Headers $h -Body $body
+    ```
+  - search (ids + flatten):
+    ```powershell
+    $body = @{ jsonrpc="2.0"; id="5"; method="search"; params=@{ schema="<schemaName>"; ids=@("<id1>","<id2>"); flatten=$true; depth=2 } } | ConvertTo-Json -Depth 10
+    Invoke-RestMethod -Method Post -Uri "$base/mcp" -Headers $h -Body $body
+    ```
+  - saveObject:
+    ```powershell
+    $object = @{ itemtype="<schemaName>"; name="Test via MCP" }
+    $body = @{ jsonrpc="2.0"; id="4"; method="saveObject"; params=@{ object=$object } } | ConvertTo-Json -Depth 10
+    Invoke-RestMethod -Method Post -Uri "$base/mcp" -Headers $h -Body $body
+    ```
+  - saveObjects (batch):
+    ```powershell
+    $objs = @(
+      @{ itemtype="<schemaName>"; name="Batch A" },
+      @{ itemtype="<schemaName>"; name="Batch B" }
+    )
+    $body = @{ jsonrpc="2.0"; id="7"; method="saveObjects"; params=@{ objects=$objs; stopOnError=$false; concurrency=5 } } | ConvertTo-Json -Depth 10
+    Invoke-RestMethod -Method Post -Uri "$base/mcp" -Headers $h -Body $body
+    ```
+
+- Quick tests (curl)
+  - Manifest:
+    ```bash
+    curl -s http://localhost:<PORT>/.well-known/mcp/manifest.json | jq
+    ```
+  - listSchemas:
+  - search (cache):
+    ```bash
+    curl -s -X POST http://localhost:<PORT>/mcp \
+      -H 'Content-Type: application/json' \
+      -d '{"jsonrpc":"2.0","id":"3","method":"search","params":{"query":{"itemtype":"<schemaName>"},"limit":10}}' | jq
+    ```
+  - fuzzySearch:
+    ```bash
+    curl -s -X POST http://localhost:<PORT>/mcp \
+      -H 'Content-Type: application/json' \
+      -d '{"jsonrpc":"2.0","id":"6","method":"fuzzySearch","params":{"schema":"<schemaName>","q":"st paal","threshold":0.35,"limit":10}}' | jq
+    ```
+  - search (storage):
+    ```bash
+    curl -s -X POST http://localhost:<PORT>/mcp \
+      -H 'Content-Type: application/json' \
+      -d '{"jsonrpc":"2.0","id":"4","method":"search","params":{"schema":"<schemaName>","source":"storage","query":{},"limit":10}}' | jq
+    ```
+    ```bash
+    curl -s -X POST http://localhost:<PORT>/mcp \
+      -H 'Content-Type: application/json' \
+      -d '{"jsonrpc":"2.0","id":"1","method":"listSchemas","params":{}}' | jq
+    ```
+  - saveObjects (batch):
+    ```bash
+    curl -s -X POST http://localhost:<PORT>/mcp \
+      -H 'Content-Type: application/json' \
+      -d '{"jsonrpc":"2.0","id":"7","method":"saveObjects","params":{"objects":[{"itemtype":"<schemaName>","name":"Batch A"}],"stopOnError":false,"concurrency":5}}' | jq
+    ```
+
+- Troubleshooting
+  - If you see a payload like `{ originalURL: "/...", site: "no site found" }`, the request hit the Sites catch-all. Ensure MCP routes are initialized before Sites (handled by default in `server/init.js` via `MCP.init()`), and use the correct URL: `/.well-known/mcp/manifest.json` or `/mcp`.
+  - To update contact email on /privacy and /terms, set Setting `PRIVACY_CONTACT`.
+
+## SERVER/PLATFORM mode
+	check port 2099
+	/JOE/
+	/JsonObjectEditor/docs.html
+	*Should auto-open on start
+
+Json Object Editor (Universal-esque software)
+(requires connection to a mongo server for full functionality)
+
+
+
+### JOE server instantiation (add to entry point js file)
+	var joe = require('json-object-editor');
+	or here's a custom example
+	var joe = require('json-object-editor')({
+		name:'name_your_joe' (JOE),
+    	joedb:'local_custom_database_name' // {{mongoURL}}' if using mongolab or remote mongodb,
+    	port:'4099', (2099)
+    	socketPort:'4098', (2098)
+    	sitesPort:'4100' (2100),
+		clusters:1,
+		hostname:'server name if not localhost'(localhost)
+	});
+
+## $J (universal) Shorthand JOE
+	$J to access helper funtions on client and server. (callbacks are optional)
+	$J.get(itemId,[callback])
+	$J.schema(schemaname,[callback])
+
+# Client-Side (front end only)
+
+## js client only instantiation
+	var specs = {
+		fields:{
+			species:{label:'Species',type:'select', values:['cat','dog','rat','thing'], onchange:adjustSchema},
+			gender:{type:'select', values:['male','female']},
+			legs:{label:'# of Legs',type:'int', onblur:logit},
+			weight:{label:' Weight (lbs)',type:'number', onblur:logit},
+			name:{label:' pet Name', onkeyup:logValue},
+			//id:{label:'ID',type:'text', locked:true},
+			id:{label:'ID',type:'guid'},
+			
+		//example of select that takes function (function is passed item)	
+			animalLink:{label:'Link to other animal',type:'select', values:getAnimals},
+			hiddenizer:{hidden:true}
+		},
+		schemas:{
+			animal:animalschema,
+			thing:thingschema			
+		},
+		container:string ('body'),
+        compact:false,
+        useBackButton:true,
+		autosave:2000,
+        listSubMenu:{filters:{}},
+        useHashlink:true,
+        title:'${itemtype} | ${display}'
+	}
+	var JOE = new JsonObjectEditor(specs);
+	JOE.init();
+
+##JOE CONFIG
+##specs
+- useBackButton:[false] if true, back button moves through joe panels when joe has history to go to (is open).
+- useHashlink:[false], true or a template for hashlinks. 
+    default template is '${schema_name}_${_id}'
+	default server tempalte is '${schema_name}/${_id}'
+##SCHEMA CONFIG
+###fields
+Properties for all Fields
+
+- `label / display`: what the field should display as
+    *If the field type is boolean, label controls checkbox/boolean label
+- `value`: default value if not one in object
+- `default`: default value for field || function(object)
+- `type`: what type of field should JOE show
+- `hidden`: boolean / function, value will be added (but unsees by user)
+- `locked`: boolean
+- `condition`: boolean
+- `width`: used for layout control.
+	- can use pixels or percentages (as string)
+- `comment`: a commentthat shows up at the beginning of the field
+- `tooltip`: hover/clickable tooltip that shows up next to name
+
+**field types:**
+
+- `rendering`: for css html and js
+- `text`: default single line text.
+	- autocomplete: boolean // obj of specs (template, idprop)
+		- values:array of possibilities
+	-maxlength:string
+- `int`: integer field
+- `number`: number (float) field
+- `select`: select list. 
+	- multiple(bool)
+	- values(array of objects, [{value:"",name/display:""]), can be a function
+		- disabled:boolean(func acceptable)
+	- idprop: string of prop name
+- `geo`: shows a map
+	- *takes a string array "[lat,lon]"*
+	- center:[lat,lon], center of map
+	- zoom: zoom level (higher zooms in more)
+	- returns "[lat,lon]"
+-`image` : shows an image and HxW as th image url is typed in.
+- `multisorter` : allows arrays of objects to be selected and sorted in right bin.
+	- values(array of objects, [{value:"",name/display:""]), can be a function
+- `content` : show content on in the editor
+    - run: function to be run(current_object,field_properties)
+    - template: html template for fillTemplate(template,current_object);
+- `objectlist` : a table of objects with editable properties
+    - properties: array of objects|strings for the object property names
+        -name: value in object
+        -display: header in objectList
+    - max: integer, number or items that can be added. use zero for infinite.
+    - hideHeadings: don't show table headings
+- `objectReference` : a list of object ids
+    - template
+    - autocomplete_template
+    - idprop
+    - values
+    - max(0 unlimited)
+    - sortable(true)
+- `code` :
+	- language
+	
+- `boolean`:
+	- label:controls checkbox label
+- `preview` :
+	-content: string or function(current joe object) to replace everything on page (template).
+	-bodycontent: same as content, only replaces body content.
+	-url: preview page if not the default one.
+	- encoded: boolean, if pre uriencoded
+**labels:**
+
+- pass an object instead of a string to the fields array.
+
+
+    {label:'Name of the following properties section'}
+
+##page sections
+    {section_start: 'SectionName',
+       section_label:'Section Name with Labels',
+       condition:function(item){
+           return item.show;}
+    },
+    {section_end: 'CreativeBrief'}
+
+- pass an object instead of a string to the fields array. these show up on the details view as anchors.
+
+
+- Object Properties
+    - `section_start`: name/id of section
+    - `'section_label`:use instead of section_start for display name
+    - `section_end`: name/id of section(str)
+    - template: html template for fillTemplate(template,current_object);
+    
+##page sidebar
+    {sidebar_start: 'SectionName',
+       sidebar_label:'Section Name with Labels',
+       condition:function(item){
+           return item.show;}
+    },
+    {sidebar_end: 'CreativeBrief'}
+
+- pass an object instead of a string to the fields array. these show up on the details view as anchors.
+
+
+- Object Properties
+    - `sidebar_start`: name/id of sidebar
+    - `sidebar_label`:use instead of sidebar_start for display name
+    - `sidebar_end`: name/id of sidebar(str)
+    - template: html template for fillTemplate(template,current_object);
+    
+###defaultProfile
+overwrites the default profile
+
+#schemas 
+
+a list of schema objects that can configure the editor fields, these can be given properties that are delegated to all the corresponding fields.
+
+	var animalschema = 
+	{
+		title:'Animal', *what shows as the panel header* 
+		fields:['id','name','legs','species','weight','color','gender','animalLink'], *list of visible fields*
+		_listID:'id', *the id for finding the object*
+		_listTitle:'${name} ${species}', *how to display items in the list*
+		menu:[array of menu buttons],
+		listMenuTitle: (string) template forjoe window title in list view,
+		listmenu:[array of menu buttons] (multi-edit and select all always show),
+		/*callback:function(obj){
+			alert(obj.name);
+		},*/
+		onblur:logit,
+		
+		hideNumbers:boolean *toggle list numbers*
+		multipleCallback:function to be called after a multi-edit. passed list of edited items.
+		onUpdate: callback for after update. passed single edited items.
+		onMultipleUpdate:callback for after multi update.passed list of edited items.
+                filters: array of objects
+		checkChanges:(bool) whether or not to check for changes via interval and on leave
+	}
+##Table View
+	- add tableView object to a schema;
+	-cols = [strings||objects]
+		-string is the name and value
+		-display/header is the column title
+		-property/name = object property 
+###Pre-formating
+you can preformat at the joe call or schema level. The data item will be affected by the passed function (which should return the preformated item). 
+
+##menu##
+an array of menu buttons
+
+    //the default save button
+    //this is the dom object, 
+    //use _joe.current.object for current object
+    condition:function(field,object) to call
+    self = Joe object
+    var __saveBtn__ = {name:'save',label:'Save', action:'_joe.updateObject(this);', css:'joe-save-button'};
+
+##itemMenu##
+as array of buttons for each item in list views
+	- name
+	- action (action string)
+	- url (instead of js action)
+	- condition
+
+##itemExpander##
+template or run for content to be shown under the main list item block.
+
+
+###Addition properties
+**Changing the schema on the fly?**
+
+	_joe.resetSchema(new schema name);
+
+
+
+**css (included) options**
+
+- joe-left-button
+- joe-right-button
+
+##FIELDS
+
+    {extend:'name',specs:{display:'Request Title'}},//extends the field 'name' with the specs provided.
+##usage
+### a | adding a new object
+
+	_joe.show({},{schema:'animal',callback:addAnimal); 
+	//or goJoe(object,specs)
+
+	...
+	function addAnimal(obj){
+		animals.push(obj);
+	}
+
+### b | viewing a list of objects
+
+	goJoe([array of objects],specs:{schema,subsets,subset})
+	goJoe.show(animals,{schema:'animal',subsets:[{name:'Two-Legged',filter:{legs:2}}]});
+	//use the specs property subset to pre-select a subset by name
+
+**properties**
+
+- _listWindowTitle: the title of the window (can be passed in with the schema);
+- _listCount: added to the current object and can be used in the title.
+- _listTitle:'${name} ${species}', *how to display items in the list*
+- _icon: [str] template for a list item icon (standard min 50x50), 'http://www.icons.com/${itemname}', can be obj with width, height, url 
+- listSubMenu:a function or object that represents the list submenu
+- stripeColor:string or function that returns valid css color descriptor.
+- bgColor:string or function that returns valid css color descriptor.
+- subsets: name:string, filter:object 
+- subMenu:a function or object that represents the single item submenu
+
+- _listTemplate: html template that uses ${var} to write out the item properties for the list item.
+	- standard css class `joe-panel-content-option`
+
+### Helper shortcuts: subsets and stripes
+
+Use these helpers to quickly generate subset/filter options and add per-item stripe colors.
+
+```javascript
+// In a schema definition
+{
+  // 1) Subsets from statuses of the current schema (auto colors)
+  subsets: function () {
+    return _joe.Filter.Options.status({
+      group: 'status',        // optional grouping label
+      collapsed: true,        // start group collapsed
+      none: true              // include a "no status" option
+      // color: 'stripecolor' // uncomment to render colored stripes in the menu
+    });
+  },
+
+  // 2) Subsets for all distinct values of a property
+  //    Example: recommendation_domain on 'recommendation' items
+  //    (pass values to control order/allowlist)
+  // subsets: () => _joe.Filter.Options.getDatasetPropertyValues(
+  //   'recommendation', 'recommendation_domain', { group: 'domain', values: ['product','dietary','activity'] }
+  // ),
+
+  // 3) Subsets from another dataset (reference values)
+  // subsets: () => _joe.Filter.Options.datasetProperty('user','members',{ group: 'assignees', collapsed: true }),
+
+  // 4) Row stripe color by status (string or { color, title })
+  stripeColor: function (item) {
+    if (!item.status) return '';
+    const s = _joe.getDataItem(item.status, 'status');
+    return s && { color: s.color, title: s.name };
+  }
+}
+```
+
+
+
+###c | Conditional select that changes the item schema
+
+	fields:{
+		species:{label:'Species',type:'select', values:['cat','dog','rat','thing'], onchange:adjustSchema},
+		[field_id]:{
+			
+			+label : STR
+			+type : STR
+			value : STR (default value)
+			+values : ARRAY/FUNC (for select)
+			
+			//modifiers
+			+hidden:BOOL/STRING(name of field that toggles this) //don't show, but value is passed
+			+locked:BOOL // show, but uneditable
+			//events
+			+onchange : FUNC
+			+onblur : FUNC
+			+onkeypress : FUNC
+			+rerender : STRING // name of field to rerender
+		}
+	}
+
+	function adjustSchema(dom){
+		var species = $(dom).val();
+		if(species == "thing"){
+			JOE.resetSchema('thing')
+		}
+		else{
+			JOE.resetSchema('animal')
+		
+		}
+	}
+
+###d | duplicating an item
+
+	//duplicates the currently active object (being edited)
+	_joe.duplicateObject(specs);
+
+**specs**
+
+- `deletes`:array of properties to clear for new item
+	- note that you will need to delete guid/id fields or the id will be the same.	
+
+
+
+### e | exporting an object in pretty format json (or minified)
+JOE.exportJSON = function(object,objvarname,minify)
+
+##Useful Functions
+_joe.reload(hideMessage,specs)
+- use specs.overwreite object to extend reloaded object.
+
 _joe.constructObjectFromFields()

package/server/modules/MCP.js

@@ -246,7 +246,7 @@ MCP.tools = {
     if (!object || !object.itemtype) throw new Error("'object' with 'itemtype' is required");
     const user = (ctx.req && ctx.req.User) ? ctx.req.User : { name: 'anonymous' };
     // Ensure server-side update timestamp parity with /API/save
-    if (!object.joeUpdated) { object.joeUpdated = new Date(); }
+    if (!object.joeUpdated) { object.joeUpdated = new Date().toISOString(); }
     // Ensure a stable _id for new objects so history and events work consistently
     try {
       if (!object._id) { object._id = (typeof cuid === 'function') ? cuid() : ($c && $c.guid ? $c.guid() : undefined); }
@@ -262,6 +262,61 @@ MCP.tools = {
     return sanitizeItems(saved)[0];
   },
 
+  // Batch save with bounded concurrency; preserves per-item history/events
+  saveObjects: async ({ objects, stopOnError = false, concurrency = 5 } = {}, ctx = {}) => {
+    if (!Array.isArray(objects) || objects.length === 0) {
+      throw new Error("'objects' (non-empty array) is required");
+    }
+    const user = (ctx.req && ctx.req.User) ? ctx.req.User : { name: 'anonymous' };
+    const size = Math.max(1, parseInt(concurrency, 10) || 5);
+    const results = new Array(objects.length);
+    const errors = [];
+    let cancelled = false;
+
+    async function saveOne(obj, index){
+      if (cancelled) return;
+      if (!obj || !obj.itemtype) {
+        const errMsg = "Each object must include 'itemtype'";
+        errors.push({ index, error: errMsg });
+        if (stopOnError) { cancelled = true; }
+        return;
+      }
+      if (!obj.joeUpdated) { obj.joeUpdated = new Date().toISOString(); }
+      try {
+        if (!obj._id) {
+          try { obj._id = (typeof cuid === 'function') ? cuid() : ($c && $c.guid ? $c.guid() : undefined); } catch(_e) {}
+        }
+        const saved = await new Promise((resolve, reject) => {
+          try {
+            Storage.save(obj, obj.itemtype, function(err, data){
+              if (err) return reject(err);
+              resolve(data);
+            }, { user, history: true });
+          } catch (e) { reject(e); }
+        });
+        results[index] = sanitizeItems(saved)[0];
+      } catch (e) {
+        errors.push({ index, error: e && e.message ? e.message : (e+'' ) });
+        if (stopOnError) { cancelled = true; }
+      }
+    }
+
+    // Simple promise pool
+    let cursor = 0;
+    const runners = new Array(Math.min(size, objects.length)).fill(0).map(async function(){
+      while (!cancelled && cursor < objects.length) {
+        const idx = cursor++;
+        await saveOne(objects[idx], idx);
+        if (stopOnError && cancelled) break;
+      }
+    });
+    await Promise.all(runners);
+
+    const saved = results.filter(function(x){ return !!x; }).length;
+    const failed = errors.length;
+    return { results: sanitizeItems(results.filter(function(x){ return !!x; })), errors, saved, failed };
+  },
+
   // Hydration: surface core fields (from file), all schemas, statuses, and tags (no params)
   hydrate: async (_params, _ctx) => {
     let coreDef = (JOE && JOE.Fields && JOE.Fields['core']) || null;
@@ -324,6 +379,7 @@ MCP.descriptions = {
   search: "Exact search. Defaults to cache; set source=storage to query DB. Supports sortBy/sortDir, offset/limit paging, withCount, and slim response for {_id,itemtype,name,info,joeUpdated,created}. Use fuzzySearch for typo-tolerant free text.",
   fuzzySearch: "Fuzzy free‑text search. Candidates are prefiltered by 'filters' (e.g., { itemtype: 'user' }) and then scored. If 'fields' are omitted, the schema's searchables (strings) are used with best-field scoring; provide 'fields' (strings or {path,weight}) to use weighted sums. Examples: { q: 'corey hadden', filters: { itemtype: 'user' } } or { q: 'backyard', filters: { itemtype: 'house' } }.",
   saveObject: "Create/update an object; triggers events/history.",
+  saveObjects: "Batch save objects with bounded concurrency; per-item history/events preserved.",
   hydrate: "Loads and merges the full JOE context, including core and organization-specific schemas, relationships, universal fields (tags and statuses), and datasets. Returns a single unified object describing the active environment for use by agents, UIs, and plugins.",
   listApps: "List app definitions (title, description, collections, plugins)."
 };
@@ -408,6 +464,15 @@ MCP.params = {
     },
     required: ["object"]
   },
+  saveObjects: {
+    type: "object",
+    properties: {
+      objects: { type: "array", items: { type: "object" } },
+      stopOnError: { type: "boolean" },
+      concurrency: { type: "integer" }
+    },
+    required: ["objects"]
+  },
   hydrate: { type: "object", properties: {} }
   ,
   listApps: { type: "object", properties: {} }
@@ -439,6 +504,15 @@ MCP.returns = {
   },
   // When countOnly is true, search returns { count }
   saveObject: { type: "object" },
+  saveObjects: {
+    type: "object",
+    properties: {
+      results: { type: "array", items: { type: "object" } },
+      errors: { type: "array", items: { type: "object" } },
+      saved: { type: "integer" },
+      failed: { type: "integer" }
+    }
+  },
   hydrate: { type: "object" },
   listApps: {
     type: "object",

package/server/modules/Server.js

@@ -684,7 +684,7 @@ server.get(['/API/save/','/API/save/:itemid'],auth,function(req,res,next){
                 object[prop] = $c.parseBoolean(object[prop]);
             }
         }
-        object.joeUpdated = new Date();
+        object.joeUpdated = new Date().toISOString();
     //TODO: check to make sure schema idprop is present
     JOE.Storage.save(object,object.itemtype,function(err,results){
         //var object = merge({},results);

package/server/modules/Storage.js

@@ -97,6 +97,15 @@ function Storage(specs){
             var specs = $c.merge({history:true},(specs||{}));
             var user = specs.user || {name:'anonymous'};
 
+            // Ensure timestamps: always set joeUpdated; set created only on create when missing
+            try{
+                if(!data.joeUpdated){ data.joeUpdated = new Date().toISOString(); }
+                if(!data.created){
+                    var cachedBefore = (data && data._id && JOE && JOE.Cache && JOE.Cache.findByID) ? JOE.Cache.findByID(collection,data._id) : null;
+                    if(!cachedBefore){ data.created = new Date().toISOString(); }
+                }
+            }catch(_e){}
+
             if(JOE.Mongo){
                 logit(moduleName+' mongo saving -> '+colorize(collection,'schema'));