agent-policy-kit 0.1.0 → 0.2.0

package/src/share.mjs

@@ -1,6 +1,6 @@
 // Pure URL state codec, also embedded in the offline configuration page.
 const SHARE_BYTES=65536,SHARE_TOKEN=87384;
-const SHARE_VERSION=/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;
+const SHARE_VERSION=/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*)?$/;
 const SHARE_UNSAFE=new Set(['__proto__','constructor','prototype']);
 function invalidShare(){throw Object.assign(new Error('Invalid shared configuration link.'),{code:'INVALID_SHARE_LINK'});}
 
@@ -46,46 +46,67 @@ function shareRelease(release){
  }
  for(const preset of release.presets){
   shareRecord(preset);if(typeof preset.id!=='string'||!preset.id||preset.id==='custom'||SHARE_UNSAFE.has(preset.id)||presets.has(preset.id))invalidShare();
-  shareRecord(shareRecord(preset.preferences).clients);presets.set(preset.id,preset);
+  shareRecord(shareRecord(preset.preferences).clients);
+  if(preset.topModels!==undefined&&Object.values(shareRecord(preset.topModels)).some(model=>typeof model!=='string'))invalidShare();
+  presets.set(preset.id,preset);
  }
  if(!presets.has(release.preset))invalidShare();
  return {clients,roles,presets,catalog};
 }
 function shareChoice(choice,id,metadata){
  shareRecord(choice,['model','effort']);
- if(typeof choice.model!=='string'||choice.model.length>128||(choice.effort!==null&&(id==='agy'||!metadata.catalog[id].efforts.includes(choice.effort))))invalidShare();
+ if(typeof choice.model!=='string'||choice.model.length>128||(choice.effort!==null&&(['agy','grok'].includes(id)||!metadata.catalog[id].efforts.includes(choice.effort))))invalidShare();
  return {model:choice.model,effort:choice.effort};
 }
 function sharePayload(payload,release,metadata){
- shareRecord(payload,['v','release','roles','tools','scope','maxConcurrent']);
- if(payload.v!==1||typeof payload.release!=='string'||!SHARE_VERSION.test(payload.release))invalidShare();
- if(payload.release!==release.version)throw Object.assign(new Error('This link uses a different release.'),{code:'SHARE_RELEASE_MISMATCH'});
- if(!Number.isInteger(payload.maxConcurrent)||payload.maxConcurrent<1||payload.maxConcurrent>32)invalidShare();
+ shareRecord(payload);const legacy=payload.v===1;
+ if(!legacy&&payload.v!==2)invalidShare();
+ shareRecord(payload,legacy?['v','release','roles','tools','scope','maxConcurrent']:['v','release','roles','tools','scope']);
+ if(typeof payload.release!=='string'||payload.release.length>128||!SHARE_VERSION.test(payload.release))invalidShare();
+ if(legacy&&(!Number.isInteger(payload.maxConcurrent)||payload.maxConcurrent<1||payload.maxConcurrent>32))invalidShare();
+ if(payload.release!==release.version){
+  // Validate the wire shape without imposing today's models or preset values on
+  // an older release. Invalid links must never turn into navigation.
+  const identifier=value=>typeof value==='string'&&/^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/.test(value);
+  if(!Array.isArray(payload.roles)||payload.roles.length>1000||payload.roles.some(role=>!identifier(role)))invalidShare();
+  const roles=shareList(payload.roles,payload.roles),ids=[];
+  if(!Array.isArray(payload.tools)||payload.tools.length>32)invalidShare();
+  for(const tool of payload.tools){
+   shareRecord(tool,legacy?['id','mode','base','choices']:['id','mode','base','choices','maxConcurrent']);if(!legacy&&(!Number.isInteger(tool.maxConcurrent)||tool.maxConcurrent<1||tool.maxConcurrent>32))invalidShare();if(!identifier(tool.id)||ids.includes(tool.id)||!identifier(tool.base)||(tool.mode!==null&&!identifier(tool.mode)))invalidShare();ids.push(tool.id);
+   shareRecord(tool.choices,roles);for(const role of roles){const choice=shareRecord(tool.choices[role],['model','effort']);if(typeof choice.model!=='string'||choice.model.length>128||(choice.effort!==null&&(typeof choice.effort!=='string'||choice.effort.length>32)))invalidShare();}
+  }
+  if(payload.scope!==null&&(typeof payload.scope!=='string'||(payload.scope==='all'?ids.length<2:!ids.includes(payload.scope))))invalidShare();
+  throw Object.assign(new Error('This link uses a different release.'),{code:'SHARE_RELEASE_MISMATCH',releaseVersion:payload.release});
+ }
  const roles=shareList(payload.roles,[...metadata.roles.keys()]);
  if(!Array.isArray(payload.tools)||payload.tools.length>metadata.clients.length)invalidShare();
  const selected=[];
  const tools=payload.tools.map(tool=>{
-  shareRecord(tool,['id','mode','base','choices']);
+  shareRecord(tool,legacy?['id','mode','base','choices']:['id','mode','base','choices','maxConcurrent']);if(!legacy&&(!Number.isInteger(tool.maxConcurrent)||tool.maxConcurrent<1||tool.maxConcurrent>32))invalidShare();
   const {id,mode,base}=tool;
   if(!metadata.clients.includes(id)||selected.includes(id)||!metadata.presets.has(base)||(mode!==null&&mode!=='custom'&&!metadata.presets.has(mode)))invalidShare();
   selected.push(id);shareRecord(tool.choices,roles);
   const choices=Object.fromEntries(roles.map(role=>[role,shareChoice(tool.choices[role],id,metadata)]));
   if(mode!==null&&mode!=='custom'){
    if(mode!==base)invalidShare();
-   const clients=metadata.presets.get(mode).preferences.clients;
+   const named=metadata.presets.get(mode),preset=named.preferences,clients=preset.clients;
+   if(!legacy&&tool.maxConcurrent!==(clients[id]?.maxConcurrent??preset.maxConcurrent))invalidShare();
    if(!Object.hasOwn(clients,id))invalidShare();
-   const preferences=shareRecord(clients[id]);
+   const preferences=shareRecord(clients[id]),own=role=>preferences.roles&&Object.hasOwn(preferences.roles,role);
+   // A preset's optional top model replaces every shared code role that has no role-specific choice, or none of them.
+   const top=named.topModels&&Object.hasOwn(named.topModels,id)?named.topModels[id]:null;
+   const topRoles=roles.filter(role=>metadata.roles.get(role).kind==='code'&&!own(role)),topped=top!==null&&topRoles.some(role=>choices[role].model===top);
    for(const role of roles){
-    const expected=preferences.roles&&Object.hasOwn(preferences.roles,role)?preferences.roles[role]:preferences[metadata.roles.get(role).kind];
-    const choice=shareChoice(expected,id,metadata);
+    const expected=own(role)?preferences.roles[role]:preferences[metadata.roles.get(role).kind];
+    const choice=shareChoice(expected,id,metadata);if(topped&&topRoles.includes(role))choice.model=top;
     if(choice.model!==choices[role].model||choice.effort!==choices[role].effort)invalidShare();
    }
   }
-  return {id,mode,base,choices};
+  return {id,mode,base,choices,...(legacy?{}:{maxConcurrent:tool.maxConcurrent})};
  });
  const scope=payload.scope;
  if(scope!==null&&(typeof scope!=='string'||(scope==='all'?tools.length<2:!selected.includes(scope))))invalidShare();
- return {v:1,release:payload.release,roles,tools,scope,maxConcurrent:payload.maxConcurrent};
+ return {v:payload.v,release:payload.release,roles,tools,scope,...(legacy?{maxConcurrent:payload.maxConcurrent}:{})};
 }
 function shareBase64(bytes){return btoa(Array.from(bytes,byte=>String.fromCharCode(byte)).join('')).replaceAll('+','-').replaceAll('/','_').replace(/=+$/,'');}
 function shareJson(text){
@@ -111,15 +132,16 @@ export function encodeFormState(snapshot,release){
   shareData(snapshot);shareRecord(snapshot);
   const metadata=shareRelease(release),state=shareRecord(snapshot.state),profiles=shareRecord(state.profiles),jobs=shareRecord(state.jobs);
   const roles=shareList(snapshot.helpers,[...metadata.roles.keys()]),selected=shareList(snapshot.pickedTools,metadata.clients);
+  const modern=Object.values(profiles).some(profile=>Object.hasOwn(profile,'maxConcurrent'));
   const tools=selected.map(id=>{
    if(!Object.hasOwn(profiles,id)||!Object.hasOwn(jobs,id))invalidShare();
    const profile=shareRecord(profiles[id]),choices=shareRecord(jobs[id]);
    if(typeof profile.custom!=='boolean'||(profile.modeSelected!==undefined&&typeof profile.modeSelected!=='boolean'))invalidShare();
-   return {id,mode:profile.modeSelected===false?null:profile.custom?'custom':profile.presetId,base:profile.presetId,choices:Object.fromEntries(roles.map(role=>{
+   return {id,...(modern?{maxConcurrent:Object.hasOwn(profile,'maxConcurrent')?profile.maxConcurrent:state.maxConcurrent}:{}),mode:profile.modeSelected===false?null:profile.custom?'custom':profile.presetId,base:profile.presetId,choices:Object.fromEntries(roles.map(role=>{
     if(!Object.hasOwn(choices,role))invalidShare();return [role,shareChoice(choices[role],id,metadata)];
    }))};
   });
-  const payload=sharePayload({v:1,release:release.version,roles,tools,scope:snapshot.selectedScope,maxConcurrent:state.maxConcurrent},release,metadata);
+  const payload=sharePayload({v:modern?2:1,release:release.version,roles,tools,scope:snapshot.selectedScope,...(modern?{}:{maxConcurrent:state.maxConcurrent})},release,metadata);
   if(!roles.length&&!tools.length)return '';
   const bytes=new TextEncoder().encode(JSON.stringify(payload));if(bytes.length>SHARE_BYTES)invalidShare();
   const token=shareBase64(bytes);if(token.length>SHARE_TOKEN)invalidShare();return '#setup='+token;
@@ -139,3 +161,12 @@ export function decodeFormState(fragment,release){
   return sharePayload(payload,release,shareRelease(release));
  }catch(error){if(error?.code==='INVALID_SHARE_LINK'||error?.code==='SHARE_RELEASE_MISMATCH')throw error;invalidShare();}
 }
+
+export function archivedReleaseUrl(error,href,hostedReleases=[]){
+ if(error?.code!=='SHARE_RELEASE_MISMATCH'||typeof error.releaseVersion!=='string'||error.releaseVersion.length>128||!SHARE_VERSION.test(error.releaseVersion)||!Array.isArray(hostedReleases)||!hostedReleases.includes(error.releaseVersion))return null;
+ try{
+  const current=new URL(href);if(!['http:','https:'].includes(current.protocol)||current.username||current.password||current.pathname!=='/'||!current.hash.startsWith('#setup='))return null;
+  const target=new URL(`/v/${error.releaseVersion}/`,current.origin);target.hash=current.hash;
+  return target.origin===current.origin?target.href:null;
+ }catch{return null;}
+}