Integration Architecture
Put governance in the AI handoff.
FieldHash sits at the handoff: after retrieval, before generation or action, and before a reviewed decision can influence the next case.
A model can only reason over the context it receives. If teams cannot control which records enter that context, they cannot control which records shape the answer.
- You supply
- Candidate records or actions and the authority signals your systems and reviewers already maintain.
- FieldHash returns
- Allowed context, blocked alternatives, review routes, and an evidence packet.
- What proceeds
- Only allowed context or authorized actions. Uncertain cases stay out or return to review.
- What reviewers inspect
- The authority source, reason code, policy result, and packet reference.
Where the gate sits
Your store retrieves. FieldHash governs. Your model answers.
Your retrieval layer can search broadly. FieldHash narrows the handoff to what your policy allows, separating approved inputs from blocked alternatives before model output, tool execution, or a computer-use action. Canonical and semantic binding rules handle the cases where source wording differs.
If an incoming record cannot be tied to an active authority signal under the configured resolver, it stays out or goes to human review. Uncertainty does not become approval by default.
from fieldhash_govern import govern, verify_evidence_packet_seal
result = govern(candidates, query_text=query, seal_packet=True, require_ledger_package=True)
evidence_packet = result["evidence_packet"]
seal = result["ledger_seal"]
verification = verify_evidence_packet_seal(
evidence_packet,
seal,
expected_key_fingerprint=deployment_policy["ledger_key_fingerprint"],
expected_signature_algorithm=deployment_policy["signature_algorithm"],
)
if not verification["verified"]:
raise RuntimeError("FieldHash evidence verification failed")
if result["summary"]["caveated_count"]:
route_to_review(evidence_packet)
else:
release_to_model(result["clean_context"])The package split is deliberate: fieldhash-govern decides what may influence the answer or action, fieldhash-mcp applies that decision at the MCP protocol boundary, and fieldhash-ledger seals and preserves the resulting packet for verification. Pilot installs can run the gate alone, add the MCP sidecar where relevant, or attach a ledger seal for offline verification and signer-pinned review. Controlled inline deployments use the production handoff wrapper and a durable ledger store so a clean allow is returned only after the sealed event is recorded.
Review the FieldHash LedgerDeployment boundary: a local seal is tamper-evident against its embedded signing key. High-stakes operator resistance requires configured key custody, expected-signer pinning, optional PQC signing, and external anchoring where the SOW requires it.
Re-fetching fresher data keeps the inputs current, but it leaves the model free to select the wrong candidate. FieldHash enforces policy structurally by removing unauthorized candidates from the payload entirely before it reaches the model and, where packet sealing is configured, recording the exclusion in a tamper-evident evidence packet.
Runtime handoff
Interactive Handoff Telemetry
Choose a state below to see which candidates proceed, which stop, and what the ledger records at runtime.
// GOVERNED HANDOFF TRACE
from fieldhash_govern import govern result = govern( candidates, query_text=query ) approved_context = result["clean_context"] caveated_context = result["caveated_context"] # route to review evidence_packet = result["evidence_packet"]
{
"status": "ALLOW",
"surface": "governed_memory",
"allowed_context": ["current_authority_record"],
"blocked_records": [],
"reason_codes": ["active_authority_verified"],
"packet_hash": "fh_pkt_6021eb65"
}1. Candidates in
Approved/current records, stale or superseded records, rejected records, optional action candidates, and instrumented computer-use steps arrive from the systems you already use.
2. FieldHash decision
The governing record is allowed forward, stale or rejected alternatives are withheld or caveated, revoked actions are removed, and reviewed precedents apply only when their validity envelope still holds.
3. Model or action packet
Only allowed context and authorized actions proceed to the selected model or agent runtime. Browser clicks, shell commands, file edits, and form submissions are governed only when wrapped as action packets. Blocked alternatives stay available for review.
4. Evidence packet
Reviewers get the allowed items, blocked items, reason codes, authority source, and ledger or checkpoint reference for the decision.
MCP integration
Govern what MCP lets the agent discover, receive, and do.
The fieldhash-mcp gateway runs between an MCP host and upstream server. The preserved 2025 profile uses stdio. FieldHash supports the MCP 2026-07-28 core over modern-only stdio and stateless Streamable HTTP, beginning with server discovery rather than a session handshake.
The new protocol makes this boundary more important, not less. Stateless HTTP, standardized Apps and Tasks, and hardened OAuth make MCP easier to deploy; they still do not determine whether a particular tool, prompt, resource, or exact call is authorized for this workflow. Anthropic describes support as rolling out across Claude products.
The same boundary governs tool discovery and exact calls, resource and prompt influence, completion references, subscriptions, and multi-round input. The Tasks profile is bounded and opt-in; MCP Apps support covers descriptor, resource, and gateway-routed call governance rather than app-runtime containment. Arguments, client input, prompt and resource contents, and tool results are hashed for decision evidence, not copied into the Ledger.
A conformance harness places the official MCP SDK client and server packages on opposite sides of FieldHash over both supported modern transports. It verifies the MCP 2026-07-28 profile across discovery, governed tool listing and dispatch, instruction withholding, and authority-safe cache hints. This is protocol interoperability evidence, not customer validation, Anthropic certification, or proof that every Claude surface has enabled the revision.
Discovery and influence
FieldHash governs server instructions, tools, resources, templates, prompts, and completion references before they can shape the agent. Revoked or unresolved descriptors and returned content can stay out.
Exact transport-bound dispatch
Before tools/call reaches the server, FieldHash binds the server, tool, arguments, trusted principal, tenant, workflow, protocol context, and validated HTTP parameter headers into one action hash.
Interactive and deferred work
Multi-round input and opt-in Task handles receive restart-safe lineage. Subscription registrations are durably identity-bound; after a disconnect, the client must re-establish the listen request before notifications proceed.
Cache, review, and evidence
FieldHash clamps governed cache lifetimes, stops blocked or uncertain calls before dispatch, and records privacy-safe evidence. Inline mode denies unrecognized requests and notifications unless exactly allowlisted.
Use prepared policy for configured state, materialized shadow to record what connected Authority State would change without altering behavior, or materialized inline to make current authority decisive. The modern profile treats client-supplied multi-round input as interaction state, never as approval. Task lineage is durable when the bounded extension is enabled and negotiated; polled and subscribed completed Task results are rechecked against current tool authority at delivery before returning. Outstanding interaction keys are hash-bound and accepted once, while reused Task identities must match the original creation snapshot. FieldHash says routed to review only after it creates a review task; without a configured queue, the request or result is marked withheld. Subscription lineage persists for review, but the client must re-listen after a disconnect.
Boundary: MCP authentication, upstream OAuth, and server permissions remain upstream. FieldHash can govern UI-enabled descriptors, ui:// resources carrying the standard MCP App MIME type, and app calls routed through the gateway; the host still owns model-versus-app visibility, iframe isolation, CSP, permissions policy, and the app bridge. FieldHash is not a managed MCP host.
Computer-use reference
Govern the intended browser step before it runs.
The Playwright-compatible reference governs structured navigation, clicks, form input, key presses, selection, checkbox changes, and file upload. The host proposes the step; FieldHash checks authority, exact approval, runtime network containment, and the evidence boundary before dispatch.
FieldHash does not inspect pixels or infer permission from a screenshot. The browser or desktop runtime must expose the intended action as a structured packet. Where the Ledger is required, FieldHash records the pre-dispatch decision, whether dispatch returned, whether an external effect may be partial, and any containment violation observed afterward.
Structured intent
The host supplies the intended browser operation, target, arguments, principal, tenant, workflow, and session before the step runs.
Exact approval
FieldHash binds the full action into one hash. Approval tiers require a pinned approval signer and approver allowlist. A changed URL, locator, value, principal, or workflow invalidates prior approval.
Dispatch containment
The Playwright-compatible reference rechecks the page boundary, restricts routed requests and redirects to allowed origins, detects and closes popups, and cancels downloads during high-consequence dispatch.
Decision and execution receipts
The Ledger can record authorization before dispatch and a second receipt that separates dispatch completion, possible external effect, and containment outcome. Raw field values, selectors, page text, screenshots, and browser output stay out.
Current boundary: reference integration, not a managed browser service or universal desktop instrument. The default path creates an isolated browser context; reuse of an existing CDP context is an explicit, weaker profile. Customer authentication, browser custody, service-worker policy, session policy, and target allowlists remain deployment controls.
Candidate-input adapters and authority-source connectors
What connects today.
The Python package ships normalization adapters for retrieval results, documents, structured records, and tool catalogs.
Authority State adds a pilot reference path for connected authority: a read-only SQL projection for backfill and polling, and a signed webhook contract for approval, exception, revocation, ownership, and policy events. These connectors feed a minimized, versioned authority-state projection with source freshness, workflow bindings, and precedent dependencies.
They are reference connector contracts for customer-scoped pilots, not a managed SaaS connector catalog.
A bounded, self-administered diagnostic scanned and normalized 100,000 SQL rows through a forced restart and signature-verified and normalized 100,000 signed events through the declared rejection and ordering checks. A bounded subset exercised Authority State projection and complete replay. It is reference-path evidence, not customer validation or a production SLO.
Inspect connector reliabilityVector-search matches
Normalizes Pinecone-style or already normalized vector matches into the FieldHash candidate contract.
LangChain documents
Accepts Document objects or mappings with page content and metadata.
Structured records
Accepts row-like records with configurable text, status, identifier, and status-map fields.
Tool registries
Normalizes tool catalogs and removes revoked tools before the agent receives its available set.
Customer systems remain canonical. Pilot scope still defines credentials, source permissions, freshness deadlines, tenant boundaries, and the change signals available from each source.
Authority State
Keep connected authority current between handoffs.
Authority State is a minimized, versioned projection maintained by FieldHash. Customer systems remain the systems of record. The projection contains only the state needed at the AI boundary: source identities, status, scope, effective time, freshness, workflow bindings, and precedent dependencies.
When a connected policy, approval, revocation, expiry, owner, or required source-health signal changes, FieldHash recomputes the affected authority object, finds the workflows and precedents bound to it, suspends unsafe reuse, and records the review path.
Configured dependency bindings limit revalidation to recorded workflows and precedents directly bound to the changed authority object.
Prepared
Use caller-supplied authority metadata and the existing evidence-packet path.
Materialized shadow
Resolve connected Authority State beside the prepared path, record disposition and context divergence, and leave production behavior unchanged.
Materialized inline
Make current materialized authority decisive. Caller-supplied status cannot override revocation, conflict, staleness, or missing required authority.
Ownership boundary
Keep your stack. Govern at the boundary.
FieldHash does not replace your database, model, or tool registry. It operates on the handoff payload, checking configured status, scope, freshness, and precedent bounds before context release or execution, with signature verification where configured.
| Layer | Customer owns | FieldHash provides |
|---|---|---|
| Memory source | Vector DB, graph store, documents, tickets, knowledge base, or memory framework | Candidate intake after retrieval |
| Authority signals | Approvals, review status, supersession links, rollback events, systems of record | Authority enforcement before generation |
| Authority State | Canonical source systems, source semantics, credentials, and authority ownership | Minimized versioned projection, source freshness, workflow bindings, dependency impact, and review routing |
| Model route | Hosted, private, VPC, local, or on-prem model path | Approved context plus blocked-record evidence |
| Computer-use runtime | Browser, desktop, shell, file, or workflow automation environment | Policy decision, approval binding, bounded browser containment, and pre/post-dispatch evidence for structured action packets |
| MCP runtime | Host and server authentication, upstream OAuth, server permissions, UI-host isolation, and upstream process | Versioned stdio or stateless HTTP enforcement for discovery, influence, exact dispatch, lifecycle lineage, review routing, and evidence |
| Audit workflow | Reviewer process, SIEM, GRC, legal and security review | Evidence packet and Ledger references where configured |
| Reviewed precedent | Reviewer outcome, policy hierarchy, validity window, and dependency owners | Governed Precedent reuse, suspension, and reason-coded packet lineage |
Authority signals
Where authority signals usually live.
FieldHash works best with evidence the business already maintains: approval state, effective dates, revocations, supersession links, and review decisions. It enforces those signals before the model answers or the agent acts.
When reviewers settle a recurring conflict, that work can compound into governed precedent: which source won, why it applied, where it applies, and what change should suspend reuse. FieldHash records that precedent as governance state outside the model; it does not train the model on review history.
FieldHash calls those limits the validity envelope. If the connector, schema, owner, policy hierarchy, approval workflow, expiry window, or verification state changes, the precedent can be suspended and the next case sent back to review.
Inspect common authority and change signals+
Connector signals
Carries connection and source-health state from configured databases, catalogs, and directories into the validity check.
Authority signals
Carries reviewer approvals, system-of-record status, and explicit governance rules into the handoff.
Change signals
Carries schema, ownership, policy, and source-health changes that can suspend prior authority or route the next case to review.
CLM systems
Effective dates, executed-document state, amendments, and supersession links.
Policy systems
Approval state, version history, review owner, and current policy designation.
Document platforms
SharePoint, Drive, or knowledge-base version chains, permissions, and archive state.
Registries and tool catalogs
Revoked, yanked, deprecated, allowlisted, or environment-scoped tool states.
Security and GRC systems
Policy exceptions, risk approvals, control mappings, and audit ownership.
Human review
Authorized review can update Authority State. When the workflow's authority policy permits reuse, a reviewed judgment can become bounded precedent with its scope and validity conditions attached.
FieldHash does not invent authority. It enforces authority signals your workflow can expose and your reviewers can inspect.
Integration modes
Embed the gate or wrap it as a service.
The enforcement contract stays the same: candidates in, governed context or actions out, and a separate evidence packet for review.
Pre-answer policy gate
Call Governed Memory after retrieval and before generation. Call Governed Actions before tool, computer-use, or execution runs are authorized. Call Governed Precedent before a reviewed decision is reused. Each returns allowed inputs, blocked alternatives, governance reasons, and audit metadata.
Embedded gate, service, or MCP sidecar
Call the Python package inside your workflow, wrap it as an internal service, or place the versioned MCP gateway between a host and server over stdio or stateless HTTP. Browser and desktop actions remain governable when the runtime represents them as action packets.
Audit sink
Export Governed Memory events, Governed Actions events, computer-use action packets, Governed Precedent reuse events, checkpoints, blocked-record reports, and FieldHash Ledger evidence records for reviewer workflows.
Shadow-mode pilot
Start by observing candidate context and expected decisions without blocking production answers, then move selected flows into enforcement.
Model route
Use your chosen model. Keep governance portable.
FieldHash governs context before the model call and action candidates before execution. For computer-use agents, it governs the structured action packet around a click, command, file edit, or form submission; it does not read pixels as authority.
The model can be a hosted frontier API, private endpoint, VPC route, or local/open-weight route where configured. If a team changes providers, the governance record does not reset: approved context, blocked alternatives, action decisions, and evidence packets remain outside the model vendor. Any model-assisted extraction or selection step is recorded by FieldHash Ledger.
Portability is measured, not aspirational: in a published MemConflict extension run, gate decisions were identical across a frontier API and two 4-bit local models (the same 856 records blocked, the same conflicts routed to review), and the governed local arms scored within judge variance of a strong labeled prompt. See the model-invariance addendum.
Hosted pilot
Fastest path for technical review, sample workflows, and benchmark-style trace inspection.
Customer VPC
Deploy the governance layer near customer data, with approved model routing and customer-owned logs where configured.
Private or on-prem
Run against private infrastructure and local model endpoints when data boundaries require it.
Existing memory stores
Use current retrieval systems as candidate sources. Governed Memory controls influence and can govern memory cleanup decisions; it does not require a rip-and-replace memory migration.
Local overhead
The gate runs before generation.
FieldHash is designed to run after retrieval and before the model call. In an internal local diagnostic, the enforcement step remained millisecond-scale at 100 candidate memories.
Boundary: this measures deterministic local governance overhead only. It is not an end-to-end user latency benchmark and excludes retrieval, network, and model generation time.
Local diagnostic range
500 iterations each
Three repeat runs, one bounded path.
100 candidate memories
3.87-3.89 msp50
FieldHash enforcement across three 500-iteration local runs.
Ledger evidence add-on
+0.09-0.10 msp50
Hash-chained evidence serialization plus a local JSONL write over enforcement.
Measured boundary
0 network calls
No retrieval, no LLM generation, and no external provider calls were included.
Reviewer packet
An evidence packet your reviewers can inspect.
Approved context passed to the model
Authorized tool, execution, or computer-use action candidates allowed forward where configured
Pre-dispatch and post-execution computer-use receipts where a durable Ledger is required
Stale, rejected, superseded, or out-of-scope records blocked from influence
Canonical or semantic source binding where wording differs from the final answer
Governance reasons and scope metadata
Reviewer-approved authority precedents where the SOW permits reuse
Validity-envelope checks for connector, schema, owner, policy, approval workflow, expiry, and verification drift
Rollback and supersession links where available
Memory cleanup or consolidation decisions where configured
Audit events, checkpoints, and FieldHash Ledger evidence where configured
Exports for review, SIEM, GRC, or internal evidence workflows where configured
Claim boundary
What this does not claim.
Not a compliance guarantee.
Not a replacement for your retrieval database or document store.
FieldHash does not decide truth or authorization by itself: systems of record, registries, and review signals define real-world authority. FieldHash enforces configured authority evidence and records what reaches the model or agent.
Not changing your chosen model during normal use.
Not a claim that every private memory, transient output, or internal trace is public or permanently signed.
Not a model-superiority claim or a promise to outperform every one-shot selector.
Failure behavior is explicit, not implied.
No generative model in the gate
The enforcement decision is deterministic rule evaluation over configured record state: status, scope, supersession links, and rollback events. No generative LLM call is required to decide whether configured authority allows the handoff.
Shadow mode does not alter production answers
Pilots run observe-only: FieldHash records what it would have allowed and blocked without touching a single answer. Enforcement is a post-pilot decision, made with latency measured on your corpus rather than quoted from ours.
Failure policy is explicit
Infrastructure failure is distinct from authority failure. Custom or shadow integrations may define a separately recorded failure policy. The controlled production handoff fails closed: if governance, signing, durable append, or ledger verification cannot complete, it does not return a clean allow. Missing or unbindable authority remains caveated or routes to review under the configured policy.
Proposed authority changes are reviewed, signed, and reversible.
In the propose-then-approve path, governed state does not edit itself. Candidate supersession links, status changes, and corrections move through the same motion whether they are drafted by rules, a model pass, or a person: proposed, reviewed, signed, reversible.
Proposed, not assumed
Candidate changes enter a review queue as proposals. A proposal has no influence on answers until it is approved; nothing drafts itself into governed state.
Reviewed in scope
Every proposal declares which records and scopes it touches. Reviewers see the change, the evidence behind it, and which answers it would have altered.
Signed and recorded
Approval creates a signed decision record in the evidence packet. A rejected proposal is retained as evidence with its reason, not dropped without evidence.
Reversible by design
Every promotion carries a rollback path, and rollback is a state change, not a text edit. A reverted decision is no longer eligible for subsequent governed handoffs, and the reversal itself is recorded.
This is the same propose-then-approve motion the recovery diagnostic measures, where review decides the outcome. See the numbers in the corpus authority series.
Security and deployment
Authentication, private ingress, persistence, key custody, retention, regional hosting, monitoring, and incident response are deployment decisions. They are reviewed separately from the integration call.
Bring one agent workflow. We will show what influenced it.
The first useful pilot is narrow: one workflow, one known risk, a realistic candidate set, and an evidence packet your technical reviewers can inspect.
Request pilot reviewInspect the evidence