Integration Architecture

Put governance in the AI handoff.

Agents need authority before action.

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 Ledger

Deployment 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 viewer

// GOVERNED HANDOFF TRACE

Candidates
IDLE
FieldHash Gate
Allowed path
Evidence
// SYSTEM LOGONLINE
// Ready. Select status mode above.
Package call
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"]
Packet summary
{
  "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 reliability

Vector-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.

LayerCustomer ownsFieldHash provides
Memory sourceVector DB, graph store, documents, tickets, knowledge base, or memory frameworkCandidate intake after retrieval
Authority signalsApprovals, review status, supersession links, rollback events, systems of recordAuthority enforcement before generation
Authority StateCanonical source systems, source semantics, credentials, and authority ownershipMinimized versioned projection, source freshness, workflow bindings, dependency impact, and review routing
Model routeHosted, private, VPC, local, or on-prem model pathApproved context plus blocked-record evidence
Computer-use runtimeBrowser, desktop, shell, file, or workflow automation environmentPolicy decision, approval binding, bounded browser containment, and pre/post-dispatch evidence for structured action packets
MCP runtimeHost and server authentication, upstream OAuth, server permissions, UI-host isolation, and upstream processVersioned stdio or stateless HTTP enforcement for discovery, influence, exact dispatch, lifecycle lineage, review routing, and evidence
Audit workflowReviewer process, SIEM, GRC, legal and security reviewEvidence packet and Ledger references where configured
Reviewed precedentReviewer outcome, policy hierarchy, validity window, and dependency ownersGoverned 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.

Review deployment controls

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