[Task]: Extract shared agent startup sequence into packages/common

[grantfox-oss]

Each of the five specialist agents (stellar-oracle, analysis-agent, reporter-agent, web-intel-agent, computation-agent) has an identical startup sequence:

1. Load env vars, validate required ones
2. Load or generate a keypair from wallets.json
3. Call POST ${REGISTRY_URL}/register with the agent manifest
4. Start the HTTP server
5. Log the agent address and listening port

This is duplicated in each agent's src/server.ts. Any change (e.g., adding a heartbeat after registration, adding the USDC balance warning from issue #19) requires touching five files.

Extract this into a shared registerAgent helper in packages/common/src/agent-startup.ts:

export interface AgentStartupOptions {
  manifest: AgentManifest;
  walletKey: string;      // key in wallets.json, e.g. "stellar_oracle"
  onReady?: (keypair: Keypair) => void;
}

export async function registerAgent(opts: AgentStartupOptions): Promise<void>;

The helper handles keypair loading, registration POST with retry (3 attempts), heartbeat setup, and startup log lines. Each agent's server.ts is reduced to defining its manifest and calling registerAgent.

This change should not alter any external behavior.

Acceptance criteria

• packages/common/src/agent-startup.ts exports a registerAgent function
• At least two agents are migrated to use registerAgent (the remaining three can follow as separate PRs)
• The migrated agents' startup behavior is identical to before (same log output, same registration payload)
• npm run typecheck and npm run lint pass for all packages

Relevant files

• packages/common/src/ (new file)
• packages/stellar-oracle/src/server.ts
• packages/analysis-agent/src/server.ts
• Other agent server files (for reference)
• packages/common/src/types.ts

Notes for contributors

If you'd like to work on this, comment below so we can assign it to you.
Questions welcome — see CONTRIBUTING.md for setup
and workflow.

[senmalong]

Hello Maintainer,

Please I’d love to take this issue on. I’m a smart contract and full-stack developer with experience across OnlyDust, Drips Waves

My stack includes Rust, Soroban, Cairo, Solidity, and TypeScript. I can deliver a clean, tested, and well-documented solution within 24 hours of assignment.

Happy to start immediately. Thank yOU

[Tobi-8]

please maintainer , assign me to this issue.
Hey maintainer, i have looked through your description, and i have had experience in this type of issue.
kindly assign

[mijinummi]

Hello maintainers I'm a full stack developer experience in building scalable systems I can handle this perfectly if assigned

[grantfox-oss]

🦊 GrantFox — @senmalong has been assigned to this issue as part of the Official Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #31)
2. Your PR will be reviewed by the clevercon-protocol maintainers

Good luck! Track your progress on GrantFox.

[Bosun-Josh121]

@senmalong any updates? Otherwise you'll be unassigned

[grantfox-oss]

🦊 GrantFox — @mijinummi has been assigned to this issue as part of the Official Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #31)
2. Your PR will be reviewed by the clevercon-protocol maintainers

Good luck! Track your progress on GrantFox.

[Bosun-Josh121]

@mijinummi pls notify is you can take the task