AgentKit

Canonical model

One responsibility. One owner.

The object model keeps the system honest.

AgentKit only works if each commercial responsibility has exactly one canonical owner. This keeps identity, policy, objectives, search, ranking, decisions, execution, evidence, and learning distinct and composable.

CommercialIdentity

Immutable facts about the business.

Owner: company

CommercialPolicy

Approval, compliance, brand, and operating rules.

Owner: company

Objective

The commercial decision to be made.

Owner: founder

Search

Discovery of reachable opportunity space.

Owner: engine

RankedOpportunity

Transparent ordering of the options.

Owner: engine

Decision

The chosen commercial outcome.

Owner: engine

ExecutionPlan

Instructions for getting the work done.

Owner: engine

ExecutionSurface

Where the decision becomes visible.

Owner: platform

Connector

How the system reaches each surface.

Owner: platform
  • Canonical objects do not share responsibility.
  • Temporary artifacts can be produced by a stage, but permanent truth belongs to one object.
  • Execution surfaces consume decisions; they do not redefine them.
  • Connectors describe capabilities, metadata requirements, disclosure rules, and upload methods.
  • It keeps the architecture extendable without drift.
  • It makes future platforms pluggable.
  • It allows the engine to reason from shared truth instead of surface-specific assumptions.

One model, many surfaces, no ambiguity.

Use the canonical model to keep the product coherent as new decision types and execution surfaces are added.