@ethosagent/tools-india-macro

Indian macroeconomic data tools for Ethos AI agents. Provides RBI monetary policy, CPI/WPI inflation, GDP, industrial production, G-sec yields, and USDINR -- all cached locally in SQLite so agents never hammer live APIs.

Part of the Ethos AI agent ecosystem. These tools are designed to be registered with an Ethos agent via createIndiaMacroTools(). They can also be used standalone via the CLI.

Install

npm install @ethosagent/tools-india-macro

CLI Usage

india-macro rbi                        # RBI policy rates + MPC stance
india-macro mpc --limit 6              # Last 6 MPC decisions
india-macro inflation                  # CPI inflation trend
india-macro gdp                        # GDP growth trend
india-macro gsec --tenor 10Y           # 10Y G-sec yield
india-macro fx --days 30               # USDINR history
india-macro brief                      # Full macro snapshot
india-macro refresh                    # Force-refresh all data
india-macro status                     # Cache status
india-macro clean                      # Wipe cached data
india-macro version                    # Print version
india-macro help                       # Print help

Library Usage

import { MacroDataStore, createIndiaMacroTools } from '@ethosagent/tools-india-macro';

// Use the store directly
const store = new MacroDataStore('~/.ethos/macro-data/macro.db');
const snapshot = store.getRbiSnapshot();
store.close();

// Or get Ethos-compatible tools
const tools = createIndiaMacroTools();
for (const tool of tools) {
  console.log(tool.name, tool.description);
}

Ethos Integration

import { createIndiaMacroTools } from '@ethosagent/tools-india-macro';

for (const tool of createIndiaMacroTools()) {
  toolRegistry.register(tool);
}

Data Sources

| Source | What | Auth | |---|---|---| | World Bank Open Data | CPI, GDP, current account, FX reserves | None | | RBI DBIE | Repo rate, CRR, SLR, MSF rate | None | | Yahoo Finance | USDINR=X, G-sec yield proxies | None | | RBI press releases | MPC decisions, stance | None |

All sources are free and keyless. No API key configuration required.

Tools

| Tool | Description | |---|---| | india_macro_rbi | RBI monetary policy snapshot | | india_macro_inflation | CPI/WPI inflation trend | | india_macro_gdp | GDP growth trend | | india_macro_gsec | G-sec yield curve | | india_macro_usdinr | USDINR exchange rate | | india_macro_brief | Single-call macro snapshot | | india_macro_refresh | Force-refresh cached data |

Development

npm install          # install dependencies
npm run check        # typecheck + lint + test
npm run build        # tsup -> dist/
npm run dev          # tsup --watch
make help            # list all targets

Environment

INDIA_MACRO_DB=~/.ethos/macro-data/macro.db   # SQLite database path (default)

License

MIT