@agenticprimitives/intent-engagement 0.0.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agentic Trust Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,11 @@
+# @agenticprimitives/intent-engagement
+
+The layer between *candidate found* and *authorized provider is working* (spec 336): a **probe** carrying a minimized
+projection of an intent, the provider's **response** (offer · decline · needs-clarification · referral ·
+temporarily-unavailable · human-ux-required — business facts, never errors), a **firm offer** signed over RFC 8785
+canonical bytes, an **acceptance** that pins the offer's digest and can broaden nothing, the **mandate requirement** the
+work will need (RFC 9396 shape — a description, never authority), the **execute** command, and the **receipt** that binds
+intent, offer, mandate, executing agent and outcome by digest.
+
+Pure. No transport, no keys, no LLM. Two deterministic reducers (`decide` → events, `evolve` → state) for the engagement
+and offer state machines; models may suggest facts, they never transition state. Signing goes through the caller's signer.

package/dist/campaign.d.ts

@@ -0,0 +1,50 @@
+import type { Hex } from 'viem';
+import type { Address, EngagementCampaignV1, EngagementSituationV1, IsoTime, OfferSelectionV1 } from './documents.js';
+import type { CandidateV1 } from './ports.js';
+/** Every probe is a disclosure to one more party: the budget bounds how many are asked, how many offers
+ *  are wanted before the campaign stops asking, and when it stops waiting. */
+export interface CampaignBudgetV1 {
+    maxCandidates: number;
+    offersWanted: number;
+    deadline: IsoTime;
+}
+export declare function openCampaign(input: {
+    campaignId: string;
+    intentId: string;
+    intentVersion?: number;
+    intentDigest: Hex;
+    requester: Address;
+    budget: CampaignBudgetV1;
+    candidates: ReadonlyArray<Address>;
+}): EngagementCampaignV1;
+/** One candidate's standing in the evaluation: an eligible firm offer, or why it is not one. */
+export interface OfferEvaluationV1 {
+    provider: Address;
+    engagementId: string;
+    offerId?: string;
+    offerDigest?: Hex;
+    eligible: boolean;
+    because: string;
+}
+/**
+ * THE SELECTION. Among eligible firm offers, ordered rules — each applied only when it separates the field,
+ * each named in `because` when it does:
+ *   1. declares the capability in the PUBLIC tier (the resolver's evidence, spec 281) — over one that does not;
+ *   2. holds a RELATIONSHIP with the requester (as the candidate row asserts) — over a stranger;
+ *   3. the earliest firm offer received;
+ *   4. the order the campaign asked in.
+ * No rule is a weight, and no two are summed: a stranger's offer is never "0.7 of" a member's.
+ */
+export declare function selectOffer(input: {
+    campaign: EngagementCampaignV1;
+    situations: ReadonlyArray<EngagementSituationV1>;
+    candidates: ReadonlyArray<CandidateV1>;
+    capability: string;
+    now: IsoTime;
+}): {
+    campaign: EngagementCampaignV1;
+    situations: EngagementSituationV1[];
+    selection: OfferSelectionV1 | null;
+    evaluations: OfferEvaluationV1[];
+};
+//# sourceMappingURL=campaign.d.ts.map

package/dist/campaign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign.d.ts","sourceRoot":"","sources":["../src/campaign.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAsB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE1I,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C;8EAC8E;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,GAAG,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IACpG,MAAM,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CAC9D,GAAG,oBAAoB,CAevB;AAED,gGAAgG;AAChG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AA6BD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,QAAQ,EAAE,oBAAoB,CAAC;IAAC,UAAU,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAAC,UAAU,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;CAC5J,GAAG;IAAE,QAAQ,EAAE,oBAAoB,CAAC;IAAC,UAAU,EAAE,qBAAqB,EAAE,CAAC;IAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAmDhJ"}

package/dist/campaign.js

