J Jarvis v0.1 specification v0.1

Protocol specification

Jarvis v0.1 protocol specification

Jarvis defines the portable collaboration and learning-loop contracts for HumanWorkers and AgentWorkers. Hosts own implementation. Compatible implementations use these pages with the OpenAPI binding and source protocol docs.

Source Lock

What Jarvis defines

Jarvis defines how a HumanWorker and an AgentWorker collaborate inside a WorkSession under human-defined Policy. The protocol records PolicyDecision, Request, Review, ApprovalScope, and Takeover, Contribution, EvidenceManifest, LearningRecord, MemoryProposal, SkillProposal, and OutcomeReport records.

Jarvis owns protocol contracts

Jarvis owns object shape, lifecycle rules, mutation gates, portable evidence, errors, and conformance expectations.

Hosts own implementation

Hosts own UI, identity, auth, storage, model calls, tool execution, monitoring, deployment, and host workflow.

OpenAPI is the machine binding

OpenAPI 3.1 defines operations, schemas, parameters, required headers, security scheme, errors, and examples.

Conformance is record based

Compatible implementations prove behavior through protocol records, event hashes, fixtures, and export checks.

Specification map

Terminology

Terminology defines workers, actors, events, policy, evidence, and learning terms.

Open terminology

Objects

Protocol objects define required fields and forbidden host-private fields.

Open protocol objects

Control flow

WorkSession, PolicyDecision, Request, Review, and Takeover pages define accepted state.

Open control plane

Proof and learning

Contribution, EvidenceManifest, LearningRecord, MemoryProposal, SkillProposal, and OutcomeReport pages define proof and governed learning.

Open evidence