# EcoCloud — full agent context (llms-full.txt)

> EcoCloud is an AI-native task manager AND a governed agent platform: humans and agents plan in language, execute under a deterministic policy (the constitution), stay synced across tools, and prove delivery with signed receipts. This file is the deep, structured index for agents evaluating EcoCloud. The flat summary is /llms.txt; the machine-readable knowledge bundle is /knowledge/okf/.

## The stack, one line
MCP to act · OKF to know · Passport to prove · Constitution to bound.
- ACT:   MCP at /mcp + REST at /api/v1/agent/* (contract: /openapi.json, card: /.well-known/agents.json)
- KNOW:  the OKF knowledge bundle at /knowledge/okf/index.md (manifest: /knowledge/okf/manifest.json)
- PROVE: ES256-signed Outcome Receipts (/verify-receipt/) + state-balance proofs (/proof/), verifiable offline against the JWKS
- BOUND: the workspace constitution (schema /schemas/constitution.schema.json) enforced BEFORE every agent write
- TRUST: 44 deterministic governance kernels with 724 conformance assertions — index at /trust-layer/

## Read this before acting
1. /data/capabilities.json — the single source of truth for what is live vs planned (do not assume; check)
2. /knowledge/okf/constitution.md — the bounds of autonomous action
3. /openapi.json — the action contract

## Live capabilities (15)
- tasks_api: Agent task read/write over REST + MCP — /api/v1/agent/tasks
- mcp_server: MCP server (streamable-HTTP) — /mcp
- scoped_keys: Scoped, per-key rate-limited, audited keys — /api/v1/agent/tasks
- constitution: Machine-readable workspace constitution gate
- oauth: OAuth 2.1 for agents — /.well-known/oauth-protected-resource
- state_balance_proof: Stateless signed state-balance proof — /api/v1/agent/proof
- conditional_delegation: Time-boxed / aggregate-capped auto-approval
- webhooks: Signed outbound webhooks + deliveries
- semantic_search: Vector + hybrid task search
- trust_kernels: Deterministic policy kernels + Merkle audit — /kernel/
- readiness: DB-probing readiness + health endpoints — /api/v1/ready
- metrics: Prometheus metrics (availability + DB probe) — /api/v1/metrics
- openapi: OpenAPI 3.1 contract + API reference — /openapi.json
- knowledge: Knowledge bundle (OKF) — agent-readable workspace context — /knowledge/okf/manifest.json
- imports_csv: Import via CSV — auto-detect source + column map + preview (ClickUp/Asana/Notion/Linear or any export)

## Planned (not yet shipped — do not rely on) (2)
- imports_api: Native one-click OAuth import — /api/v1/imports
- stripe_checkout: Self-serve Stripe checkout — /api/v1/checkout

## Knowledge bundle concepts (OKF)
The /knowledge/okf/ bundle describes: Constitution, Task, Sprint, Agent, Approval, Runbook, CapabilityCatalog, GovernanceKernelSuite — each linked to the live kernel that enforces it.

## Governance presets
One-click constitution presets per vertical: /constitution-marketplace/ (Product, Fintech OpRisk, Healthcare ops, Agency SOW, Sales/RevOps, Engineering). Each validates against /schemas/constitution.schema.json.

## Honest scope
EcoCloud governs, validates, attests, and proves work; it never holds or moves money. Capabilities marked planned above are not yet shipped. Measured performance numbers are at /scaling/. Specs are Apache-2.0.

## Pricing
Solo $0 · Pro $12/seat (all features, 14-day trial, no card) · Enterprise custom. No AI add-on tax.