AgentsJob agents.job@1
Generated at from
openvibe-contracts v0.443.0 and
openvibe-sdk v0.177.0.
- Version
- 1.0.0
- Owner
- actor
- Visibility
- public
- Status
- active
- Compatibility
- backward
- Decision
- ADR-044
- Schema
https://openvibe.network/contracts/agents/job.v1.json
agents.job@1 (one-system-v2.md §7): one job placed on a machine: a check (a repository's tests or one workflow job), a review (an agent of another family reads a diff), a build, an eval, an improvement candidate, a desk or a model. NEEDS is what the place must have; TRUST is public (public code only, no secret ever reaches the place, so community nodes may take it) or owner (only the owner's own machines). PLACEMENT is the scheduler's: cheapest that can, least busy, most reliable; a job that fails because its place went away is tried on another (ATTEMPTS). RESULT carries a named exit, the duration and a link to the masked log. Secrets never travel in a job: a place gets a short-lived token scoped to that one job.
Fields
| Field | Type | Required | Description | Constraints |
|---|---|---|---|---|
id | string | yes |
| |
kind | enum | yes |
| |
title | string |
| ||
status | enum | yes |
| |
trust | enum | yes |
| |
repo | object |
| ||
repo.url | string | yes |
| |
repo.ref | string |
| ||
repo.sha | string | yes |
| |
run | object | What to run: one command, or one job of a workflow file (act's semantics: stages of steps, outputs through files). |
| |
run.command | string |
| ||
run.workflow | string |
| ||
run.job | string |
| ||
run.matrix | object | |||
needs | object |
| ||
needs.os | enum |
| ||
needs.cpus | integer |
| ||
needs.memory_mb | integer |
| ||
needs.gpu | boolean | |||
needs.node | string |
| ||
needs.browser | boolean | |||
needs.tools | array of string |
| ||
budget | object |
| ||
budget.seconds | integer |
| ||
budget.usd | number |
| ||
placement | object | null | |||
attempts | integer |
| ||
result | object | null | |||
parent_run | string | The run that asked for it (agents.run@1 ref), when one did. |
| |
created_at | string | yes |
| |
updated_at | string |
|
Examples
From the contract's own test fixtures: valid ones validate, rejected ones must fail.
Valid: a-check-on-a-shared-node
{
"id": "job_01JD8C4QJ7Z3K9W2X5V6N1M0PA",
"kind": "check",
"title": "OpenVibe.Shared #513: test",
"status": "passed",
"trust": "public",
"repo": {
"url": "https://github.com/OpenVibers/OpenVibe.Shared",
"ref": "own-icon-markup-1112",
"sha": "768ed2a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6"
},
"run": {
"workflow": ".github/workflows/ci.yml",
"job": "test"
},
"needs": {
"os": "linux",
"cpus": 2,
"memory_mb": 4096,
"node": "22"
},
"budget": {
"seconds": 1800
},
"placement": {
"node": "lnk_01M78BBHN4QDE4NP06T8J5N0NR",
"name": "ov-node-01",
"why": "free, idle, 100% of its last 20 checks finished",
"placed_at": "2026-11-12T23:00:00Z"
},
"attempts": 1,
"result": {
"exit": "passed",
"summary": "41/41 test files passed",
"duration_ms": 412000
},
"created_at": "2026-11-12T23:00:00Z",
"updated_at": "2026-11-12T23:00:00Z"
}Valid: a-review-queued
{
"id": "job_01JD8C4QJ7Z3K9W2X5V6N1M0PB",
"kind": "review",
"status": "queued",
"trust": "public",
"repo": {
"url": "https://github.com/OpenVibers/OpenVibe.Live",
"sha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
},
"placement": null,
"created_at": "2026-11-12T23:00:00Z"
}Rejected: a-secret-in-the-run
{
"id": "job_01JD8C4QJ7Z3K9W2X5V6N1M0PC",
"kind": "check",
"status": "queued",
"trust": "public",
"run": {
"command": "npm test",
"env": {
"TOKEN": "x"
}
},
"created_at": "2026-11-12T23:00:00Z"
}Rejected: a-trust-nobody-has
{
"id": "job_01JD8C4QJ7Z3K9W2X5V6N1M0PD",
"kind": "check",
"status": "queued",
"trust": "anyone",
"created_at": "2026-11-12T23:00:00Z"
}Validate
const contracts = require('openvibe-contracts');
contracts.validate('agents.job@1', value); // { valid, errors: [{ path, message }] }