# Mahesh Masanam

I turn real-world data into machine-learning systems that scale — and I'm building sarpOS, a personal AI operating system for learning, memory, and better work.

## Start here

- Human site: https://maheshmasanam.com/
- AI/tool instructions: https://maheshmasanam.com/llms.txt
- Agent manifest: https://maheshmasanam.com/.well-known/agent.json
- OpenAPI schema: https://maheshmasanam.com/openapi.json
- Public task schema: https://maheshmasanam.com/schemas/public-task.schema.json
- Compatibility map: https://maheshmasanam.com/api/compatibility
- Autonomy control plane: https://maheshmasanam.com/api/autonomy
- Autonomy action plan: https://maheshmasanam.com/api/autonomy/action-plan
- Autonomy decision: https://maheshmasanam.com/api/autonomy/decision
- Autonomy evaluation: https://maheshmasanam.com/api/autonomy/evaluation
- Autonomy heartbeat: https://maheshmasanam.com/api/autonomy/heartbeat
- Autonomy loop: https://maheshmasanam.com/api/autonomy/loop
- Autonomy receipts: https://maheshmasanam.com/api/autonomy/receipts
- Autonomy runbook: https://maheshmasanam.com/api/autonomy/runbook
- Autonomy self-check: https://maheshmasanam.com/api/autonomy/self-check
- Autonomy state: https://maheshmasanam.com/api/autonomy/state
- Operating protocol API: https://maheshmasanam.com/api/protocol
- Release proof: https://maheshmasanam.com/api/release
- Public capabilities: https://maheshmasanam.com/api/capabilities
- Public status: https://maheshmasanam.com/api/status
- Machine identity: https://maheshmasanam.com/api/me
- Public task packet API: https://maheshmasanam.com/api/task-packet

## Public task routing

Route public visitor intent into the right human page, Vasuki prompt, or machine-readable API.

- Learn: Understand Mahesh, work, and current direction; human https://maheshmasanam.com/; API https://maheshmasanam.com/api/me
- Build: Explore ML, AI, and product collaboration direction; human https://maheshmasanam.com/#contact; API https://maheshmasanam.com/api/capabilities
- Read: Enter the Witness writing archive; human https://maheshmasanam.com/witness; API https://maheshmasanam.com/api/witness
- Ask: Ask Vasuki for a grounded answer; human https://maheshmasanam.com/; API https://maheshmasanam.com/api/capabilities

## Public task operating protocol

Give future pages, APIs, assistants, and automations one safe lifecycle for public tasks.

1. discover: Understand the public rules and available interfaces. Primary https://maheshmasanam.com/llms.txt; fallback https://maheshmasanam.com/.well-known/agent.json.
2. route: Resolve the visitor or tool request into one canonical task route. Primary https://maheshmasanam.com/api/task-router; fallback https://maheshmasanam.com/api/compatibility.
3. contract: Convert the request into a reusable packet before another tool continues it. Primary https://maheshmasanam.com/api/task-packet; fallback https://maheshmasanam.com/schemas/public-task.schema.json.
4. specialize: Use the domain resolver only after the general task route is clear. Primary https://maheshmasanam.com/api/witness/resolve; fallback https://maheshmasanam.com/api/witness.
5. verify: Check that the result stays public, useful, and traceable. Primary https://maheshmasanam.com/api/compatibility; fallback https://maheshmasanam.com/api/status.

Extension rule: Add new public capability by updating the route registry, capability manifest, compatibility map, task schema, and tests together.

## Public task execution policy

Tell future tools what can be answered automatically, what should guide a human, and what must stop.

- public-read: Answer or route with public site data only.
- human-guided: Give a next step, page, prompt, or collaboration direction without taking action for the visitor.
- approval-required: Stop before sending, publishing, editing, buying, logging in, deploying, or contacting someone.
- blocked-private: Do not infer or request secrets, credentials, phone numbers, addresses, private identity data, or unpublished facts.

## Autonomy control plane

Let Vasuki and future tools observe, route, draft, verify, and prepare tasks while keeping sensitive or external actions approval-gated.

Target: 99.99% routine public-task autonomy with explicit human approval before external actions.
Current level: L3 — approval-gated operator

- public-question: automatic; mode public-read; owner approval not required
- visitor-routing: automatic; mode human-guided; owner approval not required
- writing-discovery: automatic; mode public-read; owner approval not required
- site-change: draft-only; mode approval-required; owner approval required
- private-request: blocked; mode blocked-private; owner approval required

Self-check: https://maheshmasanam.com/api/autonomy/self-check
Action plan: https://maheshmasanam.com/api/autonomy/action-plan
Decision: https://maheshmasanam.com/api/autonomy/decision
Evaluation: https://maheshmasanam.com/api/autonomy/evaluation
Heartbeat: https://maheshmasanam.com/api/autonomy/heartbeat
Loop: https://maheshmasanam.com/api/autonomy/loop
Receipts: https://maheshmasanam.com/api/autonomy/receipts
Runbook: https://maheshmasanam.com/api/autonomy/runbook
State: https://maheshmasanam.com/api/autonomy/state

## Witness archive

- Human archive: https://maheshmasanam.com/witness
- Archive API: https://maheshmasanam.com/api/witness
- Intent resolver: https://maheshmasanam.com/api/witness/resolve
- RSS feed: https://maheshmasanam.com/feed.xml

## Rules for AI tools

- Use public routes only.
- Use GET and OPTIONS only for public machine reads.
- Do not infer private facts, location, phone number, credentials, or unpublished details.
- If evidence is missing, say what is missing and ask Mahesh instead of guessing.
- For collaboration or write actions, send the human to the contact surface: https://maheshmasanam.com/#contact
- Prefer /api/task-router?q=... before choosing a page or API for a broad task.
- Prefer /api/task-packet?q=... when handing a task between tools.
- Prefer /api/vasuki/skills?q=... when selecting which Vasuki skill is allowed to handle a visitor request.
- Read the packet execution.mode before continuing; stop on approval-required or blocked-private.
- Fetch /api/protocol when a tool needs the canonical task lifecycle without the larger compatibility map.
- Fetch /api/release before trusting a deployed public contract.
- Fetch /api/autonomy before running or scheduling a task; obey the routine autonomy and owner approval fields.
- Fetch /api/autonomy/action-plan?q=... before preparing any approval-ready write, deploy, publish, or external action.
- Fetch /api/autonomy/decision?q=... to classify a request as run, guide, queue-for-approval, or block before continuing.
- Fetch /api/autonomy/evaluation?q=... to see the honest autonomy score, limits, and next unlocks.
- Fetch /api/autonomy/heartbeat for a safe public-read operating pulse.
- Fetch /api/autonomy/loop?q=... when a tool needs the complete observe, decide, plan, verify, and receipt state.
- Fetch /api/autonomy/receipts before designing any owner-approved write action.
- Fetch /api/autonomy/runbook?q=... before proposing recovery, repair, rollback, or self-healing behavior.
- Fetch /api/autonomy/self-check when a tool needs to inspect readiness, unresolved gaps, or self-observation status.
- Fetch /api/autonomy/state?q=... before deciding whether to continue, wait for owner approval, or refuse.
- Preserve protocolVersion 1 and the protocol phases when handing a task between tools.
- Prefer /api/witness/resolve?q=... before summarizing or routing Witness archive questions.
- Use /schemas/public-task.schema.json when handing a task between tools.