@happyvertical/smrt-sales 0.57.1 → 0.57.3

package/README.md

@@ -20,7 +20,7 @@ Add `svelte` when consuming the optional UI export.
 
 | Entry point | Responsibility |
 | --- | --- |
-| `@happyvertical/smrt-sales/agreements` | Verified e-signature execution and immutable evidence |
+| `@happyvertical/smrt-sales/agreements` | Versioned commercial terms, verified e-signature execution, and immutable evidence |
 | `@happyvertical/smrt-sales/crm` | Leads, pipelines, opportunities, activities, conversions |
 | `@happyvertical/smrt-sales/referrals` | Referrers, links, attribution, qualification, agreements |
 | `@happyvertical/smrt-sales/commissions` | Earners, plans, earning events, commissions, payouts |
@@ -72,6 +72,32 @@ console.log(earner.id, plan.getComponents());
 All money fields use integer cents. Rates and probability-like values use
 decimals from `0` to `1`; rounding occurs through the exported money helpers.
 
+## Waterfall plans
+
+Version-two plans can carry ordered `steps`, an `effectiveTo` boundary, and a
+`remainderSink`. `calculateWaterfall()` is a pure, generic allocation service:
+hosts register recipient resolvers, then persist the returned trace as the
+replay evidence. Step keys must be nonempty strings; malformed persisted keys
+are rejected before allocation or activation. Replay snapshots copy recipient
+and sink values, including nested metadata, so later caller-input mutation
+cannot change the returned evidence. The trace freezes the resolved recipients, input facts, and
+application-fee offset. All amounts are integer minor units; each percentage
+rounds half away from zero and recipients plus the sink always equal gross.
+
+An application fee already settled at checkout is modeled only as an offset to
+the configured recipient's payable allocation. It is never emitted as a second
+allocation or payable. Offset matching uses the entire recipient descriptor,
+including nested metadata; object key order does not change identity. The service
+does not initiate a payout or transfer.
+
+The referral qualification and commission bridge remain component-based. Both
+qualification and explicit requalification refuse a resolved waterfall plan with
+`unsupported_plan_engine`, before writing a snapshot or changing the referral.
+This applies to pinned plans and latest-active plan amendments. Existing frozen
+v1 snapshots keep governing earnings. To recover, activate and bind compatible
+component terms, then retry qualification; use `calculateWaterfall()` directly
+for v2 allocations. Switching a plan key's engine does not migrate referrals.
+
 ## Core model
 
 - **Roles are separate from money.** `SalesRepresentative` and `Referrer` are
@@ -132,7 +158,26 @@ See [the CRM contract](agents/crm.md) for retry and duplicate semantics and
 
 ## Agreement boundary
 
-The agreements module accepts the provider-neutral
+`Agreement` is a counterparty-agnostic, effective-dated terms record. Parties
+are ordered `{ kind, id }` descriptors, so consumers can use tenant, earner,
+profile, organization, worker, or their own neutral kinds without importing a
+consumer domain. Versions are rows: `createAmendment()` creates a draft and
+`activateAmendment()` closes the predecessor at the successor's start. Effective
+intervals are half-open (`[effectiveFrom, effectiveTo)`), and `activeFor()` is
+an as-of query: it can return a superseded or terminated version that governed
+the supplied record date, never terms inferred from today's status. Ambiguous
+overlapping intervals fail closed. Activation rejects backdated or out-of-order
+amendments that would overlap existing history. Ending a draft cancels it without
+making it govern; closed intervals cannot be reopened. Party JSON is canonicalized
+before persistence, so property order does not change an agreement's identity.
+Tenant lookups fall back to global terms for each requested date when no tenant
+version governs that date. A tenant must explicitly create its initial version
+before using amendment helpers; global terms are never implicitly copied into a
+tenant amendment. Callers that calculate money must snapshot
+the returned version at their authoritative event; this model does not settle
+or allocate funds.
+
+The execution portion of the agreements module accepts the provider-neutral
 `@happyvertical/signatures` contract plus an `AssetRuntimeLike`. Provider
 credentials remain in the injected SDK adapter and secret store. Executed
 agreements freeze the exact source, signed document, audit trail, hashes, and
