feat: npm cli - generate core primitives

[CarsonRoscoe]

Description

This PR adds a suite of generative tools to generate the core building blocks for AgentKit. The use-case for these tools is to easily add AgentKit to an existing application.

The base npm create onchain-agent behavior is unchanged. It remains the quickstart CLI.

After installing create-onchain-agent, a second cli, agentkit, will be installed alongside it. This allows you to access the following 4 new commands:

This PR adds the following 4 new commands:

• agentkit generate wallet-provider will generate a custom wallet provider (e.g. turnkeyWalletProvider.ts)
• agentkit generate action-provider will generate a custom action provider (e.g.baseActionProvider.ts)
• agentkit generate prepare will generate a prepareAgentkit.ts file that will do all the framework-agnostic Agentkit work. This function will return the the results from Agentkit.from(walletProvider, actionProviders) along with the associated walletProvider.
• agentkit generate create-agent will generate a createAgent.ts file that is framework-specific. It assumes the existence of an associated prepareAgentkit.ts file.

Tests

1. create onchain-agent regression tests worked and are unchanged in behavior

2. agentkit generate prepare cases

3. agentkit generate create-agent cases

4. agentkit generate wallet-provider case

5. agentkit generate action-provider case

Checklist

A couple of things to include in your PR for completeness:

• Added documentation to all relevant README.md files
• Added a changelog entry

[cb-heimdall]

🟡 Heimdall Review Status

Requirement	Status	More Info
Reviews	🟡 0/1	Denominator calculation Show calculation 1 if user is bot 0 1 if user is external 0 From .codeflow.yml 1 Additional review requirements Show calculation Max 0 0 From CODEOWNERS 0 Global minimum 0 Max 1 1 1 if commit is unverified 0 Sum 1

[cb-heimdall]

Review Error for pattiscott973 @ 2025-03-19 20:47:42 UTC
User must have write permissions to review