@cogstream/surfaces

Framework-neutral surface contracts for CogStream.

@cogstream/surfaces defines the context, control, metadata, policy, provenance, and outcome contracts for dynamic UI surfaces.

It does not render UI.

Instead, it provides the shared surface model used by renderer adapters such as:

• @cogstream/copilotkit
• @cogstream/vercel-ai
• @cogstream/a2ui
• @cogstream/flutter-genui
• custom host application renderers

Why this package exists

Generated UI still creates user journeys.

A generated card, checklist, form, confirmation panel, or agent workspace can help a user move forward — or it can become a new point of friction.

CogStream provides Situational UX Awareness for those dynamic surfaces:

• What journey is the user in?
• What task or step are they trying to complete?
• Is the user progressing, stalled, looping, or abandoning?
• What friction signals are present?
• What actions are safe?
• What actions are blocked?
• Does the surface require confirmation?
• Did the generated surface actually help?

@cogstream/surfaces is the neutral contract layer for answering those questions.

Core idea

Generative UI makes interfaces fluid.
CogStream makes the journey continuous.