Add mint command: Google ADK/A2A agent scaffolding with birthday backup and Arweave archive

[johnnyclem]

Motivation

• Provide first-class support and convenience scaffolding for Google ADK / A2A agents so users can quickly create ADK-compatible agents (loop, workflow, sequential, parallel) and bootstrap them on-chain and into archival storage.
• Ensure a new agent is created with a valid on-chain canister identifier and an initial "birthday" backup so projects have a reproducible initial state equivalent to a git init snapshot.
• Offer an optional immediate Arweave archival path so users can persist the birthday backup off-chain if they supply a JWK.

Description

• Added a new CLI command agentvault mint agent with template flags: --google-adk-loop-agent, --google-adk-workflow-agent, --google-adk-sequential-agent, and --google-adk-parallel-agent, implemented in cli/commands/mint.ts and registered in cli/index.ts via mintCmd().
• Implemented the minting workflow in src/mint/google-adk.ts, which: checks/attempts to install Google ADK via pip (optional), scaffolds files (agent.py, requirements.txt, a2a-manifest.json, .agentvault/config/agent.config.json), generates a stub canister id, creates a local “birthday” backup using exportBackup, prepares a local Arweave archive using the archive manager, and optionally uploads it using ArweaveClient when an --arweave-jwk path is provided.
• Added unit tests tests/unit/mint.test.ts that verify CLI wiring and that the scaffold + birthday backup are created by mintGoogleAdkAgent.
• Small implementation details: normalization of agent names, safe directory creation, and soft failure with user-facing warnings when ADK or Arweave upload is not available.

Testing

• Ran targeted unit tests with npm run test -- tests/unit/mint.test.ts, which passed: Test Files 1 passed, Tests 5 passed (Vitest v4.0.18).
• Ran full TypeScript typecheck with npm run typecheck, which reported unrelated pre-existing failures in other modules (errors in cli/commands/pilot.ts and src/pilot/private-replica.ts); the new src/mint/google-adk.ts and added files are type-checked in the run but the CI-typecheck failed because of those unrelated files.

---

Codex Task

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
agent-vault	Ready	Preview, Comment	Apr 26, 2026 2:40pm
agentvault	Ready	Preview, Comment	Apr 26, 2026 2:40pm