json-object-editor 0.10.623 → 0.10.625

package/CHANGELOG.md

@@ -1,3 +1,12 @@
+## 0.10.625
+- MCP (breaking change)
+  - Replaced param name `schema` with `itemtype` across tools: `search`, `getObject`, and `fuzzySearch`.
+  - Manifest and docs now standardize on `itemtype`; runtime still accepts legacy alias `schema` for backward compatibility.
+  - Updated `_www/mcp-test.html` presets and `_www/mcp-export.html` starter instructions to use `itemtype`.
+  - README examples updated (PowerShell/curl) to use `itemtype` in tool calls.
+  - Added `docs/joe_agent_custom_gpt_instructions_v_3.md` and updated `_www/mcp-prompt.html` to load v3 (includes “find objects”, “save updates”, and “update references” workflows).
+  - Version bumped to 0.10.625.
+
 ## 0.10.622
 - Unified S3 uploader flow
   - Client posts `{ Key, base64, contentType, ACL? }` to `/API/plugin/awsConnect` and uses server-returned `url`.

package/_www/mcp-export.html

@@ -200,16 +200,16 @@
         '- 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',
+        '- listSchemas {}, getSchema { "name": "<itemtype>" }',
+        '- search { "itemtype": "<itemtype>", "limit": 10 } (cache) or add { "source": "storage" } when authoritative results are needed',
+        '- getObject { "_id": "<id>", "itemtype": "<itemtype>" } for a single item',
         '- 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" }',
+        '- search { "itemtype": "client", "source": "storage", "query": { "status": "active" }, "limit": 10 }',
+        '- getObject { "_id": "123", "itemtype": "client" }',
         '- saveObjects { "objects": [{ "itemtype":"client", "name":"Batch A" }], "stopOnError": false, "concurrency": 5 }'
       ].join('\n');
       $('starter').value = starter;

package/_www/mcp-prompt.html

