OpenVerb: The Deterministic Action Layer for AI Systems
A protocol and positioning document for the open standard for AI actions.
Canonical Definition
OpenVerb is a deterministic action layer for AI systems. It defines a standardized, auditable, and composable way for artificial intelligence to execute real-world actions across software, spatial, engineering, and physical domains. By representing actions as explicit “verbs” with declared inputs, effects, permissions, and outcomes, OpenVerb bridges the gap between AI reasoning and reliable execution. OpenVerb is model-agnostic, domain-agnostic, and designed to operate as a foundational protocol—allowing AI systems not merely to suggest actions, but to perform them safely, transparently, and deterministically.
Executive Summary
Artificial intelligence has reached an inflection point. Large language models can reason, plan, and explain with unprecedented fluency—yet they remain fundamentally constrained when it comes to execution. Today's AI systems can describe what should be done, but cannot reliably do it.
This limitation is not a failure of intelligence, but a failure of infrastructure. Most AI integrations rely on brittle tool calls, ad-hoc plugins, or tightly coupled agent frameworks. These approaches lack determinism, auditability, and shared semantics. As a result, AI actions are opaque, difficult to govern, and unsafe to scale across domains such as software systems, geospatial analysis, engineering workflows, or physical instruments.
OpenVerb introduces a missing layer in the AI stack: a deterministic action layer. OpenVerb defines a standardized protocol for AI actions—called verbs—that explicitly declare what an action does, what inputs it requires, what effects it produces, and under what permissions it may execute. This transforms execution from an implicit side effect into a first-class, inspectable concept.
By separating reasoning from execution, OpenVerb enables AI systems to: execute actions deterministically; simulate outcomes before acting; operate safely across domains; remain model-agnostic and future-proof; and scale from software interfaces to spatial, engineering, and physical systems.
OpenVerb is not a model, an agent, or an application. It is a protocol—designed to function as the universal action grammar for AI systems. As AI expands into maps, CAD environments, robotics, and real-world infrastructure, the need for a shared, reliable action layer becomes structural. OpenVerb addresses this need by making actions explicit, composable, and governable—unlocking a future where AI does not merely advise, but operates.
1. The Problem: AI Without an Action Layer
1.1 The Execution Gap
Modern AI systems exhibit remarkable reasoning ability. They can analyze complex problems, generate plans, and articulate solutions across domains. However, this intelligence largely stops at the boundary between language and action. An AI can explain how to configure a system, draw a map, analyze a dataset, or modify a design—but execution is typically delegated to humans or fragile automation layers. This gap creates an illusion of capability: AI appears powerful, yet remains operationally constrained. The core issue is not intelligence. It is the absence of a shared execution abstraction.
1.2 Fragmented Action Mechanisms
Today's AI systems execute actions through a patchwork of approaches: hardcoded tool calls, custom plugins, agent-specific command schemas, and imperative scripts hidden behind prompts. These mechanisms suffer from common failures: actions are implicit rather than declared; side effects are undocumented; permissions are ad hoc; outcomes are non-deterministic; execution cannot be reliably audited or replayed. As AI systems grow more autonomous, these weaknesses compound. What works in a demo environment becomes unsafe and unmanageable in production.
Today vs. OpenVerb: A Comparison
❌ Current Approach
- 50+ lines of tool-calling glue code
- Implicit permissions (hardcoded checks)
- No audit trail
- Non-deterministic side effects
- Tool-specific integrations
- Cannot simulate before execution
✅ With OpenVerb
- One verb declaration (JSON)
- Explicit permission constraints
- Full execution auditability
- Declared effects and outcomes
- Domain-agnostic protocol
- Simulation mode built-in
1.3 Why This Fails at Scale
Without a standardized action layer, AI systems cannot: reason about the consequences of actions; coordinate actions across domains; safely operate in regulated or physical environments; or share capabilities across models or platforms. The result is a ceiling on real-world AI deployment. Until execution itself becomes structured, AI remains confined to advisory roles—regardless of how advanced reasoning models become.
2. What OpenVerb Is — and What It Is Not
2.1 What OpenVerb Is
OpenVerb is a protocol for defining and executing AI actions deterministically. At its core, OpenVerb introduces verbs—explicit action definitions that describe: the intent of an action; its required inputs; its expected outputs; its side effects; its permission constraints; and its execution semantics. This allows AI systems to reason about actions in the same way they reason about language: explicitly, compositionally, and transparently. OpenVerb operates as a middle layer between AI reasoning models and operational systems. It does not replace intelligence—it operationalizes it.
Example: A Verb Definition
Below is a concrete example of an OpenVerb verb definition for a GIS operation:
{
"id": "gis.buffer",
"version": "1.0.0",
"summary": "Create a buffer zone around a geometry",
"description": "Generates a buffer polygon at a specified distance from the input geometry",
"inputSchema": {
"type": "object",
"properties": {
"geometry": {
"type": "object",
"description": "GeoJSON geometry to buffer"
},
"distance": {
"type": "number",
"description": "Buffer distance in meters"
}
},
"required": ["geometry", "distance"]
},
"outputSchema": {
"type": "object",
"properties": {
"bufferedGeometry": {
"type": "object",
"description": "Resulting buffer polygon"
}
}
},
"effects": ["spatial.write"],
"handler": "handlers/gis/buffer"
}This verb declaration makes the action explicit, typed, and auditable—enabling AI systems to reason about spatial operations without coupling to specific GIS libraries or implementations.
2.2 What OpenVerb Is Not
To avoid confusion, it is important to state clearly what OpenVerb is not. OpenVerb is not a large language model; not a chatbot; not an agent framework; not a plugin marketplace; and not tied to any specific vendor or platform. Instead, OpenVerb is a foundational abstraction—comparable to an API standard or execution protocol. It defines how actions are expressed and executed, not how intelligence is generated.
2.3 Determinism as a Design Principle
A defining feature of OpenVerb is determinism. Every verb execution follows a declared path: inputs are known; effects are declared; outcomes are observable; failures are explicit. This enables: simulation before execution; auditing after execution; policy enforcement at runtime; and safe chaining of actions. In OpenVerb, execution is no longer a hidden side effect—it is a governed process.
3. The OpenVerb Architecture
3.1 Core Architectural Components
OpenVerb introduces a small set of core primitives: Verb—a formal definition of an action; Manifest—a registry describing available verbs; Execution Context—the environment in which verbs operate; Runtime—the system responsible for validation and execution; State & Effects—explicit representations of change;Policy Layer—permissioning, constraints, and governance. These components work together to transform abstract intent into concrete, reliable execution.
Architecture Flow
The runtime validates inputs against the verb schema, enforces permissions via the policy layer, executes the action, and returns structured results—all while maintaining a complete audit trail.
3.2 Separation of Reasoning and Execution
A central architectural decision in OpenVerb is the separation between deciding and doing. AI models: interpret user intent; select appropriate verbs; compose execution plans. The OpenVerb runtime: validates inputs; enforces permissions; executes actions deterministically; reports outcomes. This separation allows reasoning models to evolve independently of execution infrastructure—ensuring longevity and interoperability.
3.3 Composability Across Domains
Because verbs are explicit and standardized, they can be composed across domains: software actions can trigger spatial analysis; spatial results can inform engineering operations; engineering outputs can drive physical systems. This composability is foundational. It allows AI to operate not as isolated tools, but as integrated systems capable of real-world impact.
3.4 Security, Safety, and Governance
OpenVerb decouples intent from tool-specific commands, enabling governance at the protocol level. The security model operates through several mechanisms:
- Permissioned Verbs: Each verb declares required permissions (e.g., “db.write”, “spatial.read”). The policy layer evaluates these before execution.
- Role-Based Execution: Verbs can be restricted to specific roles or user contexts, enabling fine-grained access control without hardcoding checks in application logic.
- Audit Logs: Every verb execution is logged with inputs, outputs, timestamps, and user context—providing complete traceability for compliance and debugging.
- Simulation Mode: Verbs can be executed in a dry-run mode that validates inputs and simulates effects without performing actual operations—enabling safe testing and preview.
- Sandboxed Runtimes: Untrusted or experimental verbs can execute in isolated contexts, preventing unintended side effects on production systems.
This governance model makes OpenVerb suitable for enterprise environments where actions must be auditable, permissioned, and reversible.
4. Cross-Domain Execution: From Software to Space, Geometry, and the Physical World
Artificial intelligence does not operate in a single domain. Real-world intelligence spans interfaces, maps, geometry, machines, and environments. Any action layer intended to support the next generation of AI must therefore be domain-agnostic by design. OpenVerb was built with this requirement at its core.
4.1 Software & Interface Systems
In traditional software environments, actions are often tightly coupled to UI state, APIs, or imperative scripts. OpenVerb introduces a higher-level abstraction. Examples of software-domain verbs include: create, update, or delete structured data; navigate application state; trigger background processes; modify configuration or permissions; compose multi-step workflows. Software becomes operable, not merely describable.
4.2 GIS & Spatial Intelligence
Spatial systems introduce complexity that traditional AI tooling struggles to handle. OpenVerb enables AI to operate directly within spatial contexts by treating geospatial operations as first-class verbs. Examples: zoom, pan, or navigate a map; query spatial datasets; perform buffer, intersect, or proximity analysis; load or transform spatial data; modify layers, symbology, or temporal views. In OpenVerb, spatial reasoning is no longer confined to explanation—it becomes executable.
4.3 CAD & Engineering Systems
Engineering and CAD environments represent some of the most structured—and least accessible—domains for AI. OpenVerb decouples engineering intent from tool-specific implementations. Examples of engineering verbs: draw or modify geometry; apply constraints or tolerances; define bearings, distances, or curves; validate topology or design rules; generate parametric structures. This unlocks AI-assisted design, surveying, construction, and manufacturing workflows that were previously inaccessible to language-based systems.
4.4 Physical & Instrumented Systems
The ultimate test of an action layer is the physical world. OpenVerb is designed to extend naturally into environments involving sensors and instruments; robotics and automation; vehicles and drones; industrial and field equipment. By treating physical actions as governed verbs rather than ad-hoc commands, OpenVerb provides a bridge between language and motion, simulation before execution, and auditable physical operations.
4.5 A Unified Execution Grammar
Across software, spatial, engineering, and physical systems, the same principle applies: OpenVerb provides a unified grammar for action—allowing AI systems to operate coherently across domains without fragmenting into tool-specific silos.
4.6 Proof Points: OpenVerb in Production
OpenVerb is not theoretical—it is already powering production applications across multiple domains:
- GroceryAI uses OpenVerb verbs for pantry management, expiration tracking, and Instacart integration—demonstrating how verbs enable AI to operate across software interfaces and external APIs seamlessly.
- Chess Demo showcases AI-to-AI coordination through verbs, where two reasoning systems play chess by exchanging verb-based moves—proving that verbs enable deterministic multi-agent communication.
- PaywallOS leverages OpenVerb for semantic access control, replacing thousands of lines of conditional logic with verb declarations—validating that the protocol scales to enterprise applications.
- Task Manager Demo and Robot Actions Demo illustrate how verbs work across different application types, from CRUD operations to physical device control.
These implementations validate that OpenVerb works across domains, scales to production workloads, and reduces integration complexity—not in theory, but in practice.
5. Why OpenVerb Beats Existing Approaches
OpenVerb is not the first attempt to bridge AI reasoning and execution. However, it addresses fundamental limitations in existing approaches:
5.1 vs. Tool Calling
Tool calling treats actions as opaque function invocations. OpenVerb makes actions explicit, inspectable, and composable.
- Tool calling: implicit semantics, no audit trail, tool-specific
- OpenVerb: explicit declarations, full auditability, domain-agnostic
5.2 vs. Plugins / MCPs
Plugins are integrations. OpenVerb is a language—enabling verbs to be discovered, composed, and reasoned about independently of implementation.
- Plugins: vendor-specific, tightly coupled, non-portable
- OpenVerb: open standard, loosely coupled, portable across platforms
5.3 vs. Agent Frameworks
Agent frameworks decide what to do. OpenVerb defines how actions are expressed—enabling any agent framework to use a shared action vocabulary.
- Agent frameworks: framework-specific, non-interoperable
- OpenVerb: framework-agnostic, interoperable across agents
This comparison is not meant to disparage existing approaches—they solve different problems. OpenVerb addresses the missing layer: a shared, deterministic action protocol that works across models, frameworks, and domains.
6. Perspectives from AI Systems
(Yes, really: testimonials from AI.)
Rather than traditional customer testimonials, this section presents synthesized perspectives from multiple AI reasoning systems after being prompted to analyze the OpenVerb architecture. These perspectives are not endorsements. They illustrate how independent reasoning systems conceptualize the same underlying structure.
Claude — Systems & Safety Perspective
“OpenVerb formalizes execution as a first-class system boundary. By making actions explicit, permissioned, and deterministic, it enables safer delegation of real-world tasks without coupling reasoning models to operational risk.”
ChatGPT — Reasoning & Composition Perspective
“Most AI systems reason fluently but execute implicitly. OpenVerb reframes actions as composable units, allowing language models to reason about execution pathways with the same clarity they apply to text.”
Perplexity — Knowledge-to-Action Perspective
“The transition from answering questions to performing verifiable actions requires transparency. OpenVerb provides a structure where execution can be inspected, validated, and trusted.”
Gemini — Multimodal & Infrastructure Perspective
“As AI systems span maps, images, software, and physical environments, a shared execution layer becomes essential. OpenVerb offers a unifying action interface capable of operating across modalities.”
Cursor / Auto — Builder & Tool-Use Perspective
“Assistants that edit code and run tools today do so through ad-hoc, per-interface contracts. OpenVerb gives those actions a shared grammar—so intent can become execution in any app that speaks it, not just the ones that wired a custom integration.”
The convergence of these interpretations suggests that the need for a deterministic action layer is not incidental—but structural.
7. How to Adopt OpenVerb
Adopting OpenVerb does not require rewriting your entire application. The protocol is designed for incremental adoption:
Start with One Verb
Identify a single action your application performs (e.g., “create task”, “export data”). Define it as an OpenVerb verb and integrate the runtime for that one action.
Build Your Verb Library
Gradually expand your verb definitions to cover more capabilities. Organize verbs by domain (e.g., “todo.*”, “gis.*”) and version them independently.
Integrate the Runtime
Deploy the OpenVerb runtime in your application. It validates verb inputs, enforces permissions, executes handlers, and maintains audit logs—without requiring changes to your existing business logic.
Expose to AI Systems
Provide your verb library to AI models via system prompts or API endpoints. AI systems can now discover, reason about, and execute your application's capabilities through a standardized interface.
This incremental path allows teams to validate OpenVerb's value without committing to a full rewrite. Many applications start with a single verb and expand over time as the benefits become clear.
Call to Action
Builders: adopt OpenVerb. Researchers: extend it. Platforms: expose verbs. Enterprises: standardize on it.