feat(typescript): add M2M Sentinel action provider for Base bytecode & proxy observations

[AntoineSakkalis]

Summary

Adds the M2M Sentinel Action Provider to @coinbase/agentkit (TypeScript) to equip autonomous AI agents with deterministic preflight smart contract bytecode capability inspection, proxy resolution, and market telemetry on Base Mainnet (chainId: 8453) in <35ms.

---

Key Capabilities

• Proxy Resolution: Resolves EIP-1967, UUPS, and Beacon proxy implementation slots before agents interact with unverified contracts.
• Bytecode Capability Checks: Inspects target contracts for pause/freeze controls, token mint selectors, and opcode traps.
• Base Gas & Price Telemetry: Median pool pricing across Base DEXes and priority gas suggestions.
• Deterministic EVM Truth: Pure bytecode observations with explicit unknown states (notASafetyGuarantee: true).

---

Actions Provided

1. audit_contract: Inspect target Base contract bytecode capability observations, proxy implementation slots, and limitations (address: string).
2. get_gas_metrics: Get real-time Base network gas execution metrics and priority fee recommendations.
3. get_token_price: Observe real-time Base DEX token prices for slippage checks and preflight valuation (symbol: string).
4. get_service_status: Check operational status and trust quorum of M2M Sentinel verification rails.

---

Resources & Upstream Links

• Public SDK Repository: https://github.com/M2M-Sentinel/m2m-sentinel-sdk
• npm Package: https://www.npmjs.com/package/m2m-sentinel-sdk
• Documentation & Web Portal: https://m2msentinel.com
• OpenAPI 3.1 Specification: https://api.m2msentinel.com/openapi.json

---

Test Plan

• Added Vitest unit tests in m2mSentinelActionProvider.test.ts covering network validation (Base mainnet 8453 and Base Sepolia 84532) and action execution mocks.
• Tested end-to-end against live Base Mainnet RPC and M2M Sentinel production gateway.

[cb-heimdall]

🟡 Heimdall Review Status

Requirement	Status	More Info
Reviews	🟡 0/2	Denominator calculation Show calculation 1 if user is bot 0 1 if user is external 0 2 if repo is sensitive 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 1 Sum 2

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.