@gotcos/glasses-server 6.98.1 → 6.99.16

package/server/web-control/memories/memory-stewardship.js

@@ -0,0 +1,63 @@
+/* Owner review, source refresh and outcome evidence use the same versioned RPC. */
+(function(){
+  'use strict';
+  window.createMemoryStewardship=function(api){
+    var state={tab:'rules',rows:[],cursor:null,busy:false,error:null,intent:null,serial:0,open:false,draft:{}};
+    var esc=api.esc;
+    function request(body){return api.call('workspace.request',body);}
+    function field(id){var e=document.getElementById(id);return e?e.value.trim():'';}
+    function button(label,action,id){return '<button '+(state.busy||(state.intent&&action!=='retry')?'disabled':'')+' data-steward-action="'+action+'" data-steward-id="'+esc(id||'')+'">'+label+'</button>';}
+    function saveDraft(){['stewardText','stewardTrigger','stewardExclusions','stewardEvidence','stewardEvaluation'].forEach(function(id){var e=document.getElementById(id);if(e)state.draft[id]=e.value;});}
+    function render(){
+      if(!state.open)return;saveDraft();
+      var body='<p>Evidence and owner decisions govern changes. A saved rule stays in shadow until reviewed and independently checked.</p><div class="actions">'+['rules','sources','outcomes'].map(function(t){return button(t==='rules'?'Standing rules':t==='sources'?'Current sources':'Outcome evidence','tab',t);}).join('')+'</div>';
+      if(state.error)body+='<p class="bad">'+esc(state.error)+'</p>'+(state.intent?button('Retry same action','retry'):button('Reload','reload'));
+      if(state.busy)body+='<p>Working…</p>';
+      if(state.tab==='rules'){
+        body+=state.rows.map(function(r){var p=r.payload||{};
+          return '<section class="logrow"><h3>'+esc(p.text)+'</h3><p>'+esc(r.state)+' · revision '+esc(r.revision)+' · '+esc(p.review)+'</p><p>Applies when: '+esc(p.trigger||'not specified')+'</p><p>Exclusions: '+esc((p.exclusions||[]).join('; ')||'none recorded')+'</p><small>Evidence: '+esc((p.evidence_refs||[]).join(', '))+'</small><div class="actions">'+(r.state==='candidate'&&p.review!=='approved_by_owner'?button('Review this version','review',r.id):'')+(r.state==='candidate'&&p.review==='approved_by_owner'?button('Check evaluation and activate','activate',r.id):'')+(r.state==='active'?button('Roll back this rule','rollback',r.id):'')+'</div></section>';
+        }).join('')||'<p>No standing-rule versions recorded.</p>';
+        if(state.cursor)body+=button('Load more','more');
+        body+='<div class="settings-block"><h3>Propose a rule</h3><textarea class="editor" id="stewardText" placeholder="The proposed behavior"></textarea><input id="stewardTrigger" placeholder="When this rule applies"><input id="stewardExclusions" placeholder="Exclusions, one per line"><input id="stewardEvidence" placeholder="Source or memory IDs, separated by commas">'+button('Save shadow proposal','propose')+'</div><div class="settings-block"><label>Independent evaluation ID <input id="stewardEvaluation" placeholder="Evaluation artifact ID"></label><p class="muted">Checks must cover this exact revision, trigger, exclusions, counterexamples and regressions. An unverified artifact cannot activate a rule.</p></div>';
+      }else if(state.tab==='sources'){
+        body+=state.rows.map(function(r){return '<section class="logrow"><h3>'+esc(r.title||r.id)+'</h3><p>Revision '+esc(r.revision)+' · '+esc(r.captured_at)+' · '+esc(r.projection)+'</p><small>'+esc(r.content_hash)+'</small>'+button('Refresh granted document','refresh',r.id)+'</section>';}).join('')||'<p>No current granted source snapshots. Source grants are configured by the instance owner.</p>';
+      }else{
+        var d=state.outcomes||{};body+='<p>'+esc(d.unique_runs||0)+' observed runs. Evidence threshold '+(d.evidence_gate_met?'met':'not yet met')+'.</p><pre>'+esc(JSON.stringify(d,null,2))+'</pre><p>Retrieval, context inclusion, model-reported application and independently checked outcomes are distinct. Insufficient evidence does not imply improvement.</p>';
+      }
+      api.modal('Memory stewardship',body);
+      Object.keys(state.draft).forEach(function(id){var e=document.getElementById(id);if(e)e.value=state.draft[id];});
+      document.querySelectorAll('[data-steward-action]').forEach(function(el){el.addEventListener('click',function(){act(el.dataset.stewardAction,el.dataset.stewardId);});});
+    }
+    function load(more){
+      if(state.busy)return;state.busy=true;state.error=null;var serial=++state.serial;
+      var action=state.tab==='rules'?'rule_page':state.tab==='sources'?'source_status':'trace_summary';var body={action:action};
+      if(action==='rule_page'){body.limit=25;body.cursor=more?state.cursor:null;}
+      render();request(body).then(function(d){if(serial!==state.serial||!state.open)return;state.busy=false;
+        if(action==='trace_summary')state.outcomes=d;else{state.rows=more?state.rows.concat(d.items||[]):d.items||[];state.cursor=d.next_cursor||null;}
+        render();},function(e){if(serial!==state.serial||!state.open)return;state.busy=false;state.error=e.message;render();});
+    }
+    function mutate(body){
+      if(state.busy||!state.open)return;if(state.intent&&body!==state.intent)return;if(!state.intent)state.intent=JSON.parse(JSON.stringify(body));
+      state.busy=true;state.error=null;render();request(state.intent).then(function(d){
+        state.busy=false;state.intent=null;if(state.open){api.toast(d.status||'Saved');load(false);}
+      },function(e){state.busy=false;state.error=/evaluation_not_found/.test(e.message)?'No passing evaluation was found for this ID. The rule is still in shadow. Check the evaluation result and enter a valid ID.':/evaluation_unreadable/.test(e.message)?'This evaluation could not be verified. The rule is still in shadow. Regenerate the evaluation before retrying.':e.message;
+        if(/revision_conflict|idempotency_conflict|invalid_|rule_not_|evaluation_|owner_review_required|not_memory_authority/.test(e.message))state.intent=null;
+        render();});
+    }
+    function act(action,id){
+      if(state.busy||!state.open)return;
+      if(state.intent&&action!=='retry'){state.error='Retry the pending action before starting another.';render();return;}
+      if(action==='retry'){mutate(state.intent);return;}
+      if(action==='tab'){if(state.intent){state.error='Resolve the pending action before changing sections.';render();return;}state.tab=id;state.rows=[];state.cursor=null;load(false);return;}
+      if(action==='reload'){load(false);return;}if(action==='more'){load(true);return;}
+      if(action==='propose'){
+        mutate({action:'propose_rule',payload:{lesson_id:'owner_proposal',text:field('stewardText'),trigger:field('stewardTrigger'),exclusions:field('stewardExclusions').split('\n').filter(Boolean),evidence_refs:field('stewardEvidence').split(',').map(function(x){return x.trim();}).filter(Boolean)}});return;
+      }
+      var row=state.rows.find(function(r){return r.id===id;});if(!row)return;
+      var body={action:action==='refresh'?'refresh_source':action==='review'?'review_rule':action==='rollback'?'rollback_rule':'activate_rule',id:id,expected_revision:row.revision,idempotency_key:'steward_'+crypto.randomUUID()};
+      if(action==='activate'){body.evaluation_id=field('stewardEvaluation');if(!body.evaluation_id){state.error='Enter the independent evaluation ID for this reviewed revision.';render();return;}}
+      mutate(body);
+    }
+    return {open:function(){state.open=true;if(state.intent){render();return;}load(false);},close:function(){saveDraft();state.open=false;++state.serial;if(!state.intent)state.busy=false;}};
+  };
+})();

