Feature · Agents in shared surfaces

Human+

Participant presence for Prism agents in live Fancy surfaces. An agent joins the same controlled, JSON-serializable surface a person sees, and works through the handles that surface already exposes.

It enters through an explicit invitation, discovers only the tools your trust policy allows, and reads every result as untrusted data.

  • PHP
  • TypeScript
  • Python

Capabilities

What it does

01

Join by invitation

The Fancy application issues the invitation: relay URL, session id, token, surface id and application. It is validated when constructed: the relay must be HTTPS and the token at least 16 characters.

02

Trust declared before discovery

Trust is local configuration. Nothing the surface says about its own tools (descriptions, annotations, read-only hints) widens it, and the default Laravel binding refuses every call before a request is sent.

03

Confirmation stays with the human

A tool whose name contains confirm, reject, accept, approve or deny as a whole word is reserved for the human and never offered to the agent.

04

Pinned tool definitions

A pin maps a tool name to the digest of its definition, so a surface cannot silently change what an approved tool does.

05

Concurrent edits, detected

When a person and the agent edit the same surface, Human+ pins writes to revisions the surface mints, and the surface decides whether a revision is stale. Human+ never merges.

06

Visible as an agent

Activity announcements carry the participant’s id, name and colour with type "agent", so people on the surface can always tell the agent apart from a human.

How it fits

Where it sits in the ecosystem

The Fancy application owns the running surface, stable handles, staged writes, undo, presence, cursors and the MCP tools that express its actions. Human+ is how a Prism agent enters it.

With Prism and Harness, a toolset turns an attachment’s trusted tools into tools a model can call, and the owner of an attachment can be a Harness session. Browser is the counterpart for the open web.

Install

Add it to your project

  1. 01

    particle-academy/prism-human-plus PHP

  2. 02

    @particle-academy/prism-human-plus TypeScript

  3. 03

    prism-ai-human-plus Python

The packages

On the registries

PHP · Packagist

particle-academy/prism-human-plus

TypeScript · npm

@particle-academy/prism-human-plus

Python · PyPI

prism-ai-human-plus