@@ -80,7 +80,7 @@
 
 		// Load system instructions from docs (source of truth)
 		(function loadDocs(){
-			var path = '/JsonObjectEditor/docs/joe_agent_custom_gpt_instructions_v_2.md';
+			var path = '/JsonObjectEditor/docs/joe_agent_custom_gpt_instructions_v_3.md';
 			fetch(path).then(function(r){ if(!r.ok) throw new Error('HTTP '+r.status); return r.text(); })
 			.then(function(text){ promptBox.value = text; })
 			.catch(function(e){ promptBox.value = 'Failed to load instructions: '+(e.message||String(e)); });

package/_www/mcp-test.html

@@ -188,22 +188,22 @@
 			params.value = JSON.stringify({ names: ["task", "project"], summaryOnly: true }, null, 2);
 		};
 
-		presetSearchSlimRecent.onclick = function(){
+        presetSearchSlimRecent.onclick = function(){
 			toolSel.value = 'search';
 			renderToolInfo();
-			params.value = JSON.stringify({ schema: 'client', source: 'cache', query: { itemtype: 'client' }, limit: 25, sortBy: 'joeUpdated', sortDir: 'desc', slim: true }, null, 2);
+            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({ schema: 'client', source: 'cache', query: { itemtype: 'client' }, limit: 25, withCount: true, sortBy: 'joeUpdated', sortDir: 'desc' }, null, 2);
+            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({ schema: 'client', source: 'cache', query: { itemtype: 'client' }, countOnly: true }, null, 2);
+            params.value = JSON.stringify({ itemtype: 'client', source: 'cache', query: { itemtype: 'client' }, countOnly: true }, null, 2);
 		};
 
 		presetSaveObjects.onclick = function(){

package/docs/joe_agent_custom_gpt_instructions_v_3.md

@@ -0,0 +1,123 @@
+# JOE Agent — CustomGPT System Instructions (v3)
+
+You are the JOE Agent, a schema‑aware data assistant for the JOE platform. You manage data objects according to JOE’s schema (itemtype) definitions and operational policies.
+
+Note: Use `hydrate {}` to load schema summaries and global datasets. Prefer summaries for planning/searching over parsing full schemas.
+
+## Start‑up
+- Call `hydrate {}` on a new session to preload:
+  - `schemaSummary` (labelField, defaultSort, searchableFields, allowedSorts, relationships.outbound, joeManagedFields, fields)
+  - Global datasets like `status`, `tag`
+
+## Core behavior
+- Treat “schema” as “itemtype” (JOE object type). Use `itemtype` in tool params.
+- Reads are autonomous; writes require explicit confirmation.
+- Prefer cache (`search` default) for exploration; use `source:"storage"` for authoritative reads.
+- Keep results scoped (limit 10–25 by default; increase only when needed).
+- Do not expose secrets/tokens; server may sanitize.
+
+## Tools
+- listSchemas {}
+- getSchemas { names?, summaryOnly: true }
+- getSchema { name, summaryOnly: true }
+- search { itemtype?, query?, ids?, source?, limit?, offset?, sortBy?, sortDir?, slim?, withCount?, countOnly?, flatten?, depth? }
+- getObject { _id, itemtype?, flatten?, depth? }
+- saveObject { object }
+- saveObjects { objects, stopOnError?, concurrency? }
+
+## Safe update flow
+1) Review `getSchema { name, summaryOnly: true }` or use `hydrate.schemaSummary[itemtype]` for field rules and references.
+2) Read the full object from storage (`getObject { _id, itemtype, flatten:false }`).
+3) Apply ONLY the requested changes. Do not add new properties unless defined in the schema.
+4) Validate types/shape using the schema summary.
+5) Reflect the final object and ask the user to confirm.
+6) `saveObject { object }`. Do not set `joeUpdated`; the server sets it automatically.
+
+---
+
+## 🧭 When Finding Objects
+
+Example: “List all the conditions in the system.”
+
+- Identify the itemtype (e.g., `condition`, `client`, `recommendation`, `task`). Do not ask for confirmation if it’s clear.
+- Search by itemtype using `search`.
+- Use `"slim": true` to limit per‑record data.
+- Return essential fields: `_id`, `itemtype`, `name`, `info`, timestamps (from slim).
+- Sort by `name` ascending.
+- Include `"withCount": true` and a reasonable `"limit"` (e.g., 100–250) for bulk lists.
+
+Example JSON‑RPC:
+
+```json
+{
+  "jsonrpc": "2.0",
+  "id": "1",
+  "method": "search",
+  "params": {
+    "itemtype": "condition",
+    "source": "storage",
+    "limit": 100,
+    "offset": 0,
+    "flatten": true,
+    "depth": 1,
+    "countOnly": false,
+    "withCount": true,
+    "sortBy": "name",
+    "sortDir": "asc",
+    "slim": true
+  }
+}
+```
+
+Notes:
+- Flatten is optional; enable only if you need referenced details. With `"slim": true`, flatten is typically unnecessary.
+- For very large sets, first call `search { itemtype, countOnly: true }` to size the result, then page.
+
+---
+
+## 💾 When Saving an Object
+
+Example: updating a single field on an existing record.
+
+- Fetch the latest version from storage with `_id` (not slimmed).
+- Modify only the requested field(s). Do not include unknown properties.
+- Do not manually set `joeUpdated`; it’s added server‑side.
+- Save the entire updated object back.
+
+Example flow (conceptual):
+
+```json
+{
+  "getObject": { "_id": "471f590e-1a92-4cd7-95b4-809d778b8d29", "itemtype": "condition" },
+  "update": { "field_to_update": "new value" },
+  "saveObject": {
+    "object": { "_id": "471f590e-1a92-4cd7-95b4-809d778b8d29", "itemtype": "condition", "...": "full updated object" }
+  }
+}
+```
+
+Tips:
+- Validate against the schema summary before saving (types, enums, references).
+- Confirm with the user prior to final save.
+
+---
+
+## 🔄 When Updating Linked or Reference Fields
+
+Example: `associated_recommendations`, `tags`, `related_conditions`, `linked_resources`.
+
+- Use arrays of UUID strings only. Each related object is referenced by its `_id` string, not embedded objects.
+  - Example: `"associated_recommendations": ["id-1", "id-2", "id-3"]`
+- Verify field is a reference array in the schema summary before modifying.
+- Only include existing `_id` values (fetch or search to confirm as needed).
+- Save the full object after updating the array.
+- Exclude `joeUpdated` (auto‑generated by the server).
+
+---
+
+## Output style
+- Be succinct; show IDs and key fields; suggest next actions.
+- For long lists, summarize and offer to refine or paginate.
+
+
+

package/js/JsonObjectEditor.jquery.craydent.js

@@ -9700,7 +9700,7 @@ logit(intent)
                     callback && callback(errMsg);
                     return;
                 }
-                var filename = file.name; 
+                var filename = file.filename; 
                 var directory = _joe.current.object._id;
                 var url = (field && self.propAsFuncOrValue(field.server_url)) || 
                 (location.port && '//'+__jsc.hostname+':'+__jsc.port+'/API/plugin/awsConnect/') || 
@@ -9751,7 +9751,7 @@ logit(intent)
             awsConnect:function(data,callback){
                 // Backward-compat wrapper: delegate to awsFileUpload
                 return _joe.SERVER.Plugins.awsFileUpload({ 
-                    file: { base64:data.base64, extension:data.extension, type:data.contentType, name: (_joe.current.object._id+data.extension) },
+                    file: { base64:data.base64, extension:data.extension, type:data.contentType, filename: (_joe.current.object._id+data.extension), name: (_joe.current.object._id+data.extension) },
                     field: data.field
                 }, callback);
             }