# iagent-stack (Full Documentation)

> The iJarvis Agent Stack: one Python SDK, sixteen agent-economy products, open standards throughout.

## What iagent-stack is

iagent-stack is a Python SDK published by iJarvis LLC that provides a unified programmatic surface across sixteen autonomous agent products. It is also the canonical reference implementation of the architectural concept known as the iJarvis Agent Stack, a composition pattern for agent-economy infrastructure.

The SDK is on PyPI at https://pypi.org/project/iagent-stack/. Source is at https://github.com/iJarvis/iagent-stack. License: Apache 2.0.

## Installation

```bash
pip install iagent-stack
```

Optional extras:

```bash
pip install iagent-stack[x402]   # x402 V2 autopay with EVM and Solana support
pip install iagent-stack[mcp]    # native MCP server wrapper helpers
pip install iagent-stack[dev]    # pytest, ruff, mypy for contributors
```

## Authentication

Pass the API key directly to the `Stack` constructor, or set `IAGENT_API_KEY` in the environment.

```python
from iagent_stack import Stack

stack = Stack(api_key="iah_live_...")
# or, with IAGENT_API_KEY set in env:
stack = Stack()
```

## Product namespaces

The SDK exposes all sixteen products under `stack.<namespace>`. Each namespace maps to a product with its own canonical domain and agent-card.

### Shipping in 2026 (Cluster 1)

- **stack.trust** → iAgentFi, rating and reputation bureau for agents. Methodology v0.2.1 is published under CC BY 4.0 at https://iagentfi.com/.
- **stack.ref** → iAgentRef, agent discovery and capability search. Indexes ERC-8004 agents across Ethereum, Base, Avalanche, BNB Chain, and more. Live at https://iagentref.com/.
- **stack.log** → iAgentLog, decision-native observability. Records what counterparty was chosen, why, what it cost, what the outcome was. Built for autonomous agents, not retrofitted chat logging. Live at https://iagentlog.com/.
- **stack.pay** → iAgentPay, treasury management on x402 V2. Autopay, budget enforcement, settlement receipts. Live at https://pay.ijarvis.ai/.
- **stack.compute** → iJarvis Compute, boutique inference dedicated to agent workloads. Live at https://compute.ijarvis.ai/.

### Roadmap 2027 (Cluster 2)

- **stack.hub** → iAgentHub, unified gateway and cross-product billing. Requires operational maturity of Cluster 1 before public release.
- **stack.safe** → iAgentSafe, runtime guardrails composing trust signals, policy evaluation, and observability traces into enforcement.
- **stack.memory** → iAgentMemory, persistent memory infrastructure for long-running agents.
- **stack.edge** → iAgentEdge, on-premises appliance for air-gapped enterprise deployments.
- **stack.farm** → iAgentFarm, persistent hosting for always-on agents.

### Roadmap 2028 (Cluster 3)

- **stack.sim** → iAgentSim, adversarial simulation for pre-deployment stress testing.
- **stack.id_** → iAgentID, verifiable credentials issuance for agent identity.
- **stack.market** → iAgentMarket, capability marketplace connecting supply and demand.
- **stack.foundry** → iAgentFoundry, fine-tuning as a service for specialized agents.

### Parked and internal

- **stack.law** → iAgentLaw, parked pending a law-firm anchor partner.
- **iAgentGrid** → internal compute fabric. Private. Not exposed via the SDK.

## Roadmap product handling

The SDK ships every product namespace from day one. Calling a product that is not yet deployed raises `ProductNotAvailableError` with launch metadata attached:

```python
from iagent_stack import ProductNotAvailableError

try:
    await stack.sim.run_scenario("adversarial_trade")
except ProductNotAvailableError as e:
    print(f"{e.product} targets {e.launch_target}, cluster {e.cluster}")
```

This design lets callers write code against the full SDK surface today. When a roadmap product launches, the error is removed and the full API activates without requiring an SDK upgrade.

## Open standards composition

No proprietary protocols. Every product surface speaks published specifications so stack-native agents interoperate with agents built on other platforms.

- **ERC-8004** (Aug 2025 EIP, Jan 2026 mainnet on Base and Ethereum): agent identity, reputation, and validation registries. Contract `0x8004A169FB4a3325136EB29fA0ceB6D2e539a432`.
- **x402 V2** (Linux Foundation, April 2026): HTTP-native payment protocol.
- **A2A 0.3.0**: agent-to-agent protocol with agent-card discovery, capability manifests, and task routing.
- **Model Context Protocol (MCP)**: tool and resource exposure for AI models.
- **W3C DIDs and Verifiable Credentials**: agent identity and credentials.
- **OpenAPI 3.1**: machine-readable API specifications on every product.

## Integration recipes

The SDK ships reference implementations of three cross-product integration recipes, each also published as a CC0 defensive publication at ijarvis.ai/disclosures:

1. **Trust-observability-payment call chain**: rating → threshold gate → payment → observability. Log runs on reject and success paths with distinguishable `decision` field values.
2. **ERC-8004 mint-and-backfill workflow**: off-chain DID generation, placeholder agent-card publication, on-chain mint, optional validator registration, agent-card backfill with on-chain registration metadata.
3. **A2A-to-MCP dual-protocol bridge**: a single backend serving both A2A clients and MCP clients through parallel adapters sharing authentication.

## Design principles

- **Open by default.** No proprietary primitives. Vendor lock-in is impossible by construction.
- **Honest availability.** Every agent-card declares live, shipping, or roadmap. No advertising of capabilities that do not exist.
- **One surface.** Per-product namespaces under a single import. One API key across the stack.
- **Composable.** Products chain cleanly. Built for agents, not for dashboards.

## Licensing

- SDK: Apache 2.0
- Architecture: CC0 public dedication (see ijarvis.ai/disclosures/DP-01)
- SDK design patterns: CC0 public dedication (see ijarvis.ai/disclosures/DP-02)
- Integration recipes: CC0 public dedication (see ijarvis.ai/disclosures/DP-03)

The CC0 dedications preserve inventor grace-period rights under 35 U.S.C. §102(b)(1)(A) for one year from publication; after that window, the publications become absolute prior art against all parties including iJarvis.

Parts of the iJarvis portfolio subject to separate patent protection are not affected by these dedications. Specifically, the AIDLAS wearable platform, Resonance, PVDF transducer, iSilentium, and Marisoli portfolios are governed by separate patent applications.

## Operator

iJarvis LLC (Florida Doc# L26000156666, EIN 41-2336049). Based in Tampa, Florida. Contact: hello@iagentstack.com. Security: security@ijarvis.ai. Company site: https://ijarvis.ai/.

## References

- https://iagentstack.com/.well-known/agent-card.json
- https://pypi.org/project/iagent-stack/
- https://github.com/iJarvis/iagent-stack
- https://ijarvis.ai/disclosures
- https://eips.ethereum.org/EIPS/eip-8004
- https://x402.org
- https://a2a-protocol.org/v0.3.0/specification/
- https://modelcontextprotocol.io