@staix/agent-hub 0.29.0 → 0.30.0

package/docs/verification/pi-150-model-free.ts

@@ -0,0 +1,57 @@
+import {mkdtempSync, mkdirSync, readFileSync} from 'node:fs';
+import {join, resolve} from 'node:path';
+import {homedir} from 'node:os';
+import {fileURLToPath} from 'node:url';
+import assert from 'node:assert/strict';
+const launcher=resolve(process.argv[2] ?? join(homedir(),'.pi/agent/bin/pi'));
+const packageRoot=resolve(process.argv[3] ?? join(homedir(),'.pi/agent/install/releases/1.5.0/node_modules/@earendil-works/pi-coding-agent'));
+const extension=fileURLToPath(new URL('../../src/pi/extension.ts',import.meta.url));
+const driver=fileURLToPath(new URL('./pi-150-native.mjs',import.meta.url));
+import {PiToolReceipts} from '../../src/pi/tool-receipts.ts';
+const home=mkdtempSync('/tmp/ahub-684-pi-native-home.'); mkdirSync(join(home,'agent'));
+const pkg=JSON.parse(readFileSync(join(packageRoot,'package.json'),'utf8'));
+assert.equal(pkg.name,'@earendil-works/pi-coding-agent');assert.equal(pkg.version,'1.5.0');
+const version=Bun.spawn([launcher,'--version'],{cwd:home,env:{HOME:home,PATH:process.env.PATH!,PI_CODING_AGENT_DIR:join(home,'agent')},stdin:'ignore',stdout:'pipe',stderr:'pipe'});
+const versionTimer=setTimeout(()=>version.kill(),10000);
+const [versionCode,versionOut,versionErr]=await Promise.all([version.exited,new Response(version.stdout).text(),new Response(version.stderr).text()]);clearTimeout(versionTimer);
+assert.equal(versionCode,0);assert.equal(versionOut.trim(),'1.5.0');assert.equal(versionErr,'');
+const ledger=new PiToolReceipts(join(home,'hub.db'));
+let effects=0, providers=0; const events:any[]=[];
+const bridge=Bun.serve({hostname:'127.0.0.1',port:0,async fetch(req){
+ const url=new URL(req.url); if(req.headers.get('authorization')!=='Bearer fixture')return new Response('forbidden',{status:403});
+ if(url.pathname==='/commands') {await Bun.sleep(25);return Response.json({command:null});}
+ const body=await req.json() as any;
+ if(url.pathname==='/event'){events.push(body.type);return Response.json({ok:true});}
+ if(url.pathname==='/budget')return Response.json({decisions:[]});
+ if(url.pathname==='/tool') {
+  const text=await ledger.execute(body.sessionId,body.toolCallId,body.name,body.args,async()=>{
+   if(body.args.value==='deny')return 'error: fixture permission denied';
+   effects++;return 'fixture success';
+  });
+  return Response.json({text,failed:text.startsWith('error:')});
+ }
+ providers++;return new Response('provider forbidden',{status:500});
+}});
+const env={HOME:home,PATH:process.env.PATH!,PI_CODING_AGENT_DIR:join(home,'agent'),HUB_EXTENSION:extension,PI_COMPAT_PACKAGE:packageRoot,
+ AGENTHUB_PI_BRIDGE_URL:`http://127.0.0.1:${bridge.port}`,AGENTHUB_PI_BRIDGE_TOKEN:'fixture',AGENTHUB_PI_OWNER_TOKEN:'fixture',
+ AGENTHUB_PI_TOOLS:JSON.stringify([{name:'compat_probe',description:'model-free fixture',parameters:{type:'object',properties:{value:{type:'string'}},required:['value']}}])};
+const child=Bun.spawn(['node',driver],{cwd:home,env,stdin:'ignore',stdout:'pipe',stderr:'pipe'});
+const timer=setTimeout(()=>child.kill(),10000);
+const [code,stdout,stderr]=await Promise.all([child.exited,new Response(child.stdout).text(),new Response(child.stderr).text()]);clearTimeout(timer);
+console.log(JSON.stringify({code,stdout,stderr,effects,providers,events,isolatedHome:home}));
+const native=Bun.spawn([launcher,'--mode','rpc','--provider','agent-hub-local','--model','fixture','--no-builtin-tools','--no-skills','--no-prompt-templates','--no-extensions','--extension',env.HUB_EXTENSION,'--session-dir',join(home,'native-sessions')],{
+ cwd:home,env:{...env,AGENTHUB_PI_RELAY_URL:`http://127.0.0.1:${bridge.port}/v1`,AGENTHUB_PI_RELAY_TOKEN:'fixture',AGENTHUB_PI_MODELS:JSON.stringify([{id:'fixture',name:'fixture'}])},stdin:'pipe',stdout:'pipe',stderr:'pipe'});
+native.stdin.write(JSON.stringify({id:'probe',type:'get_state'})+'\n');
+const nativeTimer=setTimeout(()=>native.kill(),10000);
+let wire='';for await(const chunk of native.stdout){wire+=new TextDecoder().decode(chunk);if(wire.includes('"command":"get_state"')){native.kill();break;}}
+await native.exited;clearTimeout(nativeTimer);const nativeErr=await new Response(native.stderr).text();
+console.log(JSON.stringify({nativeRpc:wire,nativeStderr:nativeErr,providers,events}));
+bridge.stop(true);await ledger.close();
+assert.equal(code,0);assert.equal(stderr,'');
+const result=JSON.parse(stdout);
+assert.equal(result.extension,'loaded');assert.equal(result.first.isError,false);assert.deepEqual(result.first,result.replay);assert.equal(result.denied.isError,true);
+assert.equal(effects,1);assert.equal(providers,0);assert.equal(nativeErr,'');
+const state=wire.trim().split('\n').map(line=>JSON.parse(line)).find(item=>item.command==='get_state');
+assert.equal(state?.success,true);assert.equal(state.data.messageCount,0);assert.ok(state.data.sessionId);assert.ok(state.data.sessionFile);
+assert.ok(events.includes('session_start'));assert.ok(events.includes('session_shutdown'));
+console.log('pi 1.5.0 model-free receipt: PASS');