@@ -0,0 +1,125 @@
+import { offerDigest } from './digests.js';
+import { stepEngagement } from './reducer.js';
+export function openCampaign(input) {
+    const seen = new Set();
+    const candidates = [];
+    for (const c of input.candidates) {
+        const k = c.toLowerCase();
+        if (seen.has(k) || k === input.requester.toLowerCase())
+            continue; // never probe yourself; never twice
+        seen.add(k);
+        candidates.push(c);
+        if (candidates.length >= input.budget.maxCandidates)
+            break; // THE DISCLOSURE BUDGET
+    }
+    return {
+        type: 'ap.engagement-campaign.v1', campaignId: input.campaignId, intentId: input.intentId, intentVersion: input.intentVersion ?? 1,
+        intentDigest: input.intentDigest, requester: input.requester, maxCandidates: input.budget.maxCandidates, offersWanted: input.budget.offersWanted,
+        deadline: input.budget.deadline, candidates, engagements: [], state: 'open',
+    };
+}
+const lc = (s) => s.toLowerCase();
+/** The issued, unexpired offer in a situation that names the capability and binds this campaign's intent. */
+function eligibleOffer(s, capability, intentDigest, now) {
+    const issued = Object.values(s.offers).filter((o) => o.state === 'issued').map((o) => o.offer);
+    if (!issued.length) {
+        const kind = s.lastResponseKind;
+        const last = s.responses[s.responses.length - 1]?.content;
+        if (!kind || !last)
+            return { because: s.state === 'expired' ? 'no answer before the deadline' : `no offer (${s.state})` };
+        switch (last.kind) {
+            case 'decline': return { because: `declined: ${last.reason}${last.detail ? ` — ${last.detail}` : ''}` };
+            case 'needs-clarification': return { because: 'asked a question; this campaign takes only firm offers' };
+            case 'referral': return { because: `referred to ${last.to}; a referral is recorded, never followed` };
+            case 'temporarily-unavailable': return { because: `unavailable until ${last.until}` };
+            case 'human-ux-required': return { because: 'a human channel is required — a person\'s agent does not commit its person from a server' };
+            case 'offer': return { because: last.offer.type !== 'ap.fulfillment-offer.v1' ? 'an indicative proposal, not a firm offer' : `its offer is ${Object.values(s.offers)[0]?.state ?? 'not open'}` };
+        }
+    }
+    // Newest revision first, so a superseding offer is the one judged.
+    const offer = [...issued].sort((a, b) => b.revision - a.revision)[0];
+    if (Date.parse(offer.expiresAt) <= Date.parse(now))
+        return { because: `its offer expired at ${offer.expiresAt}` };
+    if (!offer.requirement.actions.includes(capability))
+        return { because: `its offer does not name ${capability}` };
+    if (lc(offer.intentDigest) !== lc(intentDigest) || lc(offer.requirement.intentDigest) !== lc(intentDigest))
+        return { because: 'its offer binds another intent' };
+    if (!offer.signature || offer.signature === '0x')
+        return { because: 'its offer is unsigned' };
+    return { offer, digest: offerDigest(offer) };
+}
+/**
+ * THE SELECTION. Among eligible firm offers, ordered rules — each applied only when it separates the field,
+ * each named in `because` when it does:
+ *   1. declares the capability in the PUBLIC tier (the resolver's evidence, spec 281) — over one that does not;
+ *   2. holds a RELATIONSHIP with the requester (as the candidate row asserts) — over a stranger;
+ *   3. the earliest firm offer received;
+ *   4. the order the campaign asked in.
+ * No rule is a weight, and no two are summed: a stranger's offer is never "0.7 of" a member's.
+ */
+export function selectOffer(input) {
+    const { campaign, capability, now } = input;
+    const order = new Map(campaign.candidates.map((c, i) => [lc(c), i]));
+    const candidateOf = (a) => input.candidates.find((c) => lc(c.agent) === lc(a));
+    const evaluations = [];
+    const eligible = [];
+    for (const s of [...input.situations].sort((a, b) => (order.get(lc(a.candidate)) ?? 99) - (order.get(lc(b.candidate)) ?? 99))) {
+        const e = eligibleOffer(s, capability, campaign.intentDigest, now);
+        if ('because' in e) {
+            evaluations.push({ provider: s.candidate, engagementId: s.engagementId, eligible: false, because: e.because });
+            continue;
+        }
+        eligible.push({ s, offer: e.offer, digest: e.digest });
+        evaluations.push({ provider: s.candidate, engagementId: s.engagementId, offerId: e.offer.offerId, offerDigest: e.digest, eligible: true, because: 'a firm offer, signed, unexpired, naming the capability and this intent' });
+    }
+    if (!eligible.length)
+        return { campaign: { ...campaign, state: campaign.state }, situations: [...input.situations], selection: null, evaluations };
+    let field = eligible;
+    const because = [];
+    const declares = (a) => !!candidateOf(a)?.capabilityEvidence.some((ev) => ev.capability === capability);
+    const related = (a) => !!candidateOf(a)?.relationship;
+    const narrow = (keep, why) => {
+        const kept = field.filter(keep);
+        if (kept.length && kept.length < field.length) {
+            because.push(why(kept, field.filter((x) => !keep(x))));
+            field = kept;
+        }
+    };
+    narrow((x) => declares(x.s.candidate), (_k, d) => `declares ${capability} in the public tier; ${d.map((x) => x.s.candidate).join(', ')} ${d.length === 1 ? 'does' : 'do'} not`);
+    narrow((x) => related(x.s.candidate), (k, _d) => `holds a relationship with the requester (${candidateOf(k[0].s.candidate)?.relationship?.kind})`);
+    if (field.length > 1) {
+        const earliest = [...field].sort((a, b) => Date.parse(a.offer.issuedAt) - Date.parse(b.offer.issuedAt))[0];
+        const ties = field.filter((x) => x.offer.issuedAt === earliest.offer.issuedAt);
+        if (ties.length < field.length) {
+            because.push(`the earliest firm offer (${earliest.offer.issuedAt})`);
+            field = ties;
+        }
+        if (field.length > 1) {
+            because.push('asked first — nothing else distinguishes the offers');
+            field = [field[0]];
+        }
+    }
+    if (!because.length)
+        because.push('the only firm offer received');
+    const winner = field[0];
+    const decidedAt = now;
+    const selection = {
+        type: 'ap.offer-selection.v1', campaignId: campaign.campaignId,
+        selected: { offerId: winner.offer.offerId, offerDigest: winner.digest, provider: winner.offer.provider },
+        because,
+        notSelected: evaluations.filter((e) => lc(e.provider) !== lc(winner.offer.provider)).map((e) => ({ offerId: e.offerId ?? '', provider: e.provider, because: e.eligible ? `a firm offer, not selected: ${winner.offer.provider} was preferred (${because[0]})` : e.because })),
+        decidedAt,
+    };
+    // The reducer moves state, nothing else: the winner is SELECTED, every other open conversation is CLOSED not-selected.
+    const situations = input.situations.map((s) => {
+        if (s.engagementId === winner.s.engagementId) {
+            const r = stepEngagement(s, { kind: 'SelectOffer', offerId: winner.offer.offerId, offerDigest: winner.digest, because, idempotencyKey: `${campaign.campaignId}:select:${winner.offer.offerId}`, now });
+            return r.ok ? r.state : s;
+        }
+        const why = selection.notSelected.find((n) => lc(n.provider) === lc(s.candidate))?.because ?? 'not selected';
+        const r = stepEngagement(s, { kind: 'NotSelected', because: why, idempotencyKey: `${campaign.campaignId}:not-selected:${s.engagementId}`, now });
+        return r.ok ? r.state : s;
+    });
+    return { campaign: { ...campaign, selection, state: 'selected' }, situations, selection, evaluations };
+}
+//# sourceMappingURL=campaign.js.map

