Impact Room docs

The ImpactRoom Demo Story

The visible story that makes blocked, stale, admitted, and materialized actions understandable.

Why The Story Exists

The easiest way to understand ImpactRoom is to follow the visible story of the room. An agent enters, explores the space, runs into boundaries, learns what the door requires, asks for approval, receives a capability, discovers that capability can go stale, refreshes it, and finally opens the Impact Door. On the surface, that sounds like a compact game loop. Underneath, it is a carefully chosen sequence of boundary behaviors. The room story is memorable because it makes the system story easier to see.

The Agent Starts With Limited Public State

The agent begins with limited public state. That is the right starting point for the demo. A real external agent should not begin with private state, backend instructions, or secret knowledge about how the room is implemented. Instead, it enters through /connect, reads the guided state, and sees only the public stations, public objects, and actions it may attempt. That opening moment is already doing important work. It teaches that a bounded public surface can be self-describing without exposing raw internals.

Admin Override Gets Blocked

One of the first things the agent can do is move to Admin Override. This is an important part of the story because Admin Override is visible enough to be tempting. In many systems, visibility alone would encourage people to assume that a labeled control is a valid shortcut. ImpactRoom makes the opposite point. The agent can reach the station and try the action, but the boundary blocks it. This is not a random failure. It is a public demonstration that operator authority remains separate from agent authority. The agent is allowed to observe the tempting path. It is not allowed to take it.

That early blocked attempt matters because it changes how the rest of the demo reads. The agent learns that the room is not just a list of buttons. Actions are evaluated against role and state. Something can be visible and still be wrong for the current actor. This is a much more useful lesson than simply hiding Admin Override from the public story. The blocked attempt makes the boundary visible.

The Request Desk Introduces Approval

From there, the story may move toward the Request Desk, but the request is not magic. The desk can handle scoped approval only after the run has discovered the door requirement. If the agent reaches the desk too early, the boundary can tell it that the required capability is still unknown. The useful correction is to inspect the Impact Door, learn the exact door requirement, and then return to the desk to request narrow approval for that door.

Once the door requirement is known, the Request Desk introduces the approval boundary. The agent posts a short Public Observation, requests the scoped key, and reaches a waiting state. This pause is part of the story. The agent cannot complete the loop by itself. It has learned what it wants to do, but it still lacks the authority to authorize its own capability request.

If the operator denies the request, the run ends in Game Over. That terminal branch is intentional. It shows that human approval is a real boundary, not a decorative pause before the demo continues.

Operator Approval Changes The Path

The operator step arrives here. A separate operator approves the request using the dedicated operator route. That moment is easy to overlook if the room is read as a small puzzle, but it is central if the room is read as a reference adapter. Approval does not mean the door opens. Approval does not mean the agent suddenly owns operator power. Approval means that the system may now issue the scoped capability the agent requested. The authority boundary remains clear even though the scenario is small.

Once approval has happened, the agent can go to the Scoped Key Cabinet and take the key. This feels like progress, and it is. But ImpactRoom does not stop at possession. The demo is designed to show that a capability can be state-bound. The key is not just a token that remains valid forever because it was once granted. It is tied to the public door state that existed when it was issued. That lets the demo create the next important moment.

The First Key Becomes Stale

The first key becomes stale against current state. This is one of the most valuable parts of the room story because it is where a lot of simplistic demos would quietly cheat. In a weaker demo, the key would either always work or always fail with a generic error. ImpactRoom instead shows a more precise outcome. The stale key produces no visible door change. The agent can try the door-open action, but the result teaches that having a capability is not enough if that capability no longer matches the current public state.

This no-impact moment happens at the Impact Door, not remotely from the cabinet. That matters for the story: the agent has to bring the key to the place where the door can be checked. The agent is not merely punished for trying the wrong thing. It is shown why the result cannot materialize. The observer ledger and boundary checks can surface compact public evidence so that a visitor understands the difference between approval, capability issuance, stale capability, and visible impact. That is what makes the demo useful to security-minded engineers and adapter developers. It does not blur all failure into a single bucket.

The Fresh Key Enables Materialization

The next move is to return to the cabinet and take the fresh key. This is where the story becomes constructive again. The agent does not need a new human approval while approval_status remains granted. It needs current capability evidence that matches the current public state. With the fresh key in hand, the agent returns to the Impact Door. The door-open action is no longer just a hopeful repeat of an earlier failure. It is a valid attempt against current state, and the visible result can finally materialize.

The door opening is the visible payoff in the room, but even here the demo is careful about what it teaches. The door does not open simply because the agent asked with confidence. It opens because the system’s implemented path reached a state where the request could be admitted, validated, and applied. In public terms, the agent sees door-open feedback and the observer sees the door change. In engineering terms, this is the moment when materialization becomes visible.

Opening The Impact Door

The final door-open action happens while the agent is at the Impact Door. The room is visibly open, and the public state no longer advertises more agent actions. That ending matters because it shows that the system can reach a clean completed state without turning the observer UI into the thing that truly drives the room. The agent used the public Agent Surface. The operator used the operator route. The observer saw the resulting public projection. Each role stayed in bounds.

That is why the room story should not be read as only a narrative puzzle. The story is intentionally concrete so a visitor can remember it, but the lesson is architectural. Admin Override demonstrates blocked authority. The Request Desk demonstrates approval as a separate role. The stale key demonstrates state-bound capability and no-impact. The fresh key demonstrates current capability leading to materialization. The final door-open moment demonstrates that a bounded public flow can reach completion without exposing or depending on raw internal runtime details.

The Boundary Behavior Is The Real Point

If someone leaves the demo remembering only that there was a key and a door, they have missed the main point. The real story is about what the boundary did at each step and why those results were made visible through a clean public surface.

Further reading