@@ -163,3 +208,26 @@ pnpm --filter @happyvertical/smrt-sales build
 
 See [`AGENTS.md`](./AGENTS.md) for lifecycle, evidence, concurrency, and payout
 invariants.
+
+A future amendment activated through `activateAmendment` can be withdrawn through
+`withdrawAmendment(id)` only before its start, while it is still active. This
+transaction cancels the never-effective successor and restores its exact persisted
+predecessor end (including a finite end); it never infers an open-ended interval.
+Repeated, late, or conflicting withdrawals fail without changing history. Direct
+model termination remains for already-effective terms. Global defaults apply only
+before a tenant lane first governs; termination, expiry, and later gaps in that
+lane return no agreement instead of silently resuming global fees.
+
+Restoration provenance is written exclusively by amendment activation; ordinary
+creates and saves cannot supply or edit it. Withdrawal advances both persisted
+revision tokens so pre-withdrawal model instances cannot overwrite the result.
+
+Initial agreement creates use strict insertion: concurrent callers for the same
+tenant, kind, parties and version cannot replace the winning row or its terms.
+The losing create fails; load the existing version or create an amendment.
+
+Concurrent `createAmendment` calls serialize version allocation within the owning
+lane: PostgreSQL locks the oldest persisted version and re-reads the latest;
+embedded engines use core's transaction/write queue. Each successful call keeps
+its own terms and version. Direct `supersede()` requires a finite `effectiveTo`
+set before the transition; saving an open-ended superseded row is rejected.

package/agents/commissions.md

