Product licensing and entitlements

Set AGS_LICENSE_KEY, resolve tier entitlements, and unlock efficiency/impact/delivery features.

What you will learn

Load key at startup
Read entitlementsForTier
Match tools to free/personal/enterprise

Prerequisites

Install the AGS SDK

Surface

Imports	@tmrxjd/agent-governance-system/product-licensing
Config	AGS_LICENSE_KEY

What this feature does

Product licensing maps public tiers (free, personal, student, enterprise) — plus aliased entitlement ids in the SDK — to feature flags: agent_core, repo_core, token_efficiency_*, impact_*, delivery_governance, security_governance. Hosts call startup helpers with AGS_LICENSE_KEY. Online checkout is not required to study this surface; Free defaults apply without a key.

Configuration

Wire these surfaces first: AGS_LICENSE_KEY.. Treat them as the contract agents must not invent around.

Entitlement sketch typescript

import { entitlementsForTier } from '@tmrxjd/agent-governance-system/product-licensing'

const free = entitlementsForTier('free')
// free.features.agent_core === true
// free.features.delivery_governance === false

const personal = entitlementsForTier('personal')
// personal.features.token_efficiency_full === true
// personal.features.impact_full === true

How to call it

Use these package entrypoints from host or agent code: @tmrxjd/agent-governance-system/product-licensing.. Prefer the documented export path over deep relative imports.

Complete checkout on /pricing/ or /checkout/
Export AGS_LICENSE_KEY
Restart MCP host
governance_toc → confirm entitled tools

Env bash

export AGS_LICENSE_KEY=ags_live_...
# MCP host env passes the key through .mcp.json

What success looks like

Startup reports tier

efficiency_enforce / impact_* available per entitlements

Missing key → free defaults

Common failure modes

Expecting enterprise tools on free

Key in git

Host started without env passthrough