Intramedial is in restricted beta. At sign up or sign in, you have to provide the beta tester password you received or request one at preview@intramedial.com. Thank you.
Loading…
yards.listModule 44
Plane module
Registered yards
See every persistent, governed yard registered with this workspace, each with its own constitution and the posts that staff it.
yards.list reads the yards your fleet actually runs in. Each yard gets its own id, a venue, a rules pack and seven standard posts the moment it is created, and other routes fork, migrate, amend or tear one down.
Agents act when the plane says yes, and the record says why.
Put admission in front of your MCP servers, repositories, SaaS tools and cloud accounts. Every agent gets a lease or a reason – and you keep the lever to stop any of them.
local, cloud, wnam, weur, apac or oc; an unknown venue is refused rather than accepted as free text.
open
Whether the yard is still running.
participantDids
The agents staged into the yard.
migrations
The yard's venue-change history, each hop chained to the last.
fork
Present when the yard is itself a fork, naming its source yard and its redactions.
Mechanism
Step by step
How it works
A yard is registered
create records a yard with a title, packId and venue, and stages the fleet named in participantDids.
Seven posts are staffed automatically
Creation calls roles.charters's staffing routine, which fills yardmaster, steward, librarian, gatekeeper, clerk, auditor and treasurer for the new yard before anything else happens.
Changes go through a diff first
plan previews a manifest change as a diff with a digest; apply only takes effect with a matching human approval or coverage under a ratified bound, never on the manifest alone.
A fork samples, never copies whole
fork builds a real yard from a sample of the source's data, with named fields redacted, and can be marked ephemeral so it can never be promoted back.
Migration moves venue, not compute
migrate commits a Merkle-chained continuity proof for a venue change. It explicitly does not move Durable Objects; that is plane-wide rehoming.plan.
Try it
Live demo
Run it from this page
GET/api/v1/acp/yards/list
// No body: this is a GET. Press Run.
Runs in a shared demo workspace with a demo key: anyone can see what it holds, so send nothing private. yards.list docs
Responses
Press Run to send the request on the left to the shared demo workspace.
Runs in a shared demo workspace with a demo key: anyone can see what it holds, so send nothing private.
Code
Live example
A real request
A request in the shape the API accepts, and an example response in the shape the module returns.
An operator reads yards.list to see every yard a fleet actually runs in today, not a plan of what should exist.
Previewing a policy change before it lands
plan shows the exact diff a manifest change would make, with a digest, before anyone approves it or a bound lets it through.
Trying a change on a sampled copy first
A fork samples a quarter of the source yard's data by default and hides participant DIDs, so a risky change can be tried without touching production or its people.
A migration moves paperwork, not machines
A migrate response reports movesDurableObjects: false explicitly, so nobody mistakes a venue record change for an actual data move.
When to use something else
Hiring Hall or crystallization. import is a hard 501 until the separate import contract is satisfied; this module only wraps what already exists in-tree.
Moving Durable Objects across tenants. plan-merge and split-plan are simulations that explicitly never merge or split real storage.
Deciding what an agent inside the yard may do. That is mandates.compile and coordination.admit; a yard is where work happens, not what authorizes it.
Evidence
Guarantees
What it does, and what it does not
A module is a strong claim about a narrow thing. Rely on it for exactly what it is.
It does
A yard reads from yards.list exists with a real id, venue and rules pack, not a planned or templated entry.
A manifest change cannot apply without either a digest-bound human approval or coverage under a ratified bound; the sweeping grant */**/all can never be covered by a bound.
A fork is a real, separately listed yard with its own seven posts, not a read-only preview pane.
A migration's continuity proof is Merkle-chained to the one before it, so a stale or out-of-order from is refused.
It does not
That a migration relocated the yard's actual compute. migrate moves the recorded venue and commits a proof; Durable Objects stay where rehoming.plan puts them.
That plan-merge or split-plan changed anything. Both report wouldMergeDos/wouldSplitDos as false and touch nothing.
That an ephemeral fork can ever become the thing it forked from. mark-ephemeral makes promotion permanently refused for that fork.
Details
Build notes
Before you build
Posts bind to a role, not a holder
A post is addressed by role + yardId, never by DID, so re-staffing it does not require anything that depends on it to notice or change.
Apply used to skip the diff entirely
An earlier version of apply took a manifest and persisted it with no diff, no plan and no approval check at all. That hole is closed; every apply now goes through plan or a bound.
An unreadable pack fails closed
If the current manifest pack cannot be read, apply refuses with 503 rather than treating the organization as having no existing grants.
Limits and metering
import always answers 501 until its own contract document is marked ready, regardless of store state.
A bound can never cover a sweeping grant on *, ** or all; that floor is not configurable down.
Only list and get are exposed over MCP; create, plan, apply, fork, migrate and teardown are REST-only operator actions today.
Access
API & MCP
REST and MCP
Authenticate with a workspace API key as a Bearer token. The base URL is https://api.intramedial.com.
REST endpoints
GET/api/v1/acp/yards/listList this workspace's registered yards.
GET/api/v1/acp/yards/getRead one yard by id.
MCP actions
MCPcoordination.yards.listList yards as an MCP action.
MCPcoordination.yards.getRead one yard as an MCP action.