package/server/web-control/memories/memory-workspace.js

@@ -0,0 +1,216 @@
+/* Owner-only investigations. Canvas edits are drafts; assertions have their own explicit save. */
+(function () {
+  'use strict';
+  var MAX_NODES=200,MAX_EDGES=500;
+  function id(){return crypto.randomUUID();}
+  function copy(value){return JSON.parse(JSON.stringify(value));}
+  function endpoint(value){return typeof value==='object'?value.id:value;}
+  function mergeCanvas(old, incoming){
+    var nodes=new Map((old.nodes||[]).map(function(n){return [n.id,n];}));
+    var links=new Map((old.links||[]).map(function(l){return [l.id||endpoint(l.source)+'|'+endpoint(l.target),l];}));
+    (incoming.nodes||[]).forEach(function(n){nodes.set(n.id,Object.assign({},n,nodes.has(n.id)?{x:nodes.get(n.id).x,y:nodes.get(n.id).y,fx:nodes.get(n.id).fx,fy:nodes.get(n.id).fy}:{}));});
+    (incoming.links||[]).forEach(function(l){links.set(l.id||endpoint(l.source)+'|'+endpoint(l.target),Object.assign({},l,{source:endpoint(l.source),target:endpoint(l.target)}));});
+    if(nodes.size>MAX_NODES||links.size>MAX_EDGES)throw new Error('Canvas limit reached (200 points / 500 links). Hide a branch or start another investigation.');
+    return {nodes:Array.from(nodes.values()),links:Array.from(links.values())};
+  }
+  function create(options){
+    var el=document.createElement('section');el.className='memory-investigation';
+    var state={id:id(),revision:0,title:'Untitled investigation',nodes:[],links:[],anchors:[],waypoints:[],filters:{hops:3,direction:'undirected',avoid:[]},generation:null,paths:[]};
+    var queuedFocus=null,editEpoch=0,lastFocus=null,selected=null,offsets={},history=[],controller=null,started=false,busy=false,requestSerial=0,saveIntents={},assertionIntent=null,separationIntent=null;
+    el.innerHTML='<div data-role="canvas" class="cgx-host"></div><p data-role="overview-status" class="muted" role="status"></p><details class="investigation-tools" data-role="advanced"><summary>Advanced investigation</summary><div class="graph-search row"><input type="search" id="graphQuery" aria-label="Find an entity" placeholder="Find a person or idea…"><button onclick="cosApp.graphSearch()">Find points</button><span id="graphSearchStatus" class="muted"></span></div><div class="source-card"><div class="row"><input data-role="title" aria-label="Investigation title" placeholder="Investigation title"><button data-action="save">Save investigation</button><button data-action="open">Open saved</button><button data-action="new">New</button></div>'+
+      '<p data-role="receipt" class="muted">Draft · saved separately from standing knowledge.</p><div data-role="matches" class="row"></div>'+
+      '<div class="row"><b data-role="selected">Select a point</b><button data-action="start">Set start</button><button data-action="target">Set target</button><button data-action="waypoint">Add waypoint</button><button data-action="expand">Expand point</button><button data-action="avoid">Avoid point</button><button data-action="hide">Hide point</button><button data-action="undo">Undo canvas edit</button></div>'+
+      '<p data-role="anchors"></p><div data-role="waypoints" class="row"></div><div class="row"><label>Total hops <select data-role="hops" aria-label="Total hop limit"><option>3</option><option>4</option><option>5</option><option>6</option><option>7</option></select></label><label>Traversal <select data-role="direction" aria-label="Relationship direction"><option value="undirected">Undirected discovery</option><option value="directed">Known direction only</option></select></label><label>Known valid on <input data-role="valid" aria-label="Known valid on" type="date"></label><button data-action="paths">Find connections</button><button data-action="refresh">Review generation changes</button><button data-action="separate">Keep anchors separate</button></div>'+
+      '<p class="muted">Searches the full index. Up to 3 alternatives, 25 neighbors per expansion. Legacy connections have unknown direction and validity. Paths show associations; they do not establish correlation or causation.</p>'+
+      '<div class="row"><input data-role="point" aria-label="New idea name" placeholder="Add your own idea"><button data-action="point">Add idea</button><input data-role="rationale" aria-label="Association rationale" placeholder="Why might start and target relate?"><button data-action="hypothesis">Add draft hypothesis</button><button data-action="assertion">Save as my assertion</button></div>'+
+      '<p data-role="status" role="status" aria-live="polite"></p><div data-role="paths"></div><div data-role="saved"></div></div></details>';
+    function role(name){return el.querySelector('[data-role="'+name+'"]');}
+    function userIntent(){editEpoch++;if(options.onUserIntent)options.onUserIntent();}
+    var legacyMode=false;
+    function status(text){role('status').textContent=text;}
+    function snapshot(){
+      if(controller){var snap=controller.snapshot();state.nodes=snap.nodes;state.links=snap.links;state.positions=snap.positions;}
+      state.title=role('title').value||'Untitled investigation';
+      state.filters.hops=Number(role('hops').value);state.filters.direction=role('direction').value;state.filters.valid_at=role('valid').value||null;
+      return copy(state);
+    }
+    function remember(){editEpoch++;history.push(snapshot());if(history.length>30)history.shift();}
+    function selectedChanged(value){selected=value;role('selected').textContent=value;}
+    function draw(){
+      if(selected && !state.nodes.some(function(n){return n.id===selected;}))selected=null;
+      role('selected').textContent=selected||'Select a point';
+      role('title').value=state.title;
+      role('hops').value=String(state.filters.hops);role('direction').value=state.filters.direction;role('valid').value=state.filters.valid_at||'';
+      role('anchors').textContent='Start: '+(state.anchors[0]||'—')+' → Target: '+(state.anchors[1]||'—')+' · Avoid: '+(state.filters.avoid.join(', ')||'none');
+      role('waypoints').replaceChildren();
+      state.waypoints.forEach(function(point,index){
+        var label=document.createElement('span');label.textContent=(index+1)+'. '+point+' ';role('waypoints').appendChild(label);
+        [['↑',-1],['↓',1],['Remove',0]].forEach(function(pair){var b=document.createElement('button');b.textContent=pair[0];b.setAttribute('aria-label',pair[0]+' waypoint '+point);b.onclick=function(){remember();if(!pair[1])state.waypoints.splice(index,1);else{var target=index+pair[1];if(target<0||target>=state.waypoints.length)return;var temp=state.waypoints[target];state.waypoints[target]=point;state.waypoints[index]=temp;}draw();};label.appendChild(b);});
+      });
+      if(controller)controller.replaceData(state);
+      else controller=COSGraphExplorer.mount(role('canvas'),Object.assign({},options.graphOptions||{},{scope:'actual',data:state,status:'ready',focus:state.focus||state.anchors[0],onUserIntent:userIntent,onSelect:function(value){userIntent();selectedChanged(value);},
+        onRecenter:function(value){userIntent();selectedChanged(value);run(function(){return expand(value);});},
+        onPassages:function(value){run(async function(){options.openPassages(value,await options.call('graph.passages',{entity:value,limit:5}));});},
+        labels:Object.assign({},options.graphOptions&&options.graphOptions.labels,{sourceStatus:'Draft ideas and hypotheses stay in this investigation until explicitly saved as assertions.',emptyTitle:'No points to show yet',emptyMessage:'Ask a question or open Advanced investigation to find a point. An empty knowledge index needs documents first.'})}));
+      if(options.onController)options.onController(controller);
+      drawPaths();
+    }
+    function drawPaths(){
+      role('paths').replaceChildren();
+      state.paths.forEach(function(path,index){
+        var box=document.createElement('details'),title=document.createElement('summary');title.textContent='Path '+(index+1)+': '+path.nodes.join(' → ');box.appendChild(title);
+        path.edges.forEach(function(edge){
+          var p=document.createElement('p');p.textContent=endpoint(edge.source)+' → '+endpoint(edge.target)+' · '+(edge.direction||'unknown')+' · '+(edge.evidence_status||'unknown')+' · '+(edge.description||edge.desc||'No relationship description');
+          var button=document.createElement('button');button.textContent='Inspect hop evidence';button.onclick=function(){
+            if(edge.evidence_status==='user_authored'||edge.evidence_status==='hypothesis'){status('User rationale: '+(edge.description||edge.desc||'None supplied')+' · '+(edge.evidence_refs||[]).length+' cited references.');return;}
+            run(async function(){options.openPassages(endpoint(edge.source)+' / '+endpoint(edge.target),await options.call('graph.passages',{source:endpoint(edge.source),target:endpoint(edge.target),limit:5}));});
+          };p.appendChild(button);box.appendChild(p);
+        });role('paths').appendChild(box);
+      });
+    }
+    async function rpc(action,args){
+      var result=await options.call('workspace.request',Object.assign({action:action,request_id:id()},args||{}));
+      if(result.error){var code=typeof result.error==='object'?result.error.code:result.error;var message=code==='generation_changed'?'Knowledge changed. Choose Review generation changes before continuing.':code==='revision_conflict'?'This record changed. Refresh and review the latest revision before saving.':typeof result.error==='object'?(result.error.message||result.error.code):result.error;var error=new Error(message);error.code=code;throw error;}
+      if(result.protocol!==1)throw new Error('This workspace needs the matching server and memory pipeline protocol.');
+      return result;
+    }
+    async function run(work){
+      if(busy){status('The current operation is still running.');return;}
+      busy=true;el.setAttribute('aria-busy','true');el.querySelectorAll('input,select').forEach(function(n){n.disabled=true;});status('Working…');
+      try{await work();}catch(error){status(error.message);options.toast(error.message);}finally{busy=false;if(role('status').textContent==='Working…')status('Ready.');el.removeAttribute('aria-busy');el.querySelectorAll('input,select').forEach(function(n){n.disabled=false;});if(queuedFocus){var focus=queuedFocus;queuedFocus=null;lastFocus=focus;selectedChanged(focus);run(function(){return expand(focus);});}}
+    }
+    async function expand(value){
+      if(legacyMode)return expandLegacy(value);
+      var response=await rpc('graph_expand',{id:value,offset:offsets[value]||0,generation:state.generation});
+      var canvas=mergeCanvas(snapshot(),response);remember();state.nodes=canvas.nodes;state.links=canvas.links;state.generation=response.generation;offsets[value]=response.next_offset;
+      draw();status(response.next_offset!=null?'Added neighbors. Expand again for the next page.':'All neighbors loaded for this point.');
+    }
+    async function expandLegacy(value){
+      var legacy=await options.call('graph.entity',{id:value,limit:25});
+      if(!legacy.found)throw new Error('Entity not found in the legacy graph. Choose another point.');
+      var nodes=[{id:legacy.id,group:legacy.type||'unknown',description:legacy.description,descs:legacy.descriptions||[],totalDegree:legacy.degree}].concat((legacy.neighbors||[]).map(function(n){return {id:n.id,group:n.type||'unknown',totalDegree:n.degree};}));
+      var canvas=mergeCanvas(snapshot(),{nodes:nodes,links:legacy.edges||[]});remember();state.nodes=canvas.nodes;state.links=canvas.links;
+      draw();status('Legacy graph browsing. Reload after updating the server and memory pipeline to use advanced actions.');
+    }
+    function showMatches(items){
+      role('advanced').open=true;
+      role('matches').replaceChildren();
+      items.forEach(function(item){var b=document.createElement('button');b.textContent=item.id+' · '+(item.type||'unknown');b.onclick=function(){selectedChanged(item.id);run(function(){return expand(item.id);});};role('matches').appendChild(b);});
+    }
+    function point(){
+      var name=role('point').value.trim();if(!name)throw new Error('Enter an idea name.');if(state.nodes.some(function(n){return n.id===name;}))throw new Error('That point is already on the canvas.');
+      var data=mergeCanvas(snapshot(),{nodes:[{id:name,group:'concept',description:'User-authored draft idea.',evidence_status:'hypothesis',direction:'unknown',validity:'unknown'}]});remember();state.nodes=data.nodes;selectedChanged(name);draw();status('Idea added to this draft investigation.');
+    }
+    async function association(persist){
+      var source=state.anchors[0],target=state.anchors[1],description=role('rationale').value.trim();
+      if(!source||!target||source===target||!description)throw new Error('Choose different start and target points and supply a rationale.');
+      var intentBody=JSON.stringify({source:source,target:target,description:description,direction:role('direction').value});
+      if(persist&&(!assertionIntent||assertionIntent.body!==intentBody))assertionIntent={body:intentBody,id:id()};
+      var edge={id:persist?assertionIntent.id:id(),source:source,target:target,description:description,direction:role('direction').value,validity:'unknown',evidence_status:persist?'user_authored':'hypothesis'};
+      mergeCanvas(snapshot(),{links:[edge]});
+      if(persist){var receipt=await rpc('save_assertion',{id:edge.id,expected_revision:0,idempotency_key:edge.id,payload:{source:source,target:target,description:description,direction:edge.direction}});role('receipt').textContent='Assertion saved · operation '+receipt.operation_id;/* Keep the prior generation pinned until the user reviews all concurrent overlay changes. */assertionIntent=null;}
+      remember();state.links=mergeCanvas(snapshot(),{links:[edge]}).links;draw();status(persist?'Saved as your assertion. Review generation changes before extending this investigation.':'Hypothesis added to the draft; standing knowledge is unchanged.');
+    }
+    async function save(){
+      var current=snapshot(),payload={};['title','anchors','waypoints','nodes','links','positions','filters','generation','paths'].forEach(function(k){if(current[k]!==undefined)payload[k]=current[k];});
+      var pending=saveIntents[state.id];var recovering=!!pending;if(!pending)pending=saveIntents[state.id]={body:JSON.stringify(payload),key:id(),revision:state.revision};
+      var receipt=await rpc('save_exploration',{id:state.id,expected_revision:pending.revision,idempotency_key:pending.key,payload:JSON.parse(pending.body)});
+      state.revision=receipt.revision;delete saveIntents[state.id];role('receipt').textContent='Saved revision '+receipt.revision+' · operation '+receipt.operation_id;status(recovering?'Previous save recovered. Save again to include any subsequent edits.':'Investigation saved. Reopen it after restart.');
+    }
+    async function open(cursor){
+      var response=await rpc('list_explorations',{cursor:cursor||null});if(!cursor)role('saved').replaceChildren();
+      if(!response.items.length){status('No saved investigations yet.');return;}
+      response.items.forEach(function(row){var button=document.createElement('button');button.textContent=row.title+' · revision '+row.revision;button.onclick=function(){run(async function(){var loaded=await rpc('get_exploration',{id:row.id});row=loaded.item;remember();history=[];role('saved').replaceChildren();state=Object.assign({filters:{hops:3,direction:'undirected',avoid:[]},paths:[],anchors:[],waypoints:[]},copy(row.payload),{id:row.id,revision:row.revision});state.filters.avoid=state.filters.avoid||[];offsets={};selected=null;draw();role('receipt').textContent='Opened revision '+row.revision+' · '+row.operation_id;status('Saved evidence generation retained. Review generation changes before extending.');});};role('saved').appendChild(button);});if(response.next_cursor){var more=document.createElement('button');more.textContent='More investigations';more.onclick=function(){run(function(){return open(response.next_cursor);});};role('saved').appendChild(more);}status('Choose an investigation to reopen.');
+    }
+    async function paths(){
+      if(!state.anchors[0]||!state.anchors[1]||state.anchors[0]===state.anchors[1])throw new Error('Choose different start and target points first.');
+      var filters={hops:Number(role('hops').value),direction:role('direction').value,avoid:state.filters.avoid,valid_at:role('valid').value||null};
+      var response=await rpc('graph_paths',Object.assign({start:state.anchors[0],target:state.anchors[1],waypoints:state.waypoints,generation:state.generation},filters));
+      var canvas=mergeCanvas(snapshot(),response);remember();state.nodes=canvas.nodes;state.links=canvas.links;state.paths=response.paths;state.generation=response.generation;state.filters=filters;draw();status(response.message+(response.truncated?' · Incomplete: '+response.truncation_reason:' · Complete within the selected limits.'));
+    }
+    async function refresh(){
+      var before=snapshot(),previewEpoch=editEpoch;var response=await rpc('graph_resolve',{nodes:before.nodes,links:before.links});
+      var message=document.createElement('p');message.textContent='Generation '+JSON.stringify(state.generation)+' → '+JSON.stringify(response.generation)+'. '+response.changes.length+' changes: '+(response.changes.map(function(c){return c.kind+' '+c.id;}).join('; ')||'No changed visible evidence.');
+      var apply=document.createElement('button');apply.textContent='Apply reviewed generation';apply.onclick=function(){if(state.id!==before.id||editEpoch!==previewEpoch){role('saved').replaceChildren();status('Investigation changed. Review generation changes again.');return;}var current=snapshot();remember();state.nodes=response.nodes.map(function(n){var old=current.nodes.find(function(x){return x.id===n.id;});return Object.assign({},n,old?{x:old.x,y:old.y,fx:old.fx,fy:old.fy}:{});});state.links=response.links;state.generation=response.generation;state.paths=[];offsets={};draw();role('saved').replaceChildren();status('Current evidence applied. Withdrawn links removed; missing endpoints labeled. Anchors retained.');};role('saved').replaceChildren(message,apply);status('Review evidence changes below before applying.');
+    }
+    async function separate(){
+      var source=state.anchors[0],target=state.anchors[1],before=state.id,epoch=editEpoch;
+      if(!source||!target||source===target)throw new Error('Choose different start and target points first.');
+      var body=JSON.stringify([source,target]),response=await rpc('identity_status',{source:source,target:target});
+      if(before!==state.id||epoch!==editEpoch)return;
+      role('saved').replaceChildren();
+      if(response.same_identity){status('These names already share one identity. Review a split before keeping them separate.');return;}
+      if(response.blocked){status('These identities are already protected from merging: '+response.blocked);return;}
+      if(!response.writable){status('Save identity constraints on the memory owner Mac after memory setup.');return;}
+      if(!separationIntent||separationIntent.body!==body)separationIntent={body:body,key:id(),revision:response.revision};
+      var intent=separationIntent,message=document.createElement('p'),apply=document.createElement('button');
+      message.textContent='Keep “'+source+'” and “'+target+'” as distinct identities, including their known aliases. Connections between them remain available.';
+      apply.textContent='Save separation rule';apply.onclick=function(){run(async function(){
+        if(before!==state.id||epoch!==editEpoch||body!==JSON.stringify(state.anchors.slice(0,2))){role('saved').replaceChildren();status('The anchors changed. Review the separation rule again.');return;}
+        try{
+          var receipt=await rpc('identity_keep_apart',{source:source,target:target,expected_revision:intent.revision,idempotency_key:intent.key});
+          separationIntent=null;role('saved').replaceChildren();role('receipt').textContent='Separation rule saved · operation '+receipt.operation_id;
+          status('These identities and their aliases are now protected from merging. Review generation changes before finding connections.');
+        }catch(error){
+          if(['revision_conflict','identity_split_required','idempotency_conflict'].includes(error.code)){separationIntent=null;role('saved').replaceChildren();}
+          throw error;
+        }
+      });};role('saved').replaceChildren(message,apply);status('Review the two identities before saving.');
+    }
+    el.addEventListener('click',function(event){if(event.target.closest('button'))userIntent();if(busy&&event.target.closest('button')){event.preventDefault();event.stopImmediatePropagation();status('The current operation is still running.');}},true);
+    el.addEventListener('click',function(event){var button=event.target.closest('[data-action]');if(!button||!el.contains(button))return;var action=button.dataset.action;
+      run(async function(){
+        if(['start','target','waypoint','expand','avoid','hide'].includes(action)&&!selected)throw new Error('Select a point on the canvas first.');
+        if(action==='save')return save();if(action==='open')return open();if(action==='paths')return paths();if(action==='refresh')return refresh();if(action==='separate')return separate();if(action==='point')return point();if(action==='hypothesis'||action==='assertion')return association(action==='assertion');
+        if(action==='expand'){if(offsets[selected]===null){status('All neighbors for this point are already loaded.');return;}return expand(selected);}
+        if(action==='undo'){if(!history.length){status('No canvas edits to undo.');return;}editEpoch++;role('saved').replaceChildren();var previous=history.pop();['nodes','links','positions','anchors','waypoints','filters','generation','paths'].forEach(function(key){state[key]=previous[key];});draw();status('Canvas edit undone. Saved assertions are unchanged.');return;}
+        remember();
+        if(action==='start')state.anchors[0]=selected;
+        if(action==='target')state.anchors[1]=selected;
+        if(action==='waypoint'){if(state.waypoints.includes(selected)||state.anchors.includes(selected))throw new Error('That point is already an anchor or waypoint.');if(state.waypoints.length>=6)throw new Error('At most six waypoints fit the seven-hop budget.');state.waypoints.push(selected);}
+        if(action==='avoid'&&!state.filters.avoid.includes(selected))state.filters.avoid.push(selected);
+        if(action==='hide'){state.nodes=state.nodes.filter(function(n){return n.id!==selected;});state.links=state.links.filter(function(l){return endpoint(l.source)!==selected&&endpoint(l.target)!==selected;});state.waypoints=state.waypoints.filter(function(x){return x!==selected;});state.anchors=state.anchors.map(function(x){return x===selected?null:x;});}
+        if(action==='new'){role('matches').replaceChildren();role('point').value='';role('rationale').value='';history=[];role('saved').replaceChildren();state={id:id(),revision:0,title:'Untitled investigation',nodes:[],links:[],anchors:[],waypoints:[],filters:{hops:3,direction:'undirected',avoid:[]},generation:null,paths:[]};offsets={};selected=null;role('receipt').textContent='New draft';}
+        draw();status('Draft updated.');
+      });
+    });
+    el.addEventListener('input',userIntent);
+    el.addEventListener('change',function(event){if(event.target.matches('input,select')){userIntent();editEpoch++;}});
+    role('title').addEventListener('input',function(){state.title=role('title').value;});
+    function attach(host,focus){
+      host.appendChild(el);
+      if(!started){
+        started=true;lastFocus=focus;draw();
+        run(async function(){
+          var capabilities;
+          try{capabilities=await rpc('status');}
+          catch(error){legacyMode=true;role('overview-status').textContent='Advanced workspace unavailable. Update the server to enable automatic overview.';if(focus)return expandLegacy(focus);return;}
+          if((capabilities.capabilities||[]).includes('graph_overview')){
+            var epoch=editEpoch;
+            role('overview-status').textContent='Loading your knowledge…';
+            try{
+              var overview=await rpc('graph_overview',{focus:focus||null});
+              if(epoch!==editEpoch)return;
+              state.nodes=overview.nodes;state.links=overview.links;state.generation=overview.generation;state.focus=overview.focus;
+              draw();role('overview-status').textContent=state.nodes.length?'Overview · '+state.nodes.length+' people and ideas. Click a point to inspect it.':'No indexed points yet. Open Knowledge setup to add documents.';
+            }catch(error){role('overview-status').textContent='Could not load the overview: '+error.message;throw error;}
+          }else if(focus)await expand(focus);
+          else role('overview-status').textContent='Update the server to preload your graph. Advanced investigation remains available.';
+        });
+      }else if(focus&&focus!==lastFocus){
+        if(busy){queuedFocus=focus;return;}
+        lastFocus=focus;selectedChanged(focus);run(function(){return expand(focus);});
+      }
+    }
+    return {attach:attach,showMatches:showMatches,snapshot:snapshot,
+      questionToken:function(){return {id:state.id,epoch:editEpoch};},
+      applyQuestion:function(result,token){
+        if(!token||token.id!==state.id||token.epoch!==editEpoch||busy)return false;
+        if(!Array.isArray(result.nodes)||!Array.isArray(result.links))return false;
+        var canvas=mergeCanvas({nodes:[],links:[]},result);remember();
+        state.nodes=canvas.nodes;state.links=canvas.links;state.anchors=result.anchors||[];state.waypoints=result.waypoints||[];state.filters=result.filters||{hops:3,direction:'undirected',avoid:[]};state.generation=result.generation;state.paths=result.paths||[];state.focus=state.anchors[0];state.positions={};offsets={};selected=null;
+        role('overview-status').textContent=result.message||'Question investigation';draw();return true;
+      }};
+  }
+  window.COSMemoryWorkspace={create:create,mergeCanvas:mergeCanvas,limits:{nodes:MAX_NODES,edges:MAX_EDGES}};
+})();