package/dist/campaign.js.map

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

package/dist/digests.d.ts

@@ -0,0 +1,13 @@
+import { type Hex } from 'viem';
+import type { EngagementProbeV1, FulfillmentOfferV1, FulfillmentReceiptV1, IntentProjectionV1, OfferAcceptanceV1 } from './documents.js';
+export declare const digestOf: (doc: unknown) => Hex;
+/** The projection as it goes on the wire — the local `withholds` manifest stripped (naming omitted
+ *  categories on the wire can itself leak, §3.1). */
+export declare function wireProjection(p: IntentProjectionV1): Omit<IntentProjectionV1, 'withholds'>;
+export declare const projectionDigest: (p: IntentProjectionV1) => Hex;
+export declare const probeDigest: (p: EngagementProbeV1) => Hex;
+/** The offer WITHOUT its signature — what the provider signs and what an acceptance pins. */
+export declare const offerDigest: (o: FulfillmentOfferV1) => Hex;
+export declare const acceptanceDigest: (a: OfferAcceptanceV1) => Hex;
+export declare const receiptDigest: (r: FulfillmentReceiptV1) => Hex;
+//# sourceMappingURL=digests.d.ts.map

package/dist/digests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digests.d.ts","sourceRoot":"","sources":["../src/digests.ts"],"names":[],"mappings":"AAGA,OAAO,EAA4B,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAE1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEzI,eAAO,MAAM,QAAQ,QAAS,OAAO,KAAG,GAAqD,CAAC;AAE9F;qDACqD;AACrD,wBAAgB,cAAc,CAAC,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAG3F;AAED,eAAO,MAAM,gBAAgB,MAAO,kBAAkB,KAAG,GAAkC,CAAC;AAC5F,eAAO,MAAM,WAAW,MAAO,iBAAiB,KAAG,GAAkB,CAAC;AACtE,6FAA6F;AAC7F,eAAO,MAAM,WAAW,MAAO,kBAAkB,KAAG,GAA+E,CAAC;AACpI,eAAO,MAAM,gBAAgB,MAAO,iBAAiB,KAAG,GAA+E,CAAC;AACxI,eAAO,MAAM,aAAa,MAAO,oBAAoB,KAAG,GAA+E,CAAC"}

