{"_id":"@calebux/agent-kit","_rev":"12-3abea232966c38c34064c50c0c549ce4","name":"@calebux/agent-kit","dist-tags":{"latest":"0.7.0"},"versions":{"0.1.0":{"name":"@calebux/agent-kit","version":"0.1.0","keywords":["stellar","soroban","agents","x402","multi-agent","orchestration","blockchain"],"license":"MIT","_id":"@calebux/agent-kit@0.1.0","maintainers":[{"name":"calebux","email":"Petersoncaleb275@gmail.com"}],"dist":{"shasum":"52c25b04380988f5d87def342992cd8901b76e76","tarball":"https://registry.npmjs.org/@calebux/agent-kit/-/agent-kit-0.1.0.tgz","fileCount":33,"integrity":"sha512-SyVcjfEVDxqmQ2JaLumy9HLmlOE0reQFyIk7WcktTIXKJo3Ix8grFJGau2aHwPseXE3uPVSQrI3yt7fw3L6Ynw==","signatures":[{"sig":"MEUCIQDULD6Nv3A8xvvLaigXpcQ8Yzf4M9iXxURUdMkHzuunTQIgcZK9lSYfO+sOlrF5gMhx7vpjElzw4RcoJoFlvCPu0gI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":66480},"main":"./dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"99c5f051c4babd6afa09bf81114da557195cd1e1","scripts":{"build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"calebux","email":"Petersoncaleb275@gmail.com"},"_npmVersion":"10.9.2","description":"Governed multi-agent orchestration on Stellar — wallet provisioning, Soroban spend caps, on-chain reputation, and x402 payments in one package","directories":{},"_nodeVersion":"22.17.0","dependencies":{"@aegis/shared":"*","@stellar/stellar-sdk":"^12.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0"},"_npmOperationalInternal":{"tmp":"tmp/agent-kit_0.1.0_1776113935022_0.4287279405203315","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@calebux/agent-kit","version":"0.1.1","keywords":["stellar","soroban","agents","x402","multi-agent","orchestration","blockchain"],"license":"MIT","_id":"@calebux/agent-kit@0.1.1","maintainers":[{"name":"calebux","email":"Petersoncaleb275@gmail.com"}],"dist":{"shasum":"34f437f14ca5e8cf3b28f65c2335d70f6ba62289","tarball":"https://registry.npmjs.org/@calebux/agent-kit/-/agent-kit-0.1.1.tgz","fileCount":34,"integrity":"sha512-WgI4Ht+dHhcA/k79u8nHARDpsAAGoMnUjpEYfFz+m8dqXy/e/KcWvfnvztUIjbxRmhyqqeWgGCK5r/DfUywgLA==","signatures":[{"sig":"MEQCIB+mkJtc7GKySeUvO+pCuwwg+iZTjd3ieipGOybJcGKpAiARDjnwtADyB+/QZV7TM40JpAHliByUM14/UJ1L2LFqwg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":74198},"main":"./dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"8c43372d4d301aa69fdba453d3340e05f35af5dd","scripts":{"build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"calebux","email":"Petersoncaleb275@gmail.com"},"_npmVersion":"10.9.2","description":"Governed multi-agent orchestration on Stellar — wallet provisioning, Soroban spend caps, on-chain reputation, and x402 payments in one package","directories":{},"_nodeVersion":"22.17.0","dependencies":{"@aegis/shared":"*","@stellar/stellar-sdk":"^12.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0"},"_npmOperationalInternal":{"tmp":"tmp/agent-kit_0.1.1_1776114383742_0.6360594737041108","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@calebux/agent-kit","version":"0.2.0","keywords":["stellar","soroban","agents","ai-agents","agent-infrastructure","agent-wallets","agent-discovery","x402","mpp","mcp","multi-agent","orchestration","blockchain","on-chain-reputation","verifiable-agents"],"license":"MIT","_id":"@calebux/agent-kit@0.2.0","maintainers":[{"name":"calebux","email":"Petersoncaleb275@gmail.com"}],"dist":{"shasum":"c943032df91e9007cf48c29fed23e86bc0a93571","tarball":"https://registry.npmjs.org/@calebux/agent-kit/-/agent-kit-0.2.0.tgz","fileCount":54,"integrity":"sha512-0PGhjdsIYJVC7uqLQf9sjwrfpairTJRQez8zkVEpbUWrn+1abHfcwg17oog0XUz88FcELoAYouku1mT2b+yuJQ==","signatures":[{"sig":"MEYCIQCp80MMzSLljMU84ESPrCSUtFbdrGrwdKygFc5jHla6TgIhAOufcY3oIwLGZ9JxNvaVgExuo/wZQgrt5mychL5FDRNt","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":157408},"main":"./dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"226bbb76fb1b58215655f7254395f1bcd162995a","scripts":{"build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"calebux","email":"Petersoncaleb275@gmail.com"},"_npmVersion":"10.9.2","description":"Governed multi-agent orchestration on Stellar — wallet provisioning, Soroban spend caps, on-chain reputation, and x402 payments in one package","directories":{},"_nodeVersion":"22.17.0","dependencies":{"viem":"^2.0.0","@aegis/shared":"*","@stellar/stellar-sdk":"^12.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0"},"_npmOperationalInternal":{"tmp":"tmp/agent-kit_0.2.0_1781275148338_0.16697296663823935","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@calebux/agent-kit","version":"0.2.1","keywords":["stellar","soroban","agents","ai-agents","agent-infrastructure","agent-wallets","agent-discovery","x402","mpp","mcp","multi-agent","orchestration","blockchain","on-chain-reputation","verifiable-agents"],"license":"MIT","_id":"@calebux/agent-kit@0.2.1","maintainers":[{"name":"calebux","email":"Petersoncaleb275@gmail.com"}],"dist":{"shasum":"f6d43e7cfd19255da39252ed3c3c839fa123aaca","tarball":"https://registry.npmjs.org/@calebux/agent-kit/-/agent-kit-0.2.1.tgz","fileCount":54,"integrity":"sha512-aBbKBstcveUKClWzaLZ1AY/9HdUmQ3npiHy1Vml8Vjv7uaz+zxLEOpOHQeQkz/ubv3jciW7X3guHssoJpGI6Pg==","signatures":[{"sig":"MEYCIQD3g50S01WkRv9ZskwRQvQn3Gzxkgww2HCV+0B5iy4j2AIhALRma3qxeGcicSdbG88a/fmmlNZ/UrTAAzqUT/BAG6ZR","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":156963},"main":"./dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"18ab511345e19d7c8e4bff7460d88567bc101f77","scripts":{"build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"calebux","email":"Petersoncaleb275@gmail.com"},"_npmVersion":"10.9.2","description":"Governed multi-agent orchestration on Stellar and Celo — wallet provisioning, on-chain spend caps, verifiable reputation, x402 payments, and run receipts in one package","directories":{},"_nodeVersion":"22.17.0","dependencies":{"viem":"^2.0.0","@aegis/shared":"*","@stellar/stellar-sdk":"^12.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0"},"_npmOperationalInternal":{"tmp":"tmp/agent-kit_0.2.1_1781275367990_0.7714195317979067","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@calebux/agent-kit","version":"0.2.2","keywords":["stellar","soroban","agents","ai-agents","agent-infrastructure","agent-wallets","agent-discovery","x402","mpp","mcp","multi-agent","orchestration","blockchain","on-chain-reputation","verifiable-agents"],"license":"MIT","_id":"@calebux/agent-kit@0.2.2","maintainers":[{"name":"calebux","email":"Petersoncaleb275@gmail.com"}],"dist":{"shasum":"665837879b06a5a1478c50cd0fdd9cba37d5d5b6","tarball":"https://registry.npmjs.org/@calebux/agent-kit/-/agent-kit-0.2.2.tgz","fileCount":106,"integrity":"sha512-Ik1EPFWAqdn2p8iWEUX4s5q7FNK0y3DbPc0F37UxXm4/oHgfSotcxxst2gUlUui/BV9CXw5LCxBqR0Ob+C+vYA==","signatures":[{"sig":"MEQCHzTz0QoQ6OntLSfVeavsvkrLzBuGp4zILwzpeeL9IHgCIQDTvKOS1Fu0M4WfBagq50ifM4TAhWhf8W+GA7mEUGRSdw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":310271},"main":"./dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"80b92af069c4e4a4805251c82d380043e717f09d","scripts":{"build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"calebux","email":"Petersoncaleb275@gmail.com"},"_npmVersion":"10.9.2","description":"Governed multi-agent orchestration on Stellar and Celo — wallet provisioning, on-chain spend caps, verifiable reputation, x402 payments, and run receipts in one package","directories":{},"_nodeVersion":"22.17.0","dependencies":{"viem":"^2.0.0","@calagent/shared":"*","@stellar/stellar-sdk":"^12.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0"},"_npmOperationalInternal":{"tmp":"tmp/agent-kit_0.2.2_1781418729253_0.12207014034619701","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@calebux/agent-kit","version":"0.3.0","keywords":["agent-economy","agent-infrastructure","ai-agents","multi-agent","agent-identity","agent-reputation","agent-payments","agent-governance","agent-discovery","agent-wallets","trust-scores","x402","mpp","mcp","celo","stellar","soroban","erc-8004","on-chain-reputation","verifiable-agents","blockchain","orchestration"],"license":"MIT","_id":"@calebux/agent-kit@0.3.0","maintainers":[{"name":"calebux","email":"Petersoncaleb275@gmail.com"}],"dist":{"shasum":"43eec59d3db3b17be5cba2ef6e126560d24d7587","tarball":"https://registry.npmjs.org/@calebux/agent-kit/-/agent-kit-0.3.0.tgz","fileCount":122,"integrity":"sha512-shnjnX4fxlrzsUiFH/5ex9NPDMp/ZLfIL+N3pJQJKC9dwC/AQzXfa0Xh3FdAW0KfQi4TIghJYoPotv7tTG61pg==","signatures":[{"sig":"MEQCIDf6fZHD7yvMw7rhel/PI8WCOZJHWksSmgrApjbGn+rlAiA8v3DAU5lUwzCTf059c59hpEBdybI+Z6tH0YXLXklXlg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":366952},"main":"./dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"0c436fc21b2cf0b20464c9c971cf2a304bd06b37","scripts":{"build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"calebux","email":"Petersoncaleb275@gmail.com"},"_npmVersion":"10.9.2","description":"Infrastructure for autonomous agent economies — identity, reputation, payments, governance, discovery, coordination, and audit on Celo and Stellar","directories":{},"_nodeVersion":"22.17.0","dependencies":{"viem":"^2.0.0","@calagent/shared":"*","@stellar/stellar-sdk":"^12.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0"},"_npmOperationalInternal":{"tmp":"tmp/agent-kit_0.3.0_1781447086069_0.055886534623684536","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@calebux/agent-kit","version":"0.4.0","keywords":["agent-economy","agent-infrastructure","ai-agents","multi-agent","agent-identity","agent-reputation","agent-payments","agent-governance","agent-discovery","agent-wallets","trust-scores","x402","mpp","mcp","celo","stellar","soroban","erc-8004","on-chain-reputation","verifiable-agents","blockchain","orchestration"],"license":"MIT","_id":"@calebux/agent-kit@0.4.0","maintainers":[{"name":"calebux","email":"Petersoncaleb275@gmail.com"}],"dist":{"shasum":"2382e66338d21731a2bcbd78a6da50126f16baad","tarball":"https://registry.npmjs.org/@calebux/agent-kit/-/agent-kit-0.4.0.tgz","fileCount":130,"integrity":"sha512-UhCco3Q+uAuqqvVYPUbXhPALXzHxBsPUR2MlhNfCzSjrYwt20B5lVQUUlrBo/V6ORXyZkyKP+BTsFuN53ahp2g==","signatures":[{"sig":"MEUCIA4ZvNsnVVlrGeCiHBeWLRu6NL5PmtJLH6Tli07X+D/PAiEA2PFLww99U5fTqkp+R+VDqAJytjdhqYPdD4maIogvM5s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":390454},"main":"./dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"9238decf89c75465cfa438fba98f171f82b2d7fa","scripts":{"build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"calebux","email":"Petersoncaleb275@gmail.com"},"_npmVersion":"10.9.2","description":"Infrastructure for autonomous agent economies — identity, reputation, payments, governance, discovery, coordination, and audit on Celo and Stellar","directories":{},"_nodeVersion":"22.17.0","dependencies":{"viem":"^2.0.0","@calagent/shared":"*","@stellar/stellar-sdk":"^12.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0"},"_npmOperationalInternal":{"tmp":"tmp/agent-kit_0.4.0_1781454423865_0.2081562915459283","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"name":"@calebux/agent-kit","version":"0.4.1","keywords":["agent-economy","agent-infrastructure","ai-agents","multi-agent","agent-identity","agent-reputation","agent-payments","agent-governance","agent-discovery","agent-wallets","trust-scores","x402","mpp","mcp","celo","stellar","soroban","erc-8004","on-chain-reputation","verifiable-agents","blockchain","orchestration"],"license":"MIT","_id":"@calebux/agent-kit@0.4.1","maintainers":[{"name":"calebux","email":"Petersoncaleb275@gmail.com"}],"dist":{"shasum":"11263cf52f038e2250797d36387e5bc5a6aefb7c","tarball":"https://registry.npmjs.org/@calebux/agent-kit/-/agent-kit-0.4.1.tgz","fileCount":134,"integrity":"sha512-1uVeiCRfptU+fagAIZN144JU+dEOh3IMfai+lrv/riVMu3Z1h8YG3RA50U7PliK8Tr9vL2PUFnzxOe6jdJ/1HQ==","signatures":[{"sig":"MEUCIQDSLXgBWt8bwYFd/ef6GySu2mFO/iwfRbx25OK59z69ewIgVw4+wpBZXZ9O85DUFAQ1JJ4a5m7TOCK1JAw5iwJFHtQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":393355},"main":"./dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"d9a76bd148e25357242ba34271bd135bc2ec670b","scripts":{"build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"calebux","email":"Petersoncaleb275@gmail.com"},"_npmVersion":"10.9.2","description":"Infrastructure for autonomous agent economies — identity, reputation, payments, governance, discovery, coordination, and audit on Celo and Stellar","directories":{},"_nodeVersion":"22.17.0","dependencies":{"viem":"^2.0.0","@stellar/stellar-sdk":"^12.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0"},"_npmOperationalInternal":{"tmp":"tmp/agent-kit_0.4.1_1781469194869_0.005946439685247329","host":"s3://npm-registry-packages-npm-production"}},"0.4.2":{"name":"@calebux/agent-kit","version":"0.4.2","keywords":["agent-economy","agent-infrastructure","ai-agents","multi-agent","agent-identity","agent-reputation","agent-payments","agent-governance","agent-discovery","agent-wallets","trust-scores","x402","mpp","mcp","celo","stellar","soroban","erc-8004","on-chain-reputation","verifiable-agents","blockchain","orchestration"],"license":"MIT","_id":"@calebux/agent-kit@0.4.2","maintainers":[{"name":"calebux","email":"Petersoncaleb275@gmail.com"}],"dist":{"shasum":"3f67d14620ee5adf3a1e1eed3bede4521b0db1a3","tarball":"https://registry.npmjs.org/@calebux/agent-kit/-/agent-kit-0.4.2.tgz","fileCount":134,"integrity":"sha512-3bCR6QNiir+RNvGWAaOVzaHlR3mb8iysZFr3E1RWIsbcaZH7sjjhO1tp3UcrE5aKhdIYxM1k5ybrHGzvGO0z0Q==","signatures":[{"sig":"MEQCIGTPsUTCzXSrbtLT0LPRaPDyaJzCwMSu/IXaOpDAKua/AiB60JnSKGyBgILGP7DLIve9dCIvbsrOpysNrmLkWomGzg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":393509},"main":"./dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"57f6bb37e9d00d97ff9a23caf5378ae4e8d2fd93","scripts":{"build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"calebux","email":"Petersoncaleb275@gmail.com"},"_npmVersion":"10.9.2","description":"Infrastructure for autonomous agent economies — identity, reputation, payments, governance, discovery, coordination, and audit on Celo and Stellar","directories":{},"_nodeVersion":"22.17.0","dependencies":{"viem":"^2.0.0","@stellar/stellar-sdk":"^12.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0"},"peerDependencies":{"@anthropic-ai/sdk":">=0.30.0"},"peerDependenciesMeta":{"@anthropic-ai/sdk":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/agent-kit_0.4.2_1781469686528_0.35191917361975444","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@calebux/agent-kit","version":"0.5.0","keywords":["agent-economy","agent-infrastructure","ai-agents","multi-agent","agent-identity","agent-reputation","agent-payments","agent-governance","agent-discovery","agent-wallets","trust-scores","x402","mpp","mcp","celo","stellar","soroban","erc-8004","on-chain-reputation","verifiable-agents","blockchain","orchestration"],"license":"MIT","_id":"@calebux/agent-kit@0.5.0","maintainers":[{"name":"calebux","email":"Petersoncaleb275@gmail.com"}],"dist":{"shasum":"fa9c0ff8ef065005963484065c0a01a28cd0ef5a","tarball":"https://registry.npmjs.org/@calebux/agent-kit/-/agent-kit-0.5.0.tgz","fileCount":138,"integrity":"sha512-iKZRGzBkW7DYadQ9AmT7zRAYpXq1t4I9OBwlpfxgnyXeh1XH2zsT6wCDDeU9T9HzyV9+U0SAzlGYu/hQ13FdbA==","signatures":[{"sig":"MEQCIEk3A6OdOoaLNKCD1XVqDT8zvTjn6fYxq0EdE2Fra23OAiAgV8ewgLTzNb/IVFTZrywIj50il0JHpiWLT0TId7XoNw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":422160},"main":"./dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"ea768514d593a25d6594c98619ec0e6368991cc8","scripts":{"build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"calebux","email":"Petersoncaleb275@gmail.com"},"_npmVersion":"10.9.2","description":"Infrastructure for autonomous agent economies — identity, reputation, payments, governance, discovery, coordination, and audit on Celo and Stellar","directories":{},"_nodeVersion":"22.17.0","dependencies":{"viem":"^2.0.0","@stellar/stellar-sdk":"^12.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0"},"peerDependencies":{"@anthropic-ai/sdk":">=0.30.0"},"peerDependenciesMeta":{"@anthropic-ai/sdk":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/agent-kit_0.5.0_1781518660588_0.619116710711151","host":"s3://npm-registry-packages-npm-production"}},"0.6.0":{"name":"@calebux/agent-kit","version":"0.6.0","keywords":["agent-kit","agent-framework","agent-memory","agent-loop","agentic","ai-agents","multi-agent","tool-use","obsidian","markdown-memory","knowledge-graph","agent-orchestration","agent-infrastructure","agent-economy","agent-identity","agent-reputation","agent-payments","agent-governance","agent-discovery","agent-wallets","trust-scores","x402","mpp","mcp","celo","stellar","soroban","erc-8004","on-chain-reputation","verifiable-agents","blockchain","orchestration","autonomous-agents","think-act-observe","agent-tools"],"license":"MIT","_id":"@calebux/agent-kit@0.6.0","maintainers":[{"name":"calebux","email":"Petersoncaleb275@gmail.com"}],"dist":{"shasum":"e87180d90a1a93476b6ab389130740b26b284a98","tarball":"https://registry.npmjs.org/@calebux/agent-kit/-/agent-kit-0.6.0.tgz","fileCount":150,"integrity":"sha512-LOvM6e5YbjEwqKAyDefHxgmCcR38E5x3mEi/sG8M5f1lQEyOUx4m333NjacTpTDhCvD1TlMwbEidWRWsS/SF+w==","signatures":[{"sig":"MEQCICAR7YqOmQgXldKzRd+pGJUiB9yn2RvXiEb+gZNLSzY5AiAKUjdsSY6aOk/K4OuzZx8bUHFhUKuXAbr8hY+jYDWKow==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":475655},"main":"./dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"29e8f6cf2e0949bd76613560654e0a68745d55b8","scripts":{"build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"calebux","email":"Petersoncaleb275@gmail.com"},"_npmVersion":"10.9.2","description":"Agent infrastructure — memory (Obsidian/markdown/JSON), agentic loops, tool-use, orchestration, identity, reputation, payments, and governance. Works off-chain or on Celo and Stellar.","directories":{},"_nodeVersion":"22.17.0","dependencies":{"viem":"^2.0.0","@stellar/stellar-sdk":"^12.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0"},"peerDependencies":{"@anthropic-ai/sdk":">=0.30.0"},"peerDependenciesMeta":{"@anthropic-ai/sdk":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/agent-kit_0.6.0_1781548662919_0.5708305375305431","host":"s3://npm-registry-packages-npm-production"}},"0.7.0":{"name":"@calebux/agent-kit","version":"0.7.0","description":"Infrastructure for autonomous agent economies — identity, reputation, payments, governance, discovery, coordination, and audit on Celo and Stellar. Also works fully off-chain with persistent memory, agentic loops, and tool-use.","keywords":["agent-kit","agent-framework","agent-memory","agent-loop","agentic","ai-agents","multi-agent","tool-use","obsidian","markdown-memory","knowledge-graph","agent-orchestration","agent-infrastructure","agent-economy","agent-identity","agent-reputation","agent-payments","agent-governance","agent-discovery","agent-wallets","trust-scores","x402","mpp","mcp","celo","stellar","soroban","erc-8004","on-chain-reputation","verifiable-agents","blockchain","orchestration","autonomous-agents","think-act-observe","agent-tools"],"license":"MIT","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"import":"./dist/index.js","require":"./dist/index.js","types":"./dist/index.d.ts"}},"scripts":{"build":"tsc","typecheck":"tsc --noEmit","clean":"rm -rf dist"},"dependencies":{"@stellar/stellar-sdk":"^12.0.0","viem":"^2.0.0"},"peerDependencies":{"@anthropic-ai/sdk":">=0.30.0"},"peerDependenciesMeta":{"@anthropic-ai/sdk":{"optional":true}},"devDependencies":{"typescript":"^5.5.0"},"engines":{"node":">=20"},"_id":"@calebux/agent-kit@0.7.0","gitHead":"29e8f6cf2e0949bd76613560654e0a68745d55b8","_nodeVersion":"22.17.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-C9+ekTO9g/BIleQnkl3qPbfZLAAPoyO6v3J+HleSV1Pnzau7TgGM+M7ZRMpndiVfzkSInkNWTT8YlTUddEZnDw==","shasum":"9fa9b615db170efb0a70cdb723d4252f61878984","tarball":"https://registry.npmjs.org/@calebux/agent-kit/-/agent-kit-0.7.0.tgz","fileCount":155,"unpackedSize":507597,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAuA6xOWdJdvu1JOIDsREh7TQpL4EaFsmmjtt8SDG5InAiEAnzlMq3WtQgxYecyX3ptao4f8uKNcw6OPQMfl3Fobt4k="}]},"_npmUser":{"name":"calebux","email":"Petersoncaleb275@gmail.com"},"directories":{},"maintainers":[{"name":"calebux","email":"Petersoncaleb275@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent-kit_0.7.0_1781551909593_0.5521565955782402"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-13T20:58:54.924Z","modified":"2026-06-15T19:31:49.846Z","0.1.0":"2026-04-13T20:58:55.147Z","0.1.1":"2026-04-13T21:06:23.922Z","0.2.0":"2026-06-12T14:39:08.485Z","0.2.1":"2026-06-12T14:42:48.139Z","0.2.2":"2026-06-14T06:32:09.395Z","0.3.0":"2026-06-14T14:24:46.222Z","0.4.0":"2026-06-14T16:27:04.004Z","0.4.1":"2026-06-14T20:33:15.037Z","0.4.2":"2026-06-14T20:41:26.654Z","0.5.0":"2026-06-15T10:17:40.720Z","0.6.0":"2026-06-15T18:37:43.072Z","0.7.0":"2026-06-15T19:31:49.739Z"},"license":"MIT","keywords":["agent-kit","agent-framework","agent-memory","agent-loop","agentic","ai-agents","multi-agent","tool-use","obsidian","markdown-memory","knowledge-graph","agent-orchestration","agent-infrastructure","agent-economy","agent-identity","agent-reputation","agent-payments","agent-governance","agent-discovery","agent-wallets","trust-scores","x402","mpp","mcp","celo","stellar","soroban","erc-8004","on-chain-reputation","verifiable-agents","blockchain","orchestration","autonomous-agents","think-act-observe","agent-tools"],"description":"Infrastructure for autonomous agent economies — identity, reputation, payments, governance, discovery, coordination, and audit on Celo and Stellar. Also works fully off-chain with persistent memory, agentic loops, and tool-use.","maintainers":[{"name":"calebux","email":"Petersoncaleb275@gmail.com"}],"readme":"# @calebux/agent-kit\n\n**The complete agent infrastructure SDK — memory, agentic loops, tool-use, orchestration, identity, reputation, payments, and governance.**\n\nWorks completely off-chain (no blockchain needed) or on-chain with Celo and Stellar. Use it to build agents that remember, reason in loops, use tools, orchestrate pipelines, pay each other, and generate verifiable receipts.\n\n```bash\nnpm install @calebux/agent-kit\n```\n\n---\n\n## Off-chain: Agents with memory, loops, and tools (no blockchain)\n\nYou don't need wallets or contracts to use agent-kit. Here's a fully off-chain agent with Obsidian-style memory and an autonomous loop:\n\n```ts\nimport {\n  createAgentLoop,\n  createMemoryProvider,\n  webFetchTool,\n  fileWriteTool,\n  defineTool,\n} from '@calebux/agent-kit'\n\n// 1. Memory — choose your backend\nconst memory = createMemoryProvider({ type: 'markdown', vaultPath: './research-vault' })\n// Also available: { type: 'file', filePath: './memory.json' }\n//                 { type: 'memory' }  (in-process, for testing)\n//                 { type: 'gbrain', gbrain: { url: '...' } }\n\n// 2. Tools — use built-ins or define your own\nconst summarize = defineTool({\n  name: 'summarize',\n  description: 'Summarize text into bullet points',\n  parameters: { text: 'string' },\n  execute: async ({ text }) => {\n    // Call your LLM here\n    return `Summary of ${text.length} chars...`\n  },\n})\n\n// 3. Agentic loop — think → act → observe, repeat\nconst loop = createAgentLoop({\n  goal: 'Research the top 3 DeFi protocols and write a report',\n  tools: [webFetchTool, fileWriteTool, summarize],\n  memory,\n  maxIterations: 10,\n  think: async (goal, history, recalled, toolDesc) => {\n    // Plug in ANY LLM here (GPT, Claude, Llama, Mistral, etc.)\n    // Return which tool to call next\n    if (history.length === 0) {\n      return { tool: 'web_fetch', input: { url: 'https://defillama.com/...' }, reasoning: 'Starting research' }\n    }\n    return { done: true, tool: '', input: {}, reasoning: 'Research complete' }\n  },\n  onStep: (step) => console.log(`[${step.iteration}] ${step.toolName}: ${step.observation.slice(0, 80)}`),\n})\n\nconst result = await loop.run()\nconsole.log(result.summary)\n// Memory auto-stores results — next run will recall this context\n```\n\n### Memory providers\n\n| Type | Persistence | Search | Best for |\n|------|-------------|--------|----------|\n| `markdown` | Obsidian-compatible `.md` files with frontmatter | Keyword + tag | Production agents, human-readable memory |\n| `file` | JSON file on disk | Keyword | Simple persistence, CLI tools |\n| `memory` | In-process Map | Keyword | Testing, ephemeral agents |\n| `gbrain` | gBrain MCP knowledge graph | Semantic (via gBrain) | Advanced knowledge graph use cases |\n\n### Built-in tools\n\n| Tool | What it does |\n|------|-------------|\n| `webFetchTool` | Fetch any URL, return response as text |\n| `fileReadTool` | Read a file from disk |\n| `fileWriteTool` | Write content to a file |\n| `shellTool` | Execute a shell command |\n| `grepTool` | Search for patterns in files |\n| `defineTool()` | Create your own custom tool |\n\n### Agentic loop\n\n`createAgentLoop` runs an autonomous **think → act → observe** cycle. You provide the `think` function (your LLM), tools, and a goal. The loop runs until the goal is met or the iteration budget is exhausted. Works with any LLM — GPT, Claude, Llama, Mistral, local models.\n\n```ts\nconst loop = createAgentLoop({\n  goal: 'Your objective here',\n  tools: [webFetchTool, fileWriteTool, yourCustomTool],\n  memory: createMemoryProvider({ type: 'markdown', vaultPath: './vault' }),\n  maxIterations: 15,\n  think: async (goal, history, recalled, toolDescriptions) => {\n    // Your LLM decides the next action\n    return { tool: 'web_fetch', input: { url: '...' }, reasoning: 'Need more data' }\n  },\n  isDone: (history) => history.some(s => s.observation.includes('COMPLETE')),\n  onStep: (step) => console.log(step),\n})\n```\n\n---\n\n## On-chain: Full agent economy (Celo + Stellar)\n\nFor agents that need identity, reputation, payments, escrow, staking, and governance — add on-chain infrastructure:\n\n### Optional peer dependencies\n\n- **`@anthropic-ai/sdk`** — Required only if you use `AnthropicProvider` for LLM-powered task decomposition or synthesis. Install it separately:\n\n```bash\nnpm install @anthropic-ai/sdk\n```\n\nIf you don't need LLM features (e.g. you provide your own `decompose`/`synthesize` functions), you can skip this.\n\n---\n\n## What it does\n\n| Feature | Celo | Stellar |\n|---|---|---|\n| **Wallet provisioning** | viem Account from private key or random | Fresh Stellar keypair, auto-funded via Friendbot on testnet |\n| **On-chain spend caps** | AegisCeloPolicy contract | Soroban Shield Contract |\n| **x402 payments** | `payAndFetchCelo()` — probe → pay USDm → retry | `payAndFetch()` — probe → pay XLM → retry |\n| **Verifiable reputation** | AegisCeloRegistry on Celo mainnet | Soroban Identity Registry |\n| **Agent-to-agent payments** | USDm ERC-20 transfers | XLM with on-chain memos |\n| **Run receipts** | SHA-256 hashed, Ed25519 signed | SHA-256 hashed, Ed25519 signed |\n| **Agent manifests** | Same shape, `chain: \"celo\"` | Capabilities, endpoints, payment terms, policies |\n| **ERC-8004 compliance** | Erc8004Adapter bridge to canonical registries | N/A |\n| **Self Protocol identity** | Sybil-resistant agent verification | N/A |\n\n---\n\n## Quick start (Celo)\n\n```ts\nimport {\n  CeloIdentityRegistry,\n  CeloPolicyManager,\n  payAndFetchCelo,\n  submitCusdPayment,\n  celoAgentToAgentPayment,\n} from '@calebux/agent-kit'\n\n// Registry — agent identity and reputation on Celo mainnet\nconst registry = new CeloIdentityRegistry(\n  '0x34BdE9da696fCAc92DF24f0631bcf7C41dB8A19C',\n  process.env.CELO_DEPLOYER_PRIVATE_KEY!,\n  'https://forno.celo.org',\n  'mainnet'\n)\n\nawait registry.registerAgent('my-agent', 'My Agent', 'research')\nawait registry.setManifestHash('my-agent', manifestHash)\nawait registry.recordSuccess('my-agent')\nconst rep = await registry.getReputation('my-agent') // number | null\n\n// Policy — per-agent spend caps and session management on Celo\nconst policy = new CeloPolicyManager(\n  '0xF1aCE070B7265094c24e276671a72Af4B3Fa1A0c',\n  process.env.CELO_DEPLOYER_PRIVATE_KEY!,\n  'https://forno.celo.org',\n  'mainnet'\n)\n\nawait policy.setSpendCap('my-agent', 1000000n) // in USDm base units\nawait policy.authorizeSpend('my-agent', 50000n)\n\n// x402 payment helper for Celo (probe → pay USDm → retry)\nconst result = await payAndFetchCelo('https://api.example.com/data', account, txHashes)\n\n// Direct USDm transfer\nconst txHash = await submitCusdPayment(account, '0xDEST...', '0.5')\n\n// Agent-to-agent USDm payment\nconst hash = await celoAgentToAgentPayment(fromAccount, toAddress, '0.001')\n```\n\n---\n\n## Celo Orchestrator\n\n`createCeloOrchestrator` is the Celo-native equivalent of `createOrchestrator`. It provisions EVM wallets, registers agents on AegisCeloRegistry, enforces spend caps via AegisCeloPolicy, and uses cUSD x402 payments — no Stellar dependencies.\n\n```ts\nimport { defineAgent, createCeloOrchestrator } from '@calebux/agent-kit'\n\nconst analyst = defineAgent({\n  id: 'analyst',\n  spendCapXlm: 2, // reused as cUSD cap (2 cUSD)\n  run: async (task, { pay }) => {\n    const data = await pay<{ result: string }>('https://my-celo-api.com/analyze?q=' + task)\n    return { result: data.result }\n  }\n})\n\nconst { run } = createCeloOrchestrator([analyst], {\n  registryAddress: process.env.CELO_REGISTRY_ADDRESS,\n  policyAddress: process.env.CELO_POLICY_ADDRESS,\n  adminPrivateKey: process.env.CELO_DEPLOYER_PRIVATE_KEY,\n  network: 'mainnet',\n})\n\nconst report = await run('Analyze Celo DeFi TVL')\n```\n\nSupports the same `decompose`, `synthesize`, `memory`, and `onWalletsProvisioned` options as the Stellar orchestrator.\n\n---\n\n## Agent Memory\n\nPersistent memory lets agents recall context from past runs. Three providers are available:\n\n```ts\nimport { createMemoryProvider, createOrchestrator } from '@calebux/agent-kit'\n\n// File-based — persists to disk, survives restarts (recommended for production)\nconst memory = createMemoryProvider({ type: 'file', filePath: '.calagent/memory.json' })\n\n// In-memory — fast but resets on restart (good for testing)\nconst memory2 = createMemoryProvider({ type: 'memory' })\n\n// gBrain — knowledge graph via MCP server (advanced)\nconst memory3 = createMemoryProvider({\n  type: 'gbrain',\n  gbrain: { url: 'http://localhost:3100', token: 'my-token' }\n})\n\n// Pass to any orchestrator\nconst { run } = createOrchestrator([agent], { memory })\n// or: createCeloOrchestrator([agent], { memory })\n\n// Agents can use memory directly in their run function:\nconst agent = defineAgent({\n  id: 'researcher',\n  run: async (task, ctx) => {\n    // Recall past context\n    const context = await ctx.memory?.recall('researcher', task)\n    // Store new findings\n    await ctx.memory?.store('finding/123', 'key insight', { topic: 'defi' })\n    return { result: context + '\\n\\nNew findings...' }\n  }\n})\n```\n\nAfter each orchestrator run, results are automatically stored in memory for future recall.\n\n---\n\n## ERC-8004 and Self Protocol (Celo)\n\n```ts\nimport {\n  Erc8004Adapter,\n  isSelfVerified,\n  selfEnforced,\n  SELF_AGENT_REGISTRY,\n} from '@calebux/agent-kit'\n\n// ERC-8004 adapter — bridge to canonical Identity + Reputation registries\nconst adapter = new Erc8004Adapter(\n  process.env.ERC8004_ADAPTER_ADDRESS!,\n  process.env.CELO_DEPLOYER_PRIVATE_KEY!,\n  'https://forno.celo.org',\n  'mainnet'\n)\n\n// Register an agent → gets an ERC-8004 NFT ID\nconst { txHash, erc8004Id } = await adapter.registerOnErc8004(\n  'my-agent',\n  'https://myapp.com/api/agents/my-agent/uri'\n)\n\n// Sync reputation to the canonical ERC-8004 Reputation Registry\nawait adapter.syncReputation('my-agent', 10, 'task-success')\n\n// Update agent metadata URI\nawait adapter.updateAgentURI('my-agent', 'https://myapp.com/api/agents/my-agent/uri')\n\n// Check registration\nconst registered = await adapter.isRegistered('my-agent')\nconst nftId = await adapter.getErc8004AgentId('my-agent')\n\n// Self Protocol — sybil-resistant identity\nconst verified = await isSelfVerified('0xAgentWalletAddress')\nconst enforce = selfEnforced() // checks CALAGENT_SELF_ENFORCE env var\n```\n\n---\n\n## Agent Staking (Celo)\n\n```ts\nimport { AgentStakingManager } from '@calebux/agent-kit'\n\nconst staking = new AgentStakingManager(\n  process.env.CELO_STAKING_ADDRESS!,\n  process.env.CELO_DEPLOYER_PRIVATE_KEY!,\n  'https://forno.celo.org',\n  'mainnet'\n)\n\n// Stake USDm as collateral (must approve token first)\nawait staking.stake('my-agent', 100_000000000000000000n)\n\n// Check stake\nconst stake = await staking.getStake('my-agent')\nconst isStaked = await staking.isStaked('my-agent', 50_000000000000000000n)\n\n// Unstake with cooldown\nawait staking.requestUnstake('my-agent', 50_000000000000000000n)\n// ... wait 24h ...\nawait staking.unstake('my-agent')\n```\n\n---\n\n## Consensus Voting (Celo)\n\n```ts\nimport { ConsensusVotingManager } from '@calebux/agent-kit'\n\nconst voting = new ConsensusVotingManager(\n  process.env.CELO_CONSENSUS_VOTING_ADDRESS!,\n  process.env.CELO_DEPLOYER_PRIVATE_KEY!,\n  'https://forno.celo.org',\n  'mainnet'\n)\n\n// Open a round, submit votes, finalize\nconst roundId = await voting.openRound(taskHash)\nawait voting.submitVote(roundId, 'scout', outputHash, 9000)\nawait voting.submitVote(roundId, 'ledger', outputHash, 8500)\nawait voting.submitVote(roundId, 'signal', otherHash, 7000)\nawait voting.finalizeRound(roundId)\n\nconst { outputHash, voteCount, finalized } = await voting.getRoundResult(roundId)\n```\n\n---\n\n## Task Escrow (Celo)\n\n```ts\nimport { TaskEscrowManager } from '@calebux/agent-kit'\n\nconst escrow = new TaskEscrowManager(\n  process.env.CELO_TASK_ESCROW_ADDRESS!,\n  process.env.CELO_DEPLOYER_PRIVATE_KEY!,\n  'https://forno.celo.org',\n  'mainnet'\n)\n\n// Create escrow — deposit USDm for a task with a deadline\nconst { txHash, escrowId } = await escrow.createEscrow(\n  taskHash,           // bytes32 task hash\n  'my-agent',         // agent ID\n  50_000000000000000000n, // 50 USDm\n  BigInt(Math.floor(Date.now() / 1000) + 3600) // 1 hour deadline\n)\n\n// Release funds to agent after verifying receipt\nawait escrow.releaseEscrow(escrowId, receiptHash)\n\n// Or refund depositor if deadline passed\nawait escrow.refundEscrow(escrowId)\n\n// Read escrow details\nconst info = await escrow.getEscrow(escrowId)\n// info.depositor, info.agentId, info.amount, info.taskHash, info.released, info.deadline\n```\n\n---\n\n## Agent Delegation\n\n```ts\nimport { delegateTask, createSubOrchestrator } from '@calebux/agent-kit'\n\n// Simple delegation with receipt chain linking\nconst delegation = delegateTask('parent-agent', 'child-agent', 'research task', parentRunId)\n// delegation.childRunId, delegation.receiptHash — linked to parentRunId\n\n// Sub-orchestrator with inherited budget\nconst sub = createSubOrchestrator(['scout', 'ledger', 'signal'], {\n  parentRunId,\n  parentAgentId: 'orchestrator',\n  maxSpend: 1_000000n,\n})\n\nconst d = sub.delegate('scout', 'web research on Celo DeFi')\nsub.recordSpend(500000n)  // track spend against budget\nconsole.log(sub.remaining) // 500000n\n```\n\n---\n\n## Agent Credentials (Celo)\n\n```ts\nimport { AgentCredentialManager } from '@calebux/agent-kit'\n\nconst creds = new AgentCredentialManager(\n  process.env.CELO_CREDENTIALS_ADDRESS!,\n  process.env.CELO_DEPLOYER_PRIVATE_KEY!,\n  'https://forno.celo.org',\n  'mainnet'\n)\n\n// Grant scoped, time-limited credential\nconst oneYear = BigInt(Math.floor(Date.now() / 1000) + 365 * 86400)\nawait creds.grantCredential('scout', 'web-search', 'read', oneYear)\n\n// Check and read\nconst has = await creds.hasCredential('scout', 'web-search')\nconst info = await creds.getCredential('scout', 'web-search')\n\n// Revoke\nawait creds.revokeCredential('scout', 'web-search')\n```\n\n---\n\n## Trust Scores\n\n```ts\nimport {\n  calculateTrustScore,\n  createDefaultTrustProviders,\n  CeloIdentityRegistry,\n  AgentStakingManager,\n} from '@calebux/agent-kit'\n\nconst registry = new CeloIdentityRegistry(/* ... */)\nconst staking = new AgentStakingManager(/* ... */)\n\nconst providers = createDefaultTrustProviders({ registry, staking })\nconst result = await calculateTrustScore('scout', providers)\n// result.score: 0–1000\n// result.breakdown: [{ provider: 'reputation', weight: 0.3, rawScore: 700, weightedScore: 210 }, ...]\n```\n\n---\n\n## Capability Routing (Agent DNS)\n\n```ts\nimport { AgentRouter } from '@calebux/agent-kit'\n\nconst router = new AgentRouter({\n  localManifests: manifests,\n  trustProviders: providers,\n  peerRegistry: peers,\n})\n\n// Discover agents by capability, ranked by trust\nconst ranked = await router.findAgent({ capability: 'web-research', minTrustScore: 300 })\n\n// Route a task to the best agent\nconst { agent, response } = await router.routeByCapability('web-research', 'Celo DeFi data')\n```\n\n---\n\n## Human Approval Gateway\n\n```ts\nimport { ApprovalGateway, approvalMiddleware, ApprovalRequiredError } from '@calebux/agent-kit'\n\nconst gateway = new ApprovalGateway()\nconst check = approvalMiddleware(gateway, 1_000000n) // threshold\n\ntry {\n  check('my-agent', 'expensive task', 5_000000n) // exceeds threshold\n} catch (err) {\n  if (err instanceof ApprovalRequiredError) {\n    console.log('Pending:', gateway.getPendingApprovals())\n    gateway.approveRequest(err.approvalId)\n  }\n}\n```\n\n---\n\n## Stellar support\n\nFull Stellar/Soroban support with x402 payments in XLM:\n\n```ts\nimport { defineAgent, createOrchestrator } from '@calebux/agent-kit'\n\nconst researcher = defineAgent({\n  id: 'researcher',\n  spendCapXlm: 1,\n  manifest: {\n    name: 'Researcher',\n    capabilities: ['research', 'web-search'],\n    payments: [\n      { protocol: 'x402', network: 'stellar:testnet', asset: 'USDC', price: '$0.001' }\n    ],\n    policies: {\n      allowedAssets: ['USDC'],\n      minCounterpartyReputation: 5000,\n    },\n  },\n  run: async (task, { pay }) => {\n    const data = await pay<{ summary: string }>('https://my-x402-api.com/search?q=' + task)\n    return { result: data.summary }\n  }\n})\n\nconst { run } = createOrchestrator([researcher], {\n  shieldContractId:   process.env.SHIELD_CONTRACT_ID,\n  registryContractId: process.env.REGISTRY_CONTRACT_ID,\n})\n\nconst report = await run('What is the current XLM price?')\n```\n\n---\n\n## Run receipts\n\nEvery agent run can produce a verifiable receipt — a JSON object containing task hash, output hash, agent wallets, payment transactions, and an optional Ed25519 signature.\n\n```ts\nimport {\n  createRunReceipt,\n  signRunReceipt,\n  computeReceiptHash,\n  verifyRunReceipt,\n} from '@calebux/agent-kit'\n\n// Create a receipt from an orchestrator report\nconst receipt = createRunReceipt(orchestratorReport, {\n  shieldContractId: process.env.SHIELD_CONTRACT_ID,\n  registryContractId: process.env.REGISTRY_CONTRACT_ID,\n  network: 'stellar:testnet',\n})\n\n// Sign it with a Stellar keypair\nconst signed = signRunReceipt(receipt, adminKeypair)\n\n// Verify a receipt\nconst verification = verifyRunReceipt(signed)\n// { valid: true, taskHashMatch: true, outputHashMatch: true, signatureValid: true }\n\n// Compute a deterministic hash of any receipt\nconst hash = computeReceiptHash(signed)\n```\n\nReceipt schema: `calagent.receipt.v1`\n\n---\n\n## Agent manifests and discovery\n\nManifests declare capabilities, endpoints, payment terms, and policy constraints. They work across both chains.\n\n```ts\nimport {\n  createAgentManifest,\n  computeAgentManifestHash,\n  discoverAgents,\n} from '@calebux/agent-kit'\n\nconst manifest = createAgentManifest(agent, {\n  walletAddress: 'G...',\n  registryContractId: process.env.REGISTRY_CONTRACT_ID,\n  shieldContractId: process.env.SHIELD_CONTRACT_ID,\n})\n\n// SHA-256 hash for on-chain registration\nconst hash = computeAgentManifestHash(manifest)\n\n// Filter agents by capability, protocol, asset, reputation\nconst matches = discoverAgents(manifests, {\n  capability: 'web-search',\n  protocol: 'x402',\n  asset: 'USDm',\n  network: 'eip155:42220',\n  minReputation: 5000,\n}, reputationMap)\n```\n\n---\n\n## Streaming to a UI\n\n```ts\nimport { EventEmitter } from 'events'\n\nconst emitter = new EventEmitter()\n\nemitter.on('log',          ({ message, level }) => console.log(`[${level}] ${message}`))\nemitter.on('agent_status', ({ agent, status, spent, txHashes }) => updateUI(agent, status))\nemitter.on('wallets',      (map) => console.log('wallets:', map))\nemitter.on('complete',     ({ report, wallets, spent, reputation, txHashes }) => done())\nemitter.on('error',        ({ message }) => console.error(message))\n\nawait run('my task', emitter)\n```\n\n---\n\n## Low-level utilities (Stellar)\n\n```ts\nimport {\n  payAndFetch,\n  submitXlmPayment,\n  agentToAgentPayment,\n  ShieldContract,\n  IdentityRegistry,\n} from '@calebux/agent-kit'\n\n// x402 payment helper (probe → pay → retry)\nconst { data, paymentMode } = await payAndFetch('https://api.example.com/data', keypair, txHashes)\n\n// Direct XLM transfer\nconst txHash = await submitXlmPayment(fromKeypair, 'G...DEST', '0.5')\n\n// Agent-to-agent payment with on-chain memo\nconst hash = await agentToAgentPayment(fromKeypair, toAddress, '0.001', 'myapp:agent-a->agent-b')\n\n// Shield Contract — per-agent spend caps\nconst shield = new ShieldContract(process.env.SHIELD_CONTRACT_ID!, rpc, adminKeypair)\nawait shield.registerAgent('my-agent', agentKeypair, 10_000_000n)\nawait shield.authorizeSpend('my-agent', 100_000n)\n\n// Identity Registry — verifiable reputation\nconst registry = new IdentityRegistry(process.env.REGISTRY_CONTRACT_ID!, rpc, adminKeypair)\nawait registry.registerAgent('my-agent', 'My Agent', 'research')\nawait registry.recordSuccess('my-agent', agentKeypair)\nconst score = await registry.getReputation('my-agent')\n```\n\n---\n\n## Automation\n\nSchedule recurring agent tasks with `createAutomation()`:\n\n```ts\nimport { createAutomation } from '@calebux/agent-kit'\n\nconst automation = createAutomation({\n  agent: 'celo-defi',\n  task: 'Get Mento exchange rates',\n  schedule: '*/15 * * * *',  // every 15 minutes\n  chain: 'celo',\n  onResult: (receipt) => console.log('Rate:', receipt.output),\n})\n\nautomation.start()\n```\n\n---\n\n## Interoperability\n\nCal-AgentKit is chain-agnostic. The same agent definitions, manifests, and receipts work across every supported chain — and across independently deployed instances.\n\n```ts\nimport { selectChain, PeerRegistry, routeToPeer } from '@calebux/agent-kit'\n\n// Route payments to any supported chain\nconst chain = selectChain('celo')   // or 'stellar', 'base'\nawait chain.pay(destination, amount)\n\n// Discover and delegate to peer instances\nconst peers = new PeerRegistry()\npeers.add('https://partner.example.com', { trust: 'verified' })\n\nconst result = await routeToPeer(peers, {\n  capability: 'celo-defi',\n  task: 'Get Mento exchange rates',\n})\n```\n\n---\n\n## Deployed contracts\n\n**Stellar testnet (Soroban):**\n\n| Contract | ID |\n|---|---|\n| Shield Contract | `CDGVUNE47FXSG6KJATMZB3MFTE7UJFBMUKNFK7FWZRAHPG5BUGBFV2RS` |\n| Identity Registry | `CBQV3JXYZS7ABOTLCYZM6U4LUEF7PTIUXV76QAPHYAACERXHROVTT2YM` |\n\n**Celo mainnet:**\n\n| Contract | Address |\n|---|---|\n| AegisCeloRegistry | `0x34BdE9da696fCAc92DF24f0631bcf7C41dB8A19C` |\n| AegisCeloPolicy | `0xF1aCE070B7265094c24e276671a72Af4B3Fa1A0c` |\n| Erc8004Adapter | _(deployed via `deploy.sh`)_ |\n| AgentStaking | _(deployed via `deploy.sh`)_ |\n| ConsensusVoting | _(deployed via `deploy.sh`)_ |\n| ERC-8004 Identity Registry | `0x8004A169FB4a3325136EB29fA0ceB6D2e539a432` |\n| ERC-8004 Reputation Registry | `0x8004BAa17C55a88189AE136b182e5fdA19dE9b63` |\n| Self Agent Registry | `0xaC3DF9ABf80d0F5c020C06B04Cced27763355944` |\n\n---\n\n## Environment variables\n\n| Variable | Chain | Description |\n|---|---|---|\n| `STELLAR_NETWORK` | Stellar | `testnet` (default) or `futurenet` |\n| `STELLAR_HORIZON_URL` | Stellar | Horizon endpoint |\n| `STELLAR_RPC_URL` | Stellar | Soroban RPC endpoint |\n| `SHIELD_CONTRACT_ID` | Stellar | Shield Contract address |\n| `REGISTRY_CONTRACT_ID` | Stellar | Identity Registry address |\n| `ORCHESTRATOR_SECRET_KEY` | Stellar | Admin keypair for on-chain registration |\n| `CELO_RPC_URL` | Celo | Celo JSON-RPC endpoint (default: `https://forno.celo.org`) |\n| `CELO_REGISTRY_ADDRESS` | Celo | AegisCeloRegistry contract address |\n| `CELO_POLICY_ADDRESS` | Celo | AegisCeloPolicy contract address |\n| `CELO_DEPLOYER_PRIVATE_KEY` | Celo | Admin key for registry/policy writes |\n| `CALAGENT_CELO_NETWORK` | Celo | `mainnet` or `alfajores` |\n| `ERC8004_ADAPTER_ADDRESS` | Celo | Erc8004Adapter bridge contract address |\n| `CALAGENT_SELF_ENFORCE` | Celo | `true` to gate agent runs behind Self Protocol verification |\n| `CELO_STAKING_ADDRESS` | Celo | AgentStaking contract address |\n| `CELO_CONSENSUS_VOTING_ADDRESS` | Celo | ConsensusVoting contract address |\n| `CELO_CREDENTIALS_ADDRESS` | Celo | AgentCredentials contract address |\n| `CALAGENT_PEERS` | Any | Comma-separated peer instance URLs for auto-federation |\n\nAll contract options are optional — omit them to run in dev mode with no on-chain enforcement.\n\n---\n\n## Reference implementation\n\n[CAL-AGENTKIT](https://github.com/Calebux/CAL-AGENTKIT) is the full reference implementation: five specialized agents per chain (Scout, Ledger, Signal, Scribe, Notary), live x402 payment servers, agent-to-agent payments, verifiable run receipts, and a Next.js dashboard — all built on `@calebux/agent-kit`.\n\n---\n\n## License\n\nMIT\n","readmeFilename":"README.md"}