package/docs/verification/pi-150-native.mjs

@@ -0,0 +1,21 @@
+import { pathToFileURL } from 'node:url';
+const { createAgentSession, DefaultResourceLoader, SessionManager, SettingsManager } = await import(pathToFileURL(`${process.env.PI_COMPAT_PACKAGE}/dist/index.js`).href);
+const cwd = process.env.HOME;
+const settingsManager = SettingsManager.create(cwd, process.env.PI_CODING_AGENT_DIR);
+const loader = new DefaultResourceLoader({cwd, agentDir:process.env.PI_CODING_AGENT_DIR, settingsManager,
+  noExtensions:true, additionalExtensionPaths:[process.env.HUB_EXTENSION], noSkills:true, noPromptTemplates:true, noThemes:true});
+await loader.reload();
+const {session, extensionsResult} = await createAgentSession({cwd, agentDir:process.env.PI_CODING_AGENT_DIR,
+  resourceLoader:loader, settingsManager, sessionManager:SessionManager.create(cwd, `${cwd}/sessions`), noTools:'builtin'});
+if (extensionsResult.errors.length) throw new Error(JSON.stringify(extensionsResult.errors));
+await session.bindExtensions({mode:'rpc'});
+const tool = session.extensionRunner.getAllRegisteredTools().find(t=>t.definition.name==='compat_probe');
+if (!tool) throw new Error('hub extension tool not registered');
+const invoke = async (id, args) => tool.definition.execute(id, args, new AbortController().signal);
+const first = await invoke('same-call', {value:'fixture'});
+const replay = await invoke('same-call', {value:'fixture'});
+const denied = await invoke('denied-call', {value:'deny'});
+console.log(JSON.stringify({extension:'loaded',first,replay,denied,tools:session.getActiveToolNames()}));
+await session.extensionRunner.emit({type:'session_shutdown'});
+session.dispose();
+process.exit(0);

package/docs/verification/pi-150-title-api.mjs