package/server/web-control/panes/cos-chat.css

@@ -0,0 +1,174 @@
+/* COS Control Web: the pinned COS chat (panes/cos-chat.js), server 6.99.10. Used while Drop it is on, and from 6.99.12
+   while durable query jobs are on (Ask COS), plus the composer's attachments and the reader's Reply. */
+
+/* ── the split: list and chat ─────────────────────────── */
+.msg-split[data-show='list'] > .msg-right { display: none; }
+.msg-split[data-show='chat'] > .msg-left { display: none; }
+@media (min-width: 860px) {
+  /* Two columns from 860 px (the unfolded Duo reads like the Mac): the list left, the chat right. */
+  .msg-split { display: grid; grid-template-columns: minmax(300px, 40%) minmax(0, 1fr); column-gap: 24px; align-items: start; }
+  .msg-split[data-show] > .msg-left, .msg-split[data-show] > .msg-right { display: block; }
+  /* The list column is narrower than the pane: its header's buttons go under the title instead of over it. */
+  .msg-left .cx-hero .cx-actions { grid-column: 1 / -1; justify-content: flex-start; }
+  .msg-right { position: sticky; top: calc(56px + var(--safe-top, 0px)); height: calc(100vh - 72px - var(--safe-top, 0px)); min-height: 420px; }
+  .msg-right .cc { height: 100%; display: flex; flex-direction: column; background: var(--panel); border: 1px solid var(--panel-border); border-radius: 16px; overflow: hidden; }
+  .msg-right .cc-head { padding: 14px 16px 12px; }
+  .msg-right .cc-feed { flex: 1; overflow-y: auto; padding: 12px 16px 8px; overscroll-behavior: contain; }
+  .msg-right .cc-composer { position: static; padding: 10px 16px 12px; background: var(--panel); }
+}
+
+/* Below 860 px the chat fills the screen, so the composer sits at the bottom even when the chat is short. */
+@media (max-width: 859px) {
+  .msg-split[data-show='chat'] .cc { min-height: calc(100vh - 64px - var(--safe-top, 0px)); display: flex; flex-direction: column; }
+  .msg-split[data-show='chat'] .cc-feed { flex: 1; }
+}
+
+/* ── the pinned row ───────────────────────────────────── */
+.cc-pin { background: color-mix(in srgb, var(--accent) 5%, transparent); }
+.cc-pin[aria-current='true'] { background: var(--qopen); }
+.cc-pin-glyph { background: #2b211a; color: var(--gold); }
+.cc-pinned { font: 500 11px/1.3 var(--body); color: var(--tertiary); }
+.cc-pin-status { font: 600 11.5px/1.3 var(--body); color: var(--sub); }
+.cc-pin-status.hot { color: var(--hot); }
+.cc-pin-status:empty { display: none; }
+
+/* ── the chat ─────────────────────────────────────────── */
+.cc { --cc-you: color-mix(in srgb, var(--gold) 22%, var(--panel)); }
+.cc-head { display: flex; align-items: center; gap: 12px; padding: 14px 0 12px; border-bottom: 1px solid var(--hairline); flex-wrap: wrap; }
+.cc-head-text { min-width: 0; flex: 1; }
+.cc-title { font: 500 24px/1.1 var(--display); color: var(--ink); margin: 0; }
+.cc-sub { margin: 3px 0 0; font-size: 13px; line-height: 1.35; color: var(--sub); }
+.cc-head-acts { display: flex; gap: 14px; }
+.cc-head-acts .link-btn { min-height: 36px; font-size: 14px; font-weight: 500; }
+.cc-avatar { flex: none; width: 30px; height: 30px; border-radius: 8px; background: #2b211a; color: var(--gold); display: grid; place-items: center; }
+.cc-avatar .icon { width: 17px; height: 17px; }
+.cc-avatar.big { width: 42px; height: 42px; border-radius: 11px; }
+.cc-avatar.big .icon { width: 24px; height: 24px; }
+
+.cc-feed { padding: 14px 0 8px; min-height: 160px; }
+.cc-empty { color: var(--sub); font-size: 14px; text-align: center; padding: 28px 8px; margin: 0; }
+.cc-line { margin: 0 0 14px; }
+.cc-line.you { display: flex; flex-direction: column; align-items: flex-end; }
+.cc-bubble { max-width: min(80%, 560px); background: var(--cc-you); color: var(--ink); border: 1px solid color-mix(in srgb, var(--gold) 35%, transparent);
+  border-radius: 18px; padding: 9px 14px; font-size: 15px; line-height: 1.4; overflow-wrap: anywhere; white-space: pre-wrap; }
+.cc-line.answer .cc-bubble { font-weight: 600; }
+.cc-src { font-size: 11.5px; color: var(--tertiary); margin: 4px 6px 0; }
+.cc-line.cos { display: grid; grid-template-columns: 30px minmax(0, 1fr); gap: 10px; align-items: end; }
+.cc-card { max-width: 560px; background: var(--panel); border: 1px solid var(--panel-border); border-radius: 16px; padding: 11px 14px 12px; min-width: 0; }
+.cc-line.done .cc-card { opacity: 0.86; }
+.cc-line.waits .cc-card { border-color: color-mix(in srgb, var(--hot) 45%, var(--panel-border)); }
+.cc-card-title { margin: 0; font: 600 15px/1.35 var(--body); color: var(--ink); display: flex; gap: 10px; align-items: baseline; justify-content: space-between; flex-wrap: wrap; overflow-wrap: anywhere; }
+.cc-card-line { margin: 3px 0 0; font-size: 14px; line-height: 1.45; color: var(--sub); overflow-wrap: anywhere; white-space: pre-wrap; }
+.cc-quote { display: block; width: 100%; text-align: left; margin: 0 0 8px; padding: 6px 10px; border-left: 3px solid var(--gold); background: var(--qopen); border-radius: 6px;
+  font-size: 13px; color: var(--sub); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.cc-answer { margin-top: 6px; font-size: 15px; line-height: 1.5; color: var(--ink); overflow-wrap: anywhere; }
+.cc-answer p { margin: 0 0 0.6em; }
+.cc-answer p:last-child { margin-bottom: 0; }
+.cc-wait { color: var(--sub); font-size: 14px; }
+.cc-acts { display: flex; flex-wrap: wrap; align-items: center; gap: 4px 14px; margin-top: 10px; }
+.cc-acts:empty { display: none; }
+.cc-text-btn { min-height: 36px; font-size: 14px; font-weight: 500; color: var(--ink); }
+.cc-choices { list-style: none; margin: 10px 0 0; padding: 0; display: grid; gap: 2px; }
+.cc-choice { display: flex; align-items: center; gap: 10px; width: 100%; min-height: 40px; padding: 4px 0; text-align: left; font: 600 14.5px/1.3 var(--body); color: var(--ink); }
+.cc-choice-n { flex: none; width: 24px; height: 24px; border-radius: 6px; border: 1px solid var(--panel-border); display: grid; place-items: center; font: 500 12px/1 var(--mono); color: var(--sub); }
+.cc-move { margin-top: 10px; padding-top: 8px; border-top: 1px solid var(--hairline); }
+.cc-move .cc-choice { font-weight: 500; }
+.cc-fine { margin: 8px 0 0; font-size: 12.5px; color: var(--tertiary); }
+.cc-fine.warn { color: var(--hot); }
+.cc-steer { display: flex; gap: 8px; margin-top: 10px; }
+.cc-steer .field { flex: 1; min-width: 0; height: 36px; }
+
+/* ── the composer: two visible buttons, no key needed ─── */
+.cc-composer { position: sticky; bottom: 0; z-index: 5; background: var(--page); border-top: 1px solid var(--hairline); padding: 10px 0 calc(10px + var(--safe-bottom, env(safe-area-inset-bottom, 0px)));
+  display: grid; grid-template-columns: minmax(0, 1fr) auto; gap: 8px 10px; align-items: end; }
+.cc-input { min-height: 44px; max-height: 140px; padding: 11px 12px; font-size: 16px; border-radius: 12px; }
+.cc-buttons { display: flex; gap: 8px; }
+.cc-buttons .cx-btn { height: 44px; padding: 0 16px; font-size: 15px; border-radius: 12px; }
+.cc-drop { background: transparent; border: 1.5px solid var(--accent); color: var(--accent); }
+.cc-foot { grid-column: 1 / -1; display: flex; flex-wrap: wrap; align-items: center; gap: 4px 14px; font-size: 12px; color: var(--tertiary); }
+.cc-model { display: inline-flex; align-items: center; gap: 6px; font-size: 12px; color: var(--sub); }
+.cc-model .field { width: auto; height: 34px; min-height: 34px; padding: 0 30px 0 10px; font-size: 13px; background-position: calc(100% - 17px) 14px, calc(100% - 12px) 14px; }
+.cc-hint { flex: 1; min-width: 180px; }
+.cc-note { grid-column: 1 / -1; margin: 0; font-size: 13px; color: var(--hot); }
+/* A phone at 390 px: the box on its own row, the buttons under it, the menus under those. */
+@media (max-width: 480px) {
+  .cc-composer { grid-template-columns: minmax(0, 1fr); }
+  .cc-buttons { justify-content: flex-end; }
+  .cc-buttons .cx-btn { flex: 1; justify-content: center; }
+  .cc-buttons .cc-attach { flex: none; }
+}
+
+/* ── 6.99.12: the menus, the clip and the chips ───────── */
+.cc-menus { display: inline-flex; flex-wrap: wrap; gap: 6px 12px; }
+.cc-menus:empty { display: none; }
+.cc-attach { position: relative; width: 44px; padding: 0; justify-content: center; cursor: pointer; }
+.cc-buttons .cc-attach { height: 44px; border-radius: 12px; }
+.cc-attach .icon { width: 19px; height: 19px; }
+.cc-attach:focus-within { outline: 2px solid var(--accent); outline-offset: 2px; }
+.cc-attach.full { opacity: 0.45; cursor: default; }
+/* The real file input fills the clip, invisible, so a tap on iOS reaches it (Camera, Photo Library, Files). */
+.cc-file { position: absolute; inset: 0; width: 100%; height: 100%; opacity: 0; cursor: pointer; font-size: 0; }
+.cc-file:disabled { cursor: default; }
+.cc-chips { grid-column: 1 / -1; display: flex; flex-wrap: wrap; gap: 8px; }
+.cc-chips.hidden { display: none; }
+.cc-chip { position: relative; display: flex; align-items: center; gap: 8px; max-width: 100%; min-width: 0; flex: 0 1 236px; padding: 6px 4px 6px 6px;
+  border: 1px solid var(--panel-border); border-radius: 12px; background: var(--panel); overflow: hidden; }
+.cc-chip.failed { border-color: color-mix(in srgb, var(--hot) 55%, var(--panel-border)); }
+.cc-chip-thumb { flex: none; width: 40px; height: 40px; border-radius: 8px; overflow: hidden; display: grid; place-items: center; background: var(--qopen); color: var(--sub); }
+.cc-chip-thumb img { width: 100%; height: 100%; object-fit: cover; display: block; }
+.cc-chip-thumb .icon { width: 20px; height: 20px; }
+.cc-chip-text { min-width: 0; flex: 1; display: flex; flex-direction: column; gap: 2px; }
+.cc-chip-name { font: 500 13px/1.25 var(--body); color: var(--ink); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.cc-chip-meta { font-size: 12px; line-height: 1.2; color: var(--tertiary); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.cc-chip.failed .cc-chip-meta { color: var(--hot); }
+.cc-chip-retry { flex: none; min-height: 36px; padding: 0 4px; font-size: 13px; font-weight: 600; }
+.cc-chip-x { flex: none; width: 36px; height: 36px; border-radius: 9px; display: grid; place-items: center; color: var(--sub); font-size: 20px; line-height: 1; }
+.cc-chip-x:hover { background: var(--qopen); color: var(--ink); }
+.cc-chip-bar { position: absolute; left: 0; bottom: 0; height: 3px; background: var(--accent); transition: width 160ms ease-out; }
+.cc-composer.dragging { outline: 2px dashed var(--accent); outline-offset: 4px; border-radius: 12px; }
+
+/* What went with an Ask: the photo itself, or the file's kind and name. */
+.cc-sent-atts { display: flex; flex-wrap: wrap; justify-content: flex-end; gap: 6px; margin-top: 6px; max-width: min(80%, 560px); }
+.cc-sent-att { display: inline-flex; align-items: center; gap: 6px; height: 56px; min-width: 56px; padding: 0; border-radius: 10px; overflow: hidden;
+  border: 1px solid var(--panel-border); background: var(--panel); color: var(--sub); font-size: 12px; }
+.cc-sent-att img { width: 56px; height: 56px; object-fit: cover; display: block; }
+.cc-sent-att .icon { width: 18px; height: 18px; margin-left: 10px; flex: none; }
+.cc-sent-name { padding-right: 10px; max-width: 150px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; color: var(--ink); }
+
+/* ── 6.99.12: Reply in the message reader ─────────────── */
+.cx-reply { margin-top: 18px; padding-top: 14px; border-top: 1px solid var(--hairline); }
+.cx-reply-title { margin: 0; font: 600 16px/1.3 var(--body); color: var(--ink); }
+.cx-reply-sub { margin: 2px 0 0; font-size: 13px; line-height: 1.4; color: var(--sub); }
+.cx-reply-feed { min-height: 0; padding: 10px 0 0; }
+.cx-reply-feed:empty { display: none; }
+.cx-reply .cc-composer { position: static; background: transparent; border-top: 0; padding: 10px 0 0; }
+
+/* ── the Messages badge in the rail and the section menu ─ */
+.inbox-count { min-width: 18px; height: 18px; padding: 0 5px; border-radius: 9px; background: var(--hot); color: var(--panel); font: 600 11px/18px var(--body); text-align: center; }
+.inbox-dot { width: 8px; height: 8px; border-radius: 50%; background: var(--accent); }
+.inbox-count.hidden, .inbox-dot.hidden { display: none; }
+#section-menu .inbox-count, #section-menu .inbox-dot { flex: none; margin-left: 8px; }
+@media (min-width: 600px) {
+  .rail-btn .inbox-count { position: absolute; top: 3px; right: 8px; }
+  .rail-btn .inbox-dot { position: absolute; top: 7px; right: 15px; }
+}
+@media (min-width: 1100px) {
+  .rail-btn .inbox-count, .rail-btn .inbox-dot { position: static; margin: 2px 0 0 auto; flex: none; }
+}
+
+/* ── 6.99.13: a drop's files, under your words and on its receipt ── */
+.cc-dfiles { display: flex; flex-direction: column; gap: 6px; margin-top: 8px; }
+.cc-dfiles.mine { align-items: flex-end; max-width: min(80%, 560px); margin-top: 6px; }
+.cc-dfile { display: flex; align-items: center; gap: 10px; min-height: 44px; max-width: 100%; min-width: 0; padding: 4px 12px 4px 4px;
+  border: 1px solid var(--panel-border); border-radius: 12px; background: var(--panel); color: var(--ink); text-decoration: none; }
+.cc-dfile:hover { background: var(--qopen); }
+.cc-dfile:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+.cc-dfile-thumb { flex: none; width: 36px; height: 36px; border-radius: 8px; overflow: hidden; display: grid; place-items: center; background: var(--qopen); color: var(--sub); }
+.cc-dfile-thumb img { width: 100%; height: 100%; object-fit: cover; display: block; }
+.cc-dfile-thumb .icon { width: 18px; height: 18px; }
+.cc-dfile-name { min-width: 0; flex: 1; font: 500 13.5px/1.3 var(--body); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.cc-dfile-open { flex: none; font: 600 13px/1 var(--body); color: var(--accent); }
+
+/* 6.99.16: the COS thread's one quiet line, under the title row. */
+.cc-thread { flex-basis: 100%; margin: 0; font-size: 12.5px; line-height: 1.35; color: var(--tertiary); }
+.cc-thread:empty { display: none; }