@uuaid/agent-commons 0.0.0 → 0.2.0-alpha.4

package/src/config.mjs

@@ -0,0 +1,40 @@
+import { mkdirSync, readFileSync, writeFileSync, existsSync, chmodSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { homedir } from "node:os";
+import { randomBytes } from "node:crypto";
+import { Keychain } from "./pillar.mjs";
+import { createProfile } from "./profiles.mjs";
+import { CommonsStore } from "./store.mjs";
+import { AgentCommons } from "./runtime.mjs";
+import { mintNamespace, RUNTIME_UUAID_NAMESPACE } from "./uuaid-namespace.mjs";
+
+export const CAPABILITIES=["commons:message","commons:relay","commons:evolve","commons:contribute","commons:recover"];
+export function homePath(path){return resolve(path??join(homedir(),".agent-commons"))}
+export function saveConfig(home,config){writeFileSync(join(home,"config.json"),JSON.stringify(config,null,2),{mode:0o600});chmodSync(join(home,"config.json"),0o600)}
+export function initialize({home,target="local",name="Agent Commons"}={}){
+  home=homePath(home);mkdirSync(home,{recursive:true,mode:0o700});
+  if(existsSync(join(home,"config.json"))||existsSync(join(home,"identity.json")))throw new Error("Home already initialized or contains an identity; existing identity was not overwritten");
+  // Preserve old prerelease invocations, but all new target configuration uses
+  // the production-domain spelling confirmed by the owner.
+  if(target==="zilligons.com")target="zilligon.com";
+  if(!["local","agentnet.chat","zilligon.com"].includes(target))throw new Error("Supported deployment targets: local, agentnet.chat, zilligon.com");
+  const passphrase=process.env.AGENT_COMMONS_PASSPHRASE??randomBytes(32).toString("base64url");
+  if(!process.env.AGENT_COMMONS_PASSPHRASE)writeFileSync(join(home,"local-secret"),passphrase,{mode:0o600});
+  const keychain=new Keychain(join(home,"identity.json"));keychain.save(Keychain.generate({uuaidNamespace:mintNamespace(RUNTIME_UUAID_NAMESPACE)}),{passphrase});
+  const identity=keychain.publicView();
+  const config={version:1,name,target,role:"host",carriers:[],policy:{mode:"local",offline:true,registryUrl:"https://api.uuaid.org",authorityUrl:"https://authority.iaaso.org",standardPins:{},blocked:[],agents:{[identity.uuaid]:{kind:"agent",publicKey:identity.publicKeyHex,capabilities:CAPABILITIES}}}};
+  saveConfig(home,config);
+  const store=new CommonsStore(join(home,"commons.db"));
+  const template=JSON.parse(readFileSync(new URL(`../profiles/${target==="local"?"local":target}.json`,import.meta.url),"utf8"));
+  const profile=createProfile(template);
+  const runtime=new AgentCommons({keychain,store,policy:config.policy});runtime.addProfile(profile);store.close();
+  return {home,identity,target,profileId:profile.id,registryRegistration:"not-performed",certified:false,keyProtection:process.env.AGENT_COMMONS_PASSPHRASE?"environment-passphrase":"file-permissions-with-colocated-local-secret"};
+}
+export function loadRuntime(home){
+  home=homePath(home);
+  const config=JSON.parse(readFileSync(join(home,"config.json"),"utf8"));
+  const passphrase=process.env.AGENT_COMMONS_PASSPHRASE??readFileSync(join(home,"local-secret"),"utf8");
+  const keychain=new Keychain(join(home,"identity.json"));keychain.load({passphrase});
+  const store=new CommonsStore(join(home,"commons.db"));
+  return {home,config,keychain,store,runtime:new AgentCommons({keychain,store,policy:config.policy,carriers:config.carriers})};
+}

package/src/continuity.d.mts

@@ -0,0 +1,24 @@
+export type ProvenanceSource = "self"|"peer"|"operator"|"tool";
+export interface ContinuityStore {get(key:string,fallback?:unknown):any;set(key:string,value:unknown):void;transaction?<T>(fn:()=>T):T}
+export interface MemoryKeychain {_identity:{uuaid:string;publicKeyHex:string};sign(bytes:Buffer):Buffer}
+export interface MemoryClient {saveMemory(agent:string,slot:string,text:string,key:string):Promise<any>;loadMemory(agent:string,slot:string,key:string):Promise<string>}
+export interface ContinuityEntry {id:string;seq:number;kind:string;content:any;hash:string;signature:string;at:string;provenance:any}
+export interface ContinuityOptions {keychain:MemoryKeychain;store?:ContinuityStore;client?:MemoryClient|null;vaultKey?:string|null;slot?:string;limits?:{maxEntries?:number;maxBytes?:number;maxEntryBytes?:number;retentionMs?:number};now?:()=>number}
+export declare class ContinuityMemory {
+  constructor(options:ContinuityOptions);
+  readonly uuaid:string;readonly publicKey:string;
+  remember(kind:string,content:unknown,provenance?:{source?:ProvenanceSource;actor?:string;origin?:string|null;evidence?:string|null;pin?:boolean}):ContinuityEntry;
+  recall(filter?:{kind?:string;since?:string;source?:ProvenanceSource;limit?:number}):ContinuityEntry[];
+  verify():boolean;head():string;status():any;
+  snapshot():any;
+  reload():any;compact():any;expired():any;
+  push():Promise<any>;pull():Promise<any>;sync():Promise<any>;
+  static storeKey(uuaid:string):string;
+  static quarantine(store:ContinuityStore,uuaid:string):string|null;
+}
+export declare class ContinuityError extends Error {code:string}
+export declare class MemoryContinuityStore implements ContinuityStore {get(key:string,fallback?:unknown):any;set(key:string,value:unknown):void;transaction<T>(fn:()=>T):T}
+export declare const CONTINUITY_PROTOCOL:string;
+export declare const PROVENANCE_SOURCES:readonly ProvenanceSource[];
+export declare function validateSlot(slot:string):string;
+export declare function verifyContinuity(state:unknown,owner:unknown,options?:any):any;