package/dist/digests.js

@@ -0,0 +1,19 @@
+// DIGESTS — RFC 8785 JCS canonical bytes → keccak256, the ONE way a document is bound (the same
+// canonicaliser `delegation.intentDigest` uses, so a requirement's `intentDigest` and a probe's agree byte
+// for byte). Signing itself goes through the caller's signer; nothing here holds a key.
+import { keccak256, stringToBytes } from 'viem';
+import { jcsCanonicalize } from '@agenticprimitives/types';
+export const digestOf = (doc) => keccak256(stringToBytes(jcsCanonicalize(doc)));
+/** The projection as it goes on the wire — the local `withholds` manifest stripped (naming omitted
+ *  categories on the wire can itself leak, §3.1). */
+export function wireProjection(p) {
+    const { withholds: _w, ...wire } = p;
+    return wire;
+}
+export const projectionDigest = (p) => digestOf(wireProjection(p));
+export const probeDigest = (p) => digestOf(p);
+/** The offer WITHOUT its signature — what the provider signs and what an acceptance pins. */
+export const offerDigest = (o) => { const { signature: _s, ...unsigned } = o; return digestOf(unsigned); };
+export const acceptanceDigest = (a) => { const { signature: _s, ...unsigned } = a; return digestOf(unsigned); };
+export const receiptDigest = (r) => { const { signature: _s, ...unsigned } = r; return digestOf(unsigned); };
+//# sourceMappingURL=digests.js.map