@@ -0,0 +1,31 @@
+import assert from 'node:assert/strict';
+import {pathToFileURL} from 'node:url';
+import {writeFileSync,readFileSync} from 'node:fs';
+import {userInfo} from 'node:os';
+const root=process.env.PI_TITLE_PACKAGE;
+assert.equal(JSON.parse(readFileSync(`${root}/package.json`)).version,'1.5.0');
+const cwd=process.env.HOME, agentDir=process.env.PI_CODING_AGENT_DIR;
+assert.ok(cwd && cwd !== userInfo().homedir, 'fresh isolated HOME required');
+assert.equal(process.cwd(),cwd,'run from disposable HOME');
+assert.ok(agentDir?.startsWith(`${cwd}/`),'tool home must be inside disposable HOME');
+const {createAgentSession,DefaultResourceLoader,SessionManager,SettingsManager}=await import(pathToFileURL(`${root}/dist/index.js`));
+const extension=`${cwd}/title-extension.mjs`;
+writeFileSync(extension,`export default function(pi) { let observedName; pi.on('session_info_changed',event=>{observedName=event.name;}); pi.registerTool({name:'title_probe', label:'Title probe',description:'Model-free title API probe',parameters:{type:'object',properties:{}},async execute(){ const before=pi.getSessionName(); pi.setSessionName('Fixture session title'); const after=pi.getSessionName(); return {content:[{type:'text',text:JSON.stringify({before:before??null,after,observedName})}],details:{}}; }}); }`);
+const settingsManager=SettingsManager.create(cwd,agentDir);
+const loader=new DefaultResourceLoader({cwd,agentDir,settingsManager,noExtensions:true,additionalExtensionPaths:[extension],noSkills:true,noPromptTemplates:true,noThemes:true});
+await loader.reload();
+const manager=SessionManager.create(cwd,`${cwd}/sessions`);
+manager.appendMessage({role:'user',content:[{type:'text',text:'Synthetic session persistence fixture; never sent to a model.'}],timestamp:Date.now()});
+const {session,extensionsResult}=await createAgentSession({cwd,agentDir,settingsManager,resourceLoader:loader,sessionManager:manager,noTools:'builtin'});
+assert.deepEqual(extensionsResult.errors,[]);
+await session.bindExtensions({mode:'rpc'});
+const tool=session.extensionRunner.getAllRegisteredTools().find(t=>t.definition.name==='title_probe');
+assert.ok(tool);
+const result=await tool.definition.execute('probe',{},new AbortController().signal);
+assert.deepEqual(JSON.parse(result.content[0].text),{before:null,after:'Fixture session title',observedName:'Fixture session title'});
+assert.equal(manager.getSessionName(),'Fixture session title');
+assert.equal(session.sessionName,'Fixture session title');
+const file=manager.getSessionFile();
+session.dispose();
+assert.equal(SessionManager.open(file).getSessionName(),'Fixture session title');
+console.log(JSON.stringify({version:'1.5.0',setter:'ExtensionAPI.setSessionName(name: string): void',reader:'ExtensionAPI.getSessionName(): string | undefined',sessionReader:'SessionManager.getSessionName()',reopen:'PASS',nativeTitleEvent:'PASS',modelRequests:0,result:'PASS'}));