@@ -10,7 +10,7 @@ money), and the Gotchas that apply before editing anything live in
 - **CommissionPlan**: versioned calculation terms. Natural key `(tenant_id, plan_key, version)` (per-tenant keys; the adapters' null-aware upsert dedups NULL-tenant keys through the model layer, though duplicate global rows minted via raw SQL remain representable); `status` (`draft|active|superseded|retired`); `effectiveFrom`. Components are a JSON-string array (`getComponents()`): each component has `key`, `trigger` (earning-event kind or `*`), `basis` (`fixed|gross|net|margin|custom`), `rate` or `fixedAmountCents`, `recurrence` (`one_time` or `recurring` with optional `maxOccurrences`/`windowMonths`). **Immutable once active** — amendments create a new row with `version + 1`; prior versions are never rewritten. `latestActiveByKey(key, at?)` resolves the highest active version **already in effect at `at`** — a future-dated amendment can be activated ahead of time without governing earlier qualifications (same rule on `AttributionPolicyCollection`).
 - **EarningEvent**: immutable commercial-event evidence (`conversion`, `agreement_execution`, `invoice_payment`, `collected_revenue`, `recognized_margin`, or any extensible kind). Carries `sourceKind`/`sourceId` (generic earning source), `grossAmountCents`/`netAmountCents`/`marginCents`, `currency`, `occurredAt`, and a `dedupeKey` natural key for idempotent ingestion. No update/delete surface, plus a save-time immutability guard: hydrated edits, blind id overwrites, and fresh creates onto an existing dedupe key all throw (the upsert would rotate the row id and orphan referencing Commissions) — idempotent ingestion goes through `getOrCreateByDedupeKey()`.
 - **Commission**: one earning record per earner per plan component per event occurrence. Integer-cents amounts (`baseAmountCents`, `amountCents`), decimal `rate`, `basis`, snapshot references (`planKey`/`planVersion`, generic `termsSnapshotKind`/`termsSnapshotId`), a JSON `calculationTrace` sufficient to reproduce the amount, split support (`splitGroupId`, `shareFraction`), and a `dedupeKey` for idempotent creation. Lifecycle `pending → earned → approved → payable → paid`, enforced by a save-time transition guard with an authoritative prior-status re-read (commerce pattern).
-- **CommissionAdjustment**: append-only corrections (`refund|credit|chargeback|dispute|correction`), signed `amountCents`, required `reason`, immutable once created. `CommissionAdjustmentService.createAdjustment()` is the tenant-required idempotent creation door: callers provide a stable operation UUID; the database creates exactly one row, exact retries return it, and changed tenant/commission/earner/kind/cents/currency/reason/operator/metadata fail with a typed replay conflict. Parent Commission plus denormalized tenant/Earner/currency and operator UUID are validated before insert. The financial row deliberately exposes no operation field. A private, required-tenant `CommissionAdjustmentOperation` table uses the globally unique operation UUID as its primary id, maps it to the adjustment UUID, and is inserted in the same transaction as the adjustment. Existing adjustment schemas and legacy direct creates remain unchanged. Earned/paid Commissions are never rewritten — adjustments append to them.
+- **CommissionAdjustment**: append-only corrections (`refund|credit|chargeback|dispute|correction`), signed `amountCents`, required `reason`, immutable once created. `CommissionAdjustmentService.createAdjustment()` is the tenant-required idempotent creation door: callers provide a stable operation UUID; the database creates exactly one row, exact retries return it, and changed tenant/commission/earner/kind/cents/currency/reason/operator/metadata fail with a typed replay conflict. Parent Commission plus denormalized tenant/Earner/currency and operator UUID are validated before insert. The financial row deliberately exposes no operation field. A private, required-tenant `CommissionAdjustmentOperation` table uses the globally unique operation UUID as its primary id, maps it to the adjustment UUID, and is inserted in the same transaction as the adjustment. Claims tolerate either primary-key or tenant/slug/context uniqueness arbitration without aborting the transaction; only the tenant-scoped operation UUID lookup and immutable intent comparison authorize a replay. Existing adjustment schemas and legacy direct creates remain unchanged. Earned/paid Commissions are never rewritten — adjustments append to them.
 - **Payable balance**: computed, not stored — `CommissionBalanceService` sums payable Commissions plus unsettled Adjustments per Earner/currency.
 - **CommissionPayout**: settlement batch per Earner. `pending → approved → processing → completed | failed` (`resetFromFailed()` is the only exit from failed), plus the terminal operator decline `rejected` reachable from pending/approved (#1987 — reject through `transitionPayoutForSource`, which also RELEASES the batch's membership so the rows settle through a future batch; `reject()` on the model mutates status only). Settles rows via the collections' **conditional `claimForPayout`** (model-layer get/save/re-read — tenancy- and dialect-safe; a row owned by another batch is never re-claimed) and stores totals recomputed from the VERIFIED claimed membership; idempotent via `idempotencyKey` natural key (default `${earnerId}:${currency}:${YYYY-MM-DD}`) — a clean replay touches nothing, while a pending payout whose totals disagree with its stamped rows (interrupted claim pass) is repaired on replay (the claim pass re-checks the payout is still pending first). Each batch/repair pass also derives the payout's **single-source stamp** (`sourceKind`/`sourceId`, indexed): set when every claimed commission — and every claimed adjustment through its parent commission — shares exactly one non-empty source; empty for mixed/unknown/empty membership. `completePayout` flips member commissions to `paid` BEFORE the terminal transition, so a mid-loop failure stays retryable. Enforces `totalAmountCents = commissionTotalCents + adjustmentTotalCents` at save; retains `paymentReference`/`providerRef`; optional `invoiceId` cross-package string ref to a commerce Invoice. Generated surface is read-only on ALL doors (api/mcp/cli `list`/`get`) — writes go through `CommissionPayoutService`. `createPayoutBatch` settles the whole earner+currency by default, or a **scoped** subset: pass `sourceKind`+`sourceId` to settle just one earning source (e.g. one ad network), or `commissionIds` for an explicit set (each validated payable+unsettled+earner+currency; requires its own `idempotencyKey`) — adjustments are narrowed to the same scope, and the default idempotency key folds the source in. Scoping is how concurrent per-source batches settle safely: batches scoped to different sources (or disjoint `commissionIds`) gather **disjoint** row sets and never contend. The collection layer has no cross-row transaction, so OVERLAPPING concurrent scopes (a source batch + the earner-wide batch, intersecting id sets, or a batch replay racing a lifecycle transition of the same payout) must be serialized by the caller — `claimForPayout` still won't double-own a row, but a shared commission and its adjustment could split across the two batches.
 - **Source-scoped payout history** (#1985): `CommissionPayoutService.getSourcePayoutHistory({ sourceKind, sourceId, limit?, offset? })` — one page of the payouts belonging to ONE earning source, newest first (`created_at DESC, id DESC`), offset contract (`nextOffset` advances by the scanned count; `null` when exhausted). Candidates come from the indexed stamp, so work is bounded by page size (a sparse source never scans the global history); each page is re-verified against actual membership in three batched queries (no per-payout N+1) — every member commission and every adjustment's parent must carry exactly the requested source and agree on earner/currency/tenant; unprovable rows (mixed-source, missing parents, memberless artifacts, released/rejected batches) are excluded fail-closed and reported in `excluded` with reasons. Adjustment-only payouts prove ownership through parent commissions and list normally. Payouts minted before the stamp existed are invisible until backfilled with `restampPayoutSource(payoutId)` (idempotent, any status).

package/agents/referrals.md

@@ -13,5 +13,6 @@ money), and the Gotchas that apply before editing anything live in
 - **Referral**: the introduction — generic qualifying target (`targetKind`/`targetId`: lead, opportunity, client, project, subscription, …), resolved policy version, credit fraction (splits create sibling Referrals sharing `splitGroupId`), lifecycle `pending → attributed → qualified | disqualified | expired | under_review`.
 - **AttributionException**: conflict review queue. Conclusive policy resolves automatically; ambiguity creates an exception; overrides require a `resolutionReason` and are audited.
 - **ReferralAgreement**: versioned per-Referrer terms binding — pins `commissionPlanKey`/`planVersion`, effective dating, and an immutable `ExecutedAgreement` before activation. Amendments are fresh unsigned drafts and never inherit execution evidence.
+- **Plan compatibility**: qualification and requalification accept only v1 component plans. A pinned or latest-active v2 waterfall plan returns `unsupported_plan_engine` before snapshot/referral writes; existing snapshots remain valid and unchanged. Bind compatible component terms and retry to recover. Engine changes under a plan key never implicitly migrate referrals.
 - **ReferralTermSnapshot**: immutable at qualification — freezes agreement/plan/policy version refs plus the calculation inputs needed to reproduce every later earning.
 - **Services**: `ReferralAgreementExecutionService` binds generated Referral Agreement versions to the generic execution service and activates/supersedes them transactionally with future-effective amendment support; `AttributionService`, `ReferralQualificationService`, and `ReferralCommissionService` retain their existing attribution/qualification/earning responsibilities.

package/dist/agreements/collections/AgreementCollection.d.ts

@@ -0,0 +1,50 @@
+/** Collection helpers for generic versioned agreements. */
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { Agreement } from '../models/Agreement.js';
+import type { AgreementParty } from '../types.js';
+export interface AgreementAmendmentChanges {
+    terms?: Record<string, unknown>;
+    effectiveFrom?: Date | null;
+    effectiveTo?: Date | null;
+    executedAgreementId?: string | null;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Versioned rows for one ordered `(kind, partyA, partyB)` relationship.
+ * Party order is intentional: a host-to-tenant agreement is distinct from a
+ * tenant-to-host agreement unless the consumer models them as the same kind.
+ */
+export declare class AgreementCollection extends SmrtCollection<Agreement> {
+    static readonly _itemClass: typeof Agreement;
+    findVersions(kind: string, partyA: AgreementParty, partyB: AgreementParty): Promise<Agreement[]>;
+    /**
+     * Resolves the sole version governing `at`. This is a historical query:
+     * a superseded or terminated row can still govern before its exclusive
+     * `effectiveTo`; today's lifecycle status alone is never used to answer a
+     * record-date lookup. Drafts never govern.
+     *
+     * Generated amendments are non-overlapping because the predecessor ends at
+     * the successor's inclusive start. If imported or manually-created rows do
+     * overlap, this helper throws instead of silently selecting a version.
+     */
+    activeFor(kind: string, partyA: AgreementParty, partyB: AgreementParty, at?: Date, tenantId?: string | null): Promise<Agreement | null>;
+    /** Creates the next unsigned/draft version without changing prior history. */
+    createAmendment(kind: string, partyA: AgreementParty, partyB: AgreementParty, changes?: AgreementAmendmentChanges): Promise<Agreement>;
+    /**
+     * Activates an amendment and closes any currently governing predecessor at
+     * the new version's start. The interval is `[from, to)`, so equal boundary
+     * timestamps do not overlap. A future-dated amendment may be activated in
+     * advance; record-date lookup still selects its predecessor until `from`.
+     */
+    activateAmendment(id: string): Promise<Agreement>;
+    /** Withdraw a scheduled successor before it has ever governed.
+     * Restores only its persisted predecessor boundary, in the same transaction.
+     * Repeated/concurrent withdrawal refuses rather than applying recovery twice.
+     */
+    withdrawAmendment(id: string): Promise<Agreement>;
+    private findGoverningCandidates;
+    private ambientTenantId;
+    private runTransaction;
+}
+export default AgreementCollection;
+//# sourceMappingURL=AgreementCollection.d.ts.map

package/dist/agreements/collections/AgreementCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgreementCollection.d.ts","sourceRoot":"","sources":["../../../src/agreements/collections/AgreementCollection.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAE3D,OAAO,EAKL,cAAc,EAEf,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EAAE,SAAS,EAA2B,MAAM,wBAAwB,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,aAAa,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAMD;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,cAAc,CAAC,SAAS,CAAC;IAChE,MAAM,CAAC,QAAQ,CAAC,UAAU,mBAAa;IAEjC,YAAY,CAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,SAAS,EAAE,CAAC;IASvB;;;;;;;;;OASG;IACG,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,EACtB,EAAE,GAAE,IAAiB,EACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IA2C5B,8EAA8E;IACxE,eAAe,CACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,SAAS,CAAC;IA2DrB;;;;;OAKG;IACG,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IA6FvD;;;OAGG;IACG,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;YAmGzC,uBAAuB;IAqCrC,OAAO,CAAC,eAAe;YAIT,cAAc;CAc7B;AAED,eAAe,mBAAmB,CAAC"}

package/dist/agreements/index.d.ts

@@ -7,9 +7,11 @@
  *
  * @packageDocumentation
  */
+export { type AgreementAmendmentChanges, AgreementCollection, } from './collections/AgreementCollection.js';
 export { AgreementExecutionCollection } from './collections/AgreementExecutionCollection.js';
 export { AgreementExecutionEventCollection } from './collections/AgreementExecutionEventCollection.js';
 export { ExecutedAgreementCollection } from './collections/ExecutedAgreementCollection.js';
+export { Agreement, parseAgreementParty, serializeAgreementParty, } from './models/Agreement.js';
 export { AgreementExecution } from './models/AgreementExecution.js';
 export { AgreementExecutionEvent } from './models/AgreementExecutionEvent.js';
 export { ExecutedAgreement } from './models/ExecutedAgreement.js';

package/dist/agreements/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agreements/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,+CAA+C,CAAC;AAC7F,OAAO,EAAE,iCAAiC,EAAE,MAAM,oDAAoD,CAAC;AACvG,OAAO,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAC3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EACL,KAAK,kCAAkC,EACvC,KAAK,gCAAgC,EACrC,yBAAyB,EACzB,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,GACnC,MAAM,yCAAyC,CAAC;AACjD,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agreements/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,KAAK,yBAAyB,EAC9B,mBAAmB,GACpB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,4BAA4B,EAAE,MAAM,+CAA+C,CAAC;AAC7F,OAAO,EAAE,iCAAiC,EAAE,MAAM,oDAAoD,CAAC;AACvG,OAAO,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAC3F,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EACL,KAAK,kCAAkC,EACvC,KAAK,gCAAgC,EACrC,yBAAyB,EACzB,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,GACnC,MAAM,yCAAyC,CAAC;AACjD,cAAc,YAAY,CAAC"}

package/dist/agreements/models/Agreement.d.ts

@@ -0,0 +1,67 @@
+/** Generic versioned, effective-dated commercial terms. */
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { type AgreementOptions, type AgreementParty, type AgreementStatus } from '../types.js';
+/** Validates and canonically serializes a public counterparty descriptor. */
+export declare function serializeAgreementParty(party: AgreementParty): string;
+/** Parses an agreement party, rejecting corrupt persisted values when active. */
+export declare function parseAgreementParty(value: string): AgreementParty | null;
+export declare class Agreement extends SmrtObject {
+    tenantId: string | null;
+    /** Open application-defined agreement kind, e.g. `revenue_share`. */
+    kind: string;
+    /** Canonical JSON {@link AgreementParty}; order is semantically meaningful. */
+    partyA: string;
+    /** Canonical JSON {@link AgreementParty}; order is semantically meaningful. */
+    partyB: string;
+    /** Monotonic version within tenant, kind, and ordered counterparties. */
+    version: number;
+    status: AgreementStatus;
+    /** JSON object containing consumer-defined, frozen commercial terms. */
+    terms: string;
+    /** Inclusive start of the effective interval; null means no lower bound. */
+    effectiveFrom: Date | null;
+    /**
+     * Exclusive end of the effective interval; null means no upper bound.
+     * It is the one lifecycle-derived field: `AgreementCollection.activateAmendment`
+     * closes a predecessor at the new version's start in the same transition.
+     */
+    effectiveTo: Date | null;
+    /** Optional immutable e-sign evidence for this exact agreement version. */
+    executedAgreementId: string | null;
+    /** Activation provenance used only for withdrawing a not-yet-effective amendment. */
+    amendmentPredecessorId: string | null;
+    amendmentPredecessorEnd: Date | null;
+    metadata: string;
+    constructor(options?: AgreementOptions);
+    initialize(): Promise<this>;
+    isDraft(): boolean;
+    isActive(): boolean;
+    /**
+     * Tests the half-open effective interval `[effectiveFrom, effectiveTo)`.
+     * This makes an amendment starting at `T` and its predecessor ending at
+     * `T` non-overlapping. Lifecycle status is intentionally not considered.
+     */
+    isEffectiveAt(at: Date): boolean;
+    getPartyA(): AgreementParty | null;
+    getPartyB(): AgreementParty | null;
+    setPartyA(party: AgreementParty): void;
+    setPartyB(party: AgreementParty): void;
+    getTerms(): Record<string, unknown>;
+    setTerms(terms: Record<string, unknown>): void;
+    activate(): void;
+    supersede(): void;
+    terminate(at?: Date): void;
+    save(): Promise<this>;
+    /** @internal Complete observation of a collection-owned guarded transition. */
+    refreshAfterLifecycleTransition(): Promise<void>;
+    private assertActivationProvenanceUnchanged;
+    private assertEffectiveIntervalUnchanged;
+    private assertValidTerms;
+    private assertNaturalKeyNotTaken;
+    private resolvePriorStatus;
+    private assertStatusTransition;
+    private assertFrozenTermsUnchanged;
+    private serializeFrozenTerms;
+}
+export default Agreement;
+//# sourceMappingURL=Agreement.d.ts.map

package/dist/agreements/models/Agreement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agreement.d.ts","sourceRoot":"","sources":["../../../src/agreements/models/Agreement.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAE3D,OAAO,EAAqB,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAE/E,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EAErB,MAAM,aAAa,CAAC;AAcrB,6EAA6E;AAC7E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAYrE;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAoBxE;AAED,qBASa,SAAU,SAAQ,UAAU;IAEvC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B,qEAAqE;IAErE,IAAI,EAAE,MAAM,CAAM;IAElB,+EAA+E;IAE/E,MAAM,EAAE,MAAM,CAAM;IAEpB,+EAA+E;IAE/E,MAAM,EAAE,MAAM,CAAM;IAEpB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAK;IAEpB,MAAM,EAAE,eAAe,CAAW;IAElC,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAQ;IAErB,4EAA4E;IAC5E,aAAa,EAAE,IAAI,GAAG,IAAI,CAAQ;IAElC;;;;OAIG;IACH,WAAW,EAAE,IAAI,GAAG,IAAI,CAAQ;IAEhC,2EAA2E;IAE3E,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE1C,qFAAqF;IAErF,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE7C,uBAAuB,EAAE,IAAI,GAAG,IAAI,CAAQ;IAE5C,QAAQ,EAAE,MAAM,CAAQ;gBAEZ,OAAO,GAAE,gBAAqB;IAwB3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB1C,OAAO,IAAI,OAAO;IAIlB,QAAQ,IAAI,OAAO;IAInB;;;;OAIG;IACH,aAAa,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO;IAOhC,SAAS,IAAI,cAAc,GAAG,IAAI;IAIlC,SAAS,IAAI,cAAc,GAAG,IAAI;IAIlC,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAItC,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAItC,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAInC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAO9C,QAAQ,IAAI,IAAI;IAUhB,SAAS,IAAI,IAAI;IAcjB,SAAS,CAAC,EAAE,GAAE,IAAiB,GAAG,IAAI;IAevB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BpC,+EAA+E;IACzE,+BAA+B,IAAI,OAAO,CAAC,IAAI,CAAC;YAWxC,mCAAmC;IAkBjD,OAAO,CAAC,gCAAgC;IAoBxC,OAAO,CAAC,gBAAgB;YA0BV,wBAAwB;YAkCxB,kBAAkB;IAYhC,OAAO,CAAC,sBAAsB;IAS9B,OAAO,CAAC,0BAA0B;IASlC,OAAO,CAAC,oBAAoB;CAc7B;AAaD,eAAe,SAAS,CAAC"}

package/dist/agreements/types.d.ts

@@ -1,6 +1,38 @@
 /** Provider-neutral agreement execution contracts. */
 import type { SignatureAuthenticationMethod, SignatureDocument, SignatureSigner, SignatureSignerInput } from '@happyvertical/signatures';
 import type { SmrtObjectOptions } from '@happyvertical/smrt-core';
+/**
+ * A counterparty named by an application-owned kind and stable identifier.
+ *
+ * The agreements package deliberately does not import tenant, earner, profile,
+ * or application-domain models. Consumers may use `tenant`, `earner`, and
+ * `profile` kinds, or their own neutral kinds such as `organization` and
+ * `worker`. The value is stored canonically as JSON so it can be part of an
+ * agreement version's natural identity.
+ */
+export interface AgreementParty {
+    kind: string;
+    id: string;
+}
+/** Drafts activate or cancel; previously active versions supersede or terminate. */
+export declare const AGREEMENT_STATUSES: readonly ["draft", "cancelled", "active", "superseded", "terminated"];
+export type AgreementStatus = (typeof AGREEMENT_STATUSES)[number];
+/** Constructor options for a generic, versioned commercial agreement. */
+export interface AgreementOptions extends SmrtObjectOptions {
+    tenantId?: string | null;
+    kind?: string;
+    partyA?: string;
+    partyB?: string;
+    version?: number;
+    status?: AgreementStatus;
+    terms?: string;
+    effectiveFrom?: Date | string | number | null;
+    effectiveTo?: Date | string | number | null;
+    executedAgreementId?: string | null;
+    amendmentPredecessorId?: string | null;
+    amendmentPredecessorEnd?: Date | string | number | null;
+    metadata?: string;
+}
 export declare const AGREEMENT_EXECUTION_STATUSES: readonly ["prepared", "sent", "delivered", "viewed", "partially_signed", "completed", "declined", "cancelled", "expired", "failed"];
 export type AgreementExecutionStatus = (typeof AGREEMENT_EXECUTION_STATUSES)[number];
 export interface AgreementSignerIntent {

package/dist/agreements/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agreements/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agreements/types.ts"],"names":[],"mappings":"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"}

package/dist/agreements.d.ts

@@ -1,8 +1,8 @@
 /**
  * Subpath entry: `@happyvertical/smrt-sales/agreements`.
  *
- * Provider-neutral signature orchestration, verified lifecycle evidence, and
- * immutable executed-agreement artifacts.
+ * Generic versioned terms, provider-neutral signature orchestration, verified
+ * lifecycle evidence, and immutable executed-agreement artifacts.
  */
 import './__smrt-register__.js';
 export * from './agreements/index.js';

package/dist/agreements.js

@@ -1,3 +1,3 @@
-import "./chunks/__smrt-register__-BnG4rTI9.js";
-import { a as AgreementExecutionEvent, c as AGREEMENT_EXECUTION_STATUSES, d as sanitizeSignerIntent, i as AgreementExecutionEventCollection, l as coerceAgreementDate, n as ExecutedAgreementCollection, o as AgreementExecutionCollection, r as ExecutedAgreement, s as AgreementExecution, t as AgreementExecutionService, u as sanitizeSignerEvidence } from "./chunks/agreements-BB_tNU0U.js";
-export { AGREEMENT_EXECUTION_STATUSES, AgreementExecution, AgreementExecutionCollection, AgreementExecutionEvent, AgreementExecutionEventCollection, AgreementExecutionService, ExecutedAgreement, ExecutedAgreementCollection, coerceAgreementDate, sanitizeSignerEvidence, sanitizeSignerIntent };
+import "./chunks/__smrt-register__-DTUQW7wz.js";
+import { a as AgreementExecutionEvent, c as AgreementCollection, d as serializeAgreementParty, f as AGREEMENT_EXECUTION_STATUSES, g as sanitizeSignerIntent, h as sanitizeSignerEvidence, i as AgreementExecutionEventCollection, l as Agreement, m as coerceAgreementDate, n as ExecutedAgreementCollection, o as AgreementExecutionCollection, p as AGREEMENT_STATUSES, r as ExecutedAgreement, s as AgreementExecution, t as AgreementExecutionService, u as parseAgreementParty } from "./chunks/agreements-jBiVmttD.js";
+export { AGREEMENT_EXECUTION_STATUSES, AGREEMENT_STATUSES, Agreement, AgreementCollection, AgreementExecution, AgreementExecutionCollection, AgreementExecutionEvent, AgreementExecutionEventCollection, AgreementExecutionService, ExecutedAgreement, ExecutedAgreementCollection, coerceAgreementDate, parseAgreementParty, sanitizeSignerEvidence, sanitizeSignerIntent, serializeAgreementParty };