package/dist/digests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"digests.js","sourceRoot":"","sources":["../src/digests.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,2GAA2G;AAC3G,wFAAwF;AACxF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAY,MAAM,MAAM,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAY,EAAO,EAAE,CAAC,SAAS,CAAC,aAAa,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAE9F;qDACqD;AACrD,MAAM,UAAU,cAAc,CAAC,CAAqB;IAClD,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAqB,EAAO,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAoB,EAAO,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACtE,6FAA6F;AAC7F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAqB,EAAO,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACpI,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAoB,EAAO,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACxI,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAuB,EAAO,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/documents.d.ts

@@ -0,0 +1,282 @@
+import type { Hex } from 'viem';
+export type Address = `0x${string}`;
+export type IsoTime = string;
+export type ProjectionKind = 'discovery' | 'engagement' | 'execution';
+/** A purpose- and audience-bound view of an intent. Derived, never edited independently. The `fields` are
+ *  what was released; what was withheld is a LOCAL manifest (`withholds`, never on the wire). */
+export interface IntentProjectionV1 {
+    type: 'ap.intent-projection.v1';
+    kind: ProjectionKind;
+    intentId: string;
+    intentVersion: number;
+    /** keccak(JCS) of the canonical intent this projects — the requester's, never re-derived by a provider. */
+    intentDigest: Hex;
+    /** `broadcast` for discovery; ONE candidate for engagement; the selected provider for execution. */
+    audience: 'broadcast' | Address;
+    purpose: string;
+    fields: Record<string, unknown>;
+    /** Local only. Stripped by `wireProjection` before a probe is built. */
+    withholds?: string[];
+}
+export type EngagementObjective = 'availability-check' | 'accept-or-decline' | 'indicative-proposal' | 'firm-offer' | 'negotiation';
+export type ClarificationMode = 'not-allowed' | 'structured-only' | 'conversational';
+export type HumanChannel = 'json-schema-form' | 'a2ui' | 'external-url';
+export type ProbeProcessingModel = 'direct-message' | 'evaluation-task' | 'reciprocal-a2a';
+export interface InteractionPolicyV1 {
+    clarification: ClarificationMode;
+    humanChannels: HumanChannel[];
+    maxRounds: number;
+}
+export interface EngagementProbeV1 {
+    type: 'ap.engagement-probe.v1';
+    probeId: string;
+    engagementId: string;
+    campaignId: string;
+    requester: Address;
+    candidate: Address;
+    /** The engagement projection the candidate reviews — audience = candidate, `withholds` stripped. */
+    projection: Omit<IntentProjectionV1, 'withholds'>;
+    projectionDigest: Hex;
+    intentDigest: Hex;
+    objective: EngagementObjective;
+    interaction: InteractionPolicyV1;
+    processing: ProbeProcessingModel;
+    replyBy: IsoTime;
+    /** Single-use. A response must echo it; a second response with the same nonce is a duplicate. */
+    probeNonce: string;
+    issuedAt: IsoTime;
+}
+export interface EngagementAcknowledgementV1 {
+    type: 'ap.engagement-ack.v1';
+    probeId: string;
+    engagementId: string;
+    provider: Address;
+    processing: ProbeProcessingModel;
+    responseExpectedBy: IsoTime;
+    issuedAt: IsoTime;
+}
+export type EngagementResponseKind = 'offer' | 'needs-clarification' | 'human-ux-required' | 'referral' | 'decline' | 'temporarily-unavailable';
+/** §3.5a — the kinds are two axes: what the act DOES, and what an INFORM's content is about. */
+export declare const RESPONSE_KIND_AXES: Readonly<Record<EngagementResponseKind, {
+    performative: 'PROPOSE' | 'REJECT' | 'QUERY' | 'INFORM';
+    content?: 'other-provider' | 'time' | 'how-the-answer-arrives';
+}>>;
+/** A named claim the provider needs, answered by the vault with a value, a predicate, a credential — or a refusal. */
+export interface QuestionV1 {
+    name: string;
+    schema: Record<string, unknown>;
+    purpose: string;
+    sensitivity: 'public' | 'internal' | 'personal';
+}
+export interface QuestionSetV1 {
+    type: 'ap.question-set.v1';
+    questions: QuestionV1[];
+}
+/** An opaque single-use handle to a provider UX. Carries NO content; consent to open is not approval. */
+export interface HumanInteractionRequestV1 {
+    type: 'ap.human-interaction.v1';
+    channel: HumanChannel;
+    handle: string;
+    expiresAt: IsoTime;
+}
+export type EngagementResponseContentV1 = {
+    kind: 'offer';
+    offer: FulfillmentOfferV1 | IndicativeFulfillmentProposalV1;
+} | {
+    kind: 'decline';
+    reason: string;
+    detail?: string;
+} | {
+    kind: 'needs-clarification';
+    questions: QuestionSetV1;
+} | {
+    kind: 'referral';
+    to: Address;
+    because?: string;
+} | {
+    kind: 'temporarily-unavailable';
+    until?: IsoTime;
+    because?: string;
+} | {
+    kind: 'human-ux-required';
+    request: HumanInteractionRequestV1;
+};
+export interface EngagementResponseV1 {
+    type: 'ap.engagement-response.v1';
+    responseId: string;
+    inReplyTo: string;
+    engagementId: string;
+    provider: Address;
+    probeNonce: string;
+    content: EngagementResponseContentV1;
+    issuedAt: IsoTime;
+    /** Duplicates never duplicate transitions: two responses with one key are one response. */
+    idempotencyKey: string;
+}
+/** RFC 9396 shape — WHAT the work will need. A description; publishable; grants nothing. Structurally the
+ *  `delegation` package's `MandateRequirementV1`, mirrored so this package stays a leaf. */
+export interface MandateRequirementV1 {
+    type: string;
+    actions: string[];
+    locations?: string[];
+    limits?: Record<string, string | number>;
+    intentDigest: Hex;
+    projectionDigest?: Hex;
+    offerDigest?: Hex;
+    validAfter?: number;
+    validUntil: number;
+    methods?: Hex[];
+}
+export interface OfferTermsV1 {
+    scopeAccepted: string;
+    assumptions?: string[];
+    exclusions?: string[];
+    /** The fields the projection withheld that the offer names as needed — what a mandate may authorize disclosing. */
+    requiredInputs?: string[];
+    expectedArtifacts?: string[];
+    price?: {
+        amount: string;
+        currency: string;
+    };
+    jurisdiction?: string;
+    dataHandling?: string;
+}
+/** NON-binding. Its own class so an estimate and an acceptance-capable instrument are never confusable. */
+export interface IndicativeFulfillmentProposalV1 {
+    type: 'ap.indicative-proposal.v1';
+    proposalId: string;
+    engagementId: string;
+    provider: Address;
+    basisOfOffer: Hex;
+    intentDigest: Hex;
+    terms: OfferTermsV1;
+    issuedAt: IsoTime;
+}
+/** The provider's SIGNED, expiring, conditional commitment to fulfil ONE intent on stated terms. Immutable:
+ *  a change is a new revision that supersedes this one. */
+export interface FulfillmentOfferV1 {
+    type: 'ap.fulfillment-offer.v1';
+    offerId: string;
+    revision: number;
+    supersedes?: string;
+    engagementId: string;
+    provider: Address;
+    requester: Address;
+    basisOfOffer: Hex;
+    intentDigest: Hex;
+    terms: OfferTermsV1;
+    requirement: MandateRequirementV1;
+    expiresAt: IsoTime;
+    issuedAt: IsoTime;
+    /** The provider SA's signature over `offerDigest(offer)` — ERC-1271 / ECDSA, verified by the caller's checks. */
+    signature: Hex;
+}
+/** Pins the accepted offer's digest. Cannot broaden or modify terms — a differing acceptance is a counter-proposal
+ *  and belongs in a new offer revision. */
+export interface OfferAcceptanceV1 {
+    type: 'ap.offer-acceptance.v1';
+    acceptanceId: string;
+    engagementId: string;
+    offerId: string;
+    offerDigest: Hex;
+    requester: Address;
+    acceptedAt: IsoTime;
+    signature: Hex;
+}
+/** The campaign's PRIVATE comparison decision, with reasons and the losing offers — reviewable, never a score. */
+export interface OfferSelectionV1 {
+    type: 'ap.offer-selection.v1';
+    campaignId: string;
+    selected: {
+        offerId: string;
+        offerDigest: Hex;
+        provider: Address;
+    };
+    because: string[];
+    notSelected: Array<{
+        offerId: string;
+        provider: Address;
+        because: string;
+    }>;
+    decidedAt: IsoTime;
+}
+/** The explicit typed command that creates a fulfillment task — never a re-send of the intent. */
+export interface ExecuteAcceptedOfferV1 {
+    type: 'ap.execute-accepted-offer.v1';
+    engagementId: string;
+    offerId: string;
+    offerDigest: Hex;
+    acceptanceId: string;
+    acceptanceDigest: Hex;
+    /** The mandate presented — by reference (its delegation hash). The wire travels beside this command. */
+    mandateRef: Hex;
+    idempotencyKey: string;
+    issuedAt: IsoTime;
+}
+export interface FulfillmentReceiptV1 {
+    type: 'ap.fulfillment-receipt.v1';
+    receiptId: string;
+    engagementId: string;
+    intentDigest: Hex;
+    offerDigest: Hex;
+    mandateRef: Hex;
+    taskRef?: string;
+    executingAgent: Address;
+    action: string;
+    outcome: 'completed' | 'failed' | 'declined';
+    evidenceRefs: string[];
+    issuedAt: IsoTime;
+    signature: Hex;
+}
+export interface RemoteA2AContextV1 {
+    provider: Address;
+    contextId: string;
+    taskId?: string;
+}
+export type EngagementState = 'new' | 'probe-sent' | 'waiting-on-provider' | 'waiting-on-requester' | 'offer-open' | 'offer-selected' | 'awaiting-mandate' | 'fulfillment-linked' | 'closed-declined' | 'closed-referred' | 'closed-unavailable' | 'closed-not-selected' | 'expired' | 'cancelled';
+export type OfferState = 'draft' | 'issued' | 'accepted' | 'rejected' | 'withdrawn' | 'superseded' | 'expired';
+/** ONE requester–candidate conversation. */
+export interface EngagementSituationV1 {
+    type: 'ap.engagement-situation.v1';
+    engagementId: string;
+    campaignId: string;
+    requester: Address;
+    candidate: Address;
+    state: EngagementState;
+    /** The last response KIND — an event, not a durable state (§4). */
+    lastResponseKind?: EngagementResponseKind;
+    probes: EngagementProbeV1[];
+    responses: EngagementResponseV1[];
+    offers: Record<string, {
+        offer: FulfillmentOfferV1;
+        state: OfferState;
+    }>;
+    acceptance?: OfferAcceptanceV1;
+    mandateRef?: Hex;
+    taskRef?: string;
+    transport?: RemoteA2AContextV1;
+    closeReason?: string;
+    /** Every idempotency key seen, so a duplicate is recognised as one. */
+    seen: string[];
+    updatedAt: IsoTime;
+}
+/** ONE intent, MANY candidates. */
+export interface EngagementCampaignV1 {
+    type: 'ap.engagement-campaign.v1';
+    campaignId: string;
+    intentId: string;
+    intentVersion: number;
+    intentDigest: Hex;
+    requester: Address;
+    /** Every probe is a disclosure to one more party. */
+    maxCandidates: number;
+    offersWanted: number;
+    deadline: IsoTime;
+    candidates: Address[];
+    engagements: string[];
+    selection?: OfferSelectionV1;
+    state: 'open' | 'selected' | 'closed';
+}
+/** Conformance profiles a provider advertises per capability, in its card (§8.5). */
+export type ConformanceProfile = 'IEP Core' | 'IEP Evaluation Task' | 'IEP Clarification' | 'IEP Human Interaction' | 'IEP Negotiation' | 'IEP Signed Offer' | 'IEP Mandated Execution';
+//# sourceMappingURL=documents.d.ts.map

package/dist/documents.d.ts.map

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

package/dist/documents.js

@@ -0,0 +1,10 @@
+/** §3.5a — the kinds are two axes: what the act DOES, and what an INFORM's content is about. */
+export const RESPONSE_KIND_AXES = {
+    'offer': { performative: 'PROPOSE' },
+    'decline': { performative: 'REJECT' },
+    'needs-clarification': { performative: 'QUERY' },
+    'referral': { performative: 'INFORM', content: 'other-provider' },
+    'temporarily-unavailable': { performative: 'INFORM', content: 'time' },
+    'human-ux-required': { performative: 'INFORM', content: 'how-the-answer-arrives' },
+};
+//# sourceMappingURL=documents.js.map

package/dist/documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["../src/documents.ts"],"names":[],"mappings":"AA2EA,gGAAgG;AAChG,MAAM,CAAC,MAAM,kBAAkB,GAA0K;IACvM,OAAO,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE;IACpC,SAAS,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE;IACrC,qBAAqB,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE;IAChD,UAAU,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE;IACjE,yBAAyB,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE;IACtE,mBAAmB,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,wBAAwB,EAAE;CACnF,CAAC"}