package/docs/verified.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "documents": {
     "README.md": {
-      "verifiedAgainst": "0d0a362c3db992cbbdf5bd1b03d6aba6bbc1e0b3",
+      "verifiedAgainst": "8612cfd740abd013689532d993ebc981548510bb",
       "paths": [
         "package.json",
         "src/",
@@ -11,14 +11,14 @@
       ]
     },
     "docs/security.md": {
-      "verifiedAgainst": "0d0a362c3db992cbbdf5bd1b03d6aba6bbc1e0b3",
+      "verifiedAgainst": "8612cfd740abd013689532d993ebc981548510bb",
       "paths": [
         "src/",
         "templates/"
       ]
     },
     "docs/operations.md": {
-      "verifiedAgainst": "0d0a362c3db992cbbdf5bd1b03d6aba6bbc1e0b3",
+      "verifiedAgainst": "8612cfd740abd013689532d993ebc981548510bb",
       "paths": [
         "package.json",
         "src/",
@@ -35,7 +35,7 @@
       ]
     },
     "docs/quickstart.md": {
-      "verifiedAgainst": "0d0a362c3db992cbbdf5bd1b03d6aba6bbc1e0b3",
+      "verifiedAgainst": "8612cfd740abd013689532d993ebc981548510bb",
       "paths": [
         "package.json",
         "src/",
@@ -43,7 +43,7 @@
       ]
     },
     "docs/agent-notes/adapters.md": {
-      "verifiedAgainst": "0d0a362c3db992cbbdf5bd1b03d6aba6bbc1e0b3",
+      "verifiedAgainst": "8612cfd740abd013689532d993ebc981548510bb",
       "paths": [
         "src/adapters/",
         "src/pi/",
@@ -81,7 +81,7 @@
       ]
     },
     "docs/agent-notes/benchmarks.md": {
-      "verifiedAgainst": "0d0a362c3db992cbbdf5bd1b03d6aba6bbc1e0b3",
+      "verifiedAgainst": "8612cfd740abd013689532d993ebc981548510bb",
       "paths": [
         "scripts/benchmarks/",
         "test/benchmarks/",
@@ -93,7 +93,7 @@
       ]
     },
     "docs/agent-notes/budget.md": {
-      "verifiedAgainst": "0d0a362c3db992cbbdf5bd1b03d6aba6bbc1e0b3",
+      "verifiedAgainst": "8612cfd740abd013689532d993ebc981548510bb",
       "paths": [
         "src/hub/budget.ts",
         "src/cli/statusline-tee.ts",
@@ -117,7 +117,7 @@
       ]
     },
     "docs/agent-notes/bus.md": {
-      "verifiedAgainst": "0d0a362c3db992cbbdf5bd1b03d6aba6bbc1e0b3",
+      "verifiedAgainst": "8612cfd740abd013689532d993ebc981548510bb",
       "paths": [
         "src/hub/bus.ts",
         "src/hub/envelope.ts",
@@ -132,7 +132,7 @@
       ]
     },
     "docs/agent-notes/daemon.md": {
-      "verifiedAgainst": "0d0a362c3db992cbbdf5bd1b03d6aba6bbc1e0b3",
+      "verifiedAgainst": "8612cfd740abd013689532d993ebc981548510bb",
       "paths": [
         "src/hub/daemon.ts",
         "src/hub/control-client.ts",
@@ -223,7 +223,7 @@
       ]
     },
     "docs/agent-notes/local-worker.md": {
-      "verifiedAgainst": "0d0a362c3db992cbbdf5bd1b03d6aba6bbc1e0b3",
+      "verifiedAgainst": "8612cfd740abd013689532d993ebc981548510bb",
       "paths": [
         "src/adapters/local-worker.ts",
         "src/local/",
@@ -243,7 +243,7 @@
       ]
     },
     "docs/agent-notes/tasks.md": {
-      "verifiedAgainst": "0d0a362c3db992cbbdf5bd1b03d6aba6bbc1e0b3",
+      "verifiedAgainst": "8612cfd740abd013689532d993ebc981548510bb",
       "paths": [
         "src/hub/tasks.ts",
         "src/hub/board.ts",
@@ -291,7 +291,7 @@
       ]
     },
     "docs/agent-notes/tests.md": {
-      "verifiedAgainst": "0d0a362c3db992cbbdf5bd1b03d6aba6bbc1e0b3",
+      "verifiedAgainst": "8612cfd740abd013689532d993ebc981548510bb",
       "paths": [
         "test/",
         "scripts/check.sh",
@@ -320,7 +320,7 @@
       ]
     },
     "docs/agent-notes/README.md": {
-      "verifiedAgainst": "0d0a362c3db992cbbdf5bd1b03d6aba6bbc1e0b3",
+      "verifiedAgainst": "8612cfd740abd013689532d993ebc981548510bb",
       "paths": [
         "src/cli/console-state.ts",
         "src/cli/attention.ts",
@@ -329,7 +329,7 @@
       ]
     },
     "src/cli/help.ts": {
-      "verifiedAgainst": "3efa678dd1e194e7e9f1f4e7059b61f802c3ad3f",
+      "verifiedAgainst": "8612cfd740abd013689532d993ebc981548510bb",
       "paths": [
         "src/cli/main.ts",
         "src/cli/launch.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@staix/agent-hub",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "description": "Native multi-agent hub: Claude Code, Codex, Kimi Code, Pi and local inference as peers in one project",
   "license": "MIT",
   "type": "module",
@@ -17,7 +17,7 @@
     "bun": ">=1.4.2"
   },
   "dependencies": {
-    "@staix/agent-mem": "0.20.0"
+    "@staix/agent-mem": "0.20.1"
   },
   "devDependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",

package/plugins/agent-hub/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-hub",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "description": "Channel between Claude Code and the agent-hub daemon: peer messages from Codex, Kimi and the local worker arrive as channel events; hub_send replies.",
   "author": {
     "name": "Young Joon Lee",