package/dist/fulfillment.d.ts

@@ -0,0 +1,17 @@
+import type { Address, FulfillmentReceiptV1 } from './documents.js';
+import type { Hex } from 'viem';
+export declare function fulfillmentReceipt(input: {
+    receiptId: string;
+    engagementId: string;
+    intentDigest: Hex;
+    offerDigest: Hex;
+    mandateRef: Hex;
+    executingAgent: Address;
+    action: string;
+    outcome?: FulfillmentReceiptV1['outcome'];
+    evidenceRefs: string[];
+    taskRef?: string;
+    issuedAt: string;
+    sign: (digest: Hex) => Hex;
+}): FulfillmentReceiptV1;
+//# sourceMappingURL=fulfillment.d.ts.map

package/dist/fulfillment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fulfillment.d.ts","sourceRoot":"","sources":["../src/fulfillment.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAGhC,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,GAAG,CAAC;IAAC,WAAW,EAAE,GAAG,CAAC;IAAC,UAAU,EAAE,GAAG,CAAC;IAC9F,cAAc,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAC3G,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,GAAG,CAAC;CAChE,GAAG,oBAAoB,CASvB"}

package/dist/fulfillment.js

@@ -0,0 +1,12 @@
+import { receiptDigest } from './digests.js';
+export function fulfillmentReceipt(input) {
+    const unsigned = {
+        type: 'ap.fulfillment-receipt.v1', receiptId: input.receiptId, engagementId: input.engagementId,
+        intentDigest: input.intentDigest, offerDigest: input.offerDigest, mandateRef: input.mandateRef,
+        ...(input.taskRef ? { taskRef: input.taskRef } : {}), executingAgent: input.executingAgent, action: input.action,
+        outcome: input.outcome ?? 'completed', evidenceRefs: input.evidenceRefs, issuedAt: input.issuedAt,
+    };
+    const digest = receiptDigest({ ...unsigned, signature: '0x' });
+    return { ...unsigned, signature: input.sign(digest) };
+}
+//# sourceMappingURL=fulfillment.js.map

package/dist/fulfillment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fulfillment.js","sourceRoot":"","sources":["../src/fulfillment.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,UAAU,kBAAkB,CAAC,KAIlC;IACC,MAAM,QAAQ,GAA4C;QACxD,IAAI,EAAE,2BAA2B,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY;QAC/F,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU;QAC9F,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM;QAChH,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,WAAW,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ;KAClG,CAAC;IACF,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,GAAG,QAAQ,EAAE,SAAS,EAAE,IAAI,EAA0B,CAAC,CAAC;IACvF,OAAO,EAAE,GAAG,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;AACxD,CAAC"}