@agenticprimitives/coordination 0.0.0-alpha.2

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,85 @@
+# @agenticprimitives/coordination
+
+The **Endeavor** coordination core (spec 332, Wave 1): a durable, shared, multi-principal coordination
+object — *someone posted a request; the group adopted it as a goal; a shared plan was proposed, revised,
+and adopted; participants were allocated and committed; work executed against plan steps; the outcome was
+validated* — expressed as a pure, deterministic, event-sourced machine.
+
+## Install
+
+```bash
+pnpm add @agenticprimitives/coordination
+```
+
+Subpath exports: `.` (everything), `./core` (records, commands, events, reducer, provenance inputs),
+`./planning` (plans, steps, edges, milestones, content hash, acyclicity), `./participation`
+(participations, proposals, allocations, signed commitments). `./profiles`, `./decisions`, and
+`./projections` are reserved stubs whose real contents land with spec 333/334.
+
+## Model
+
+- **`EndeavorRequestV1`** — structured intake before adoption (`ereq_` id). Any entry point (Home
+  request, discussion ask, inbox ask, A2A intent) produces the same request and drives the same
+  machinery.
+- **`EndeavorV1`** — the durable multi-principal Situation (`end_` id) pursuing an
+  `OutcomeSpecificationV1` (observable success criteria, versioned).
+- **`CoordinationPlanV1`** — the durable *shared* plan (`p-plan:Plan` grounding). Revisions are
+  immutable; `planContentHash` is `sha256(JCS(steps + edges + milestones))`; adoption is an explicit
+  decision, never implicit; at most one revision is adopted at a time.
+- **`EndeavorParticipationV1`** — a participant's relationship to the Endeavor (role + scope +
+  validity), asserted through invitation/acceptance or allocation/commitment.
+- **`ContributionProposalV1` → `AllocationDecisionV1` → `ContributionCommitmentV1`** — offer,
+  selection, and the participant's *signed* acceptance. A commitment binds an **exact plan revision
+  hash**; a stale hash is rejected.
+
+## Usage
+
+```ts
+import {
+  initialCoordinationState,
+  validateCoordinationCommand,
+  applyCoordinationEvent,
+  deriveProvenanceInputs,
+} from '@agenticprimitives/coordination/core';
+
+let state = initialCoordinationState();
+const result = validateCoordinationCommand(state, {
+  kind: 'SubmitEndeavorRequest',
+  actor: requesterAddress,
+  issuedAt: new Date().toISOString(),
+  requestId: 'ereq_1',
+  targetPrincipal: orgAddress,
+  goal: 'Produce the Q3 treasury report',
+  entryPoint: 'home-request',
+});
+if (!result.ok) throw new Error(result.reason);
+for (const event of result.events) state = applyCoordinationEvent(state, event);
+```
+
+`validateCoordinationCommand` rejects before append (fail-closed) and returns the events to persist;
+`applyCoordinationEvent` is a pure reducer that enforces monotonic revisions. Replaying the event log
+always reproduces the state; `deriveProvenanceInputs(events)` yields a structural summary (entities,
+activities, agents, `correspondsToStep` links) a P-Plan/PROV projection can consume.
+
+## Invariants (spec 332 §6/§9)
+
+1. **Allocation is never authority.** No gate reads an `apcoord:` record; `capable / available /
+   allocated / committed / authorized / performing / satisfied` are seven separate facts.
+2. **Commitments are signed** by the participant against the exact adopted plan revision hash.
+3. **Conversation never mutates state.** Only signed commands produce events; `PlanRejected` is the
+   only way a plan proposal dies; unknown command kinds are rejected fail-closed.
+4. **One mechanism** (ADR-0013): the reducer is the only state-transition path.
+5. **Deterministic:** ids and timestamps come from commands/events, never from the reducer.
+
+## Boundaries
+
+Depends on `@agenticprimitives/types`, `@agenticprimitives/situations` (EntityRef, validity, JCS), and
+`@agenticprimitives/ontology` (`apcoord:` IRIs). Never imports fabric/home/a2a/delegation/vault —
+those layers consume coordination. Vendor adapters (Linear, Jira, Temporal, LangGraph, …) live in
+external repos; only `ExternalObjectBindingV1` (the adapter contract surface) ships here.
+
+## Spec
+
+[`specs/332-coordination-endeavor-core.md`](../../specs/332-coordination-endeavor-core.md) ·
+[ADR-0054](../../docs/architecture/decisions/0054-coordination-endeavor-doctrine.md) · golden fixtures
+in `test/fixtures/`.

package/dist/core/commands.d.ts

@@ -0,0 +1,179 @@
+import type { Address } from '@agenticprimitives/types';
+import type { EntityRef, SituationId } from '@agenticprimitives/situations';
+import type { AllocationId, CommitmentId, CoordinationPlanId, EndeavorId, EndeavorRequestId, ParticipationId, PlanStepId, ProposalId, RecommendationId } from './ids.js';
+import type { ContextRef, EndeavorEntryPoint, OutcomeCriterionV1 } from './types.js';
+import type { MilestoneDefinitionV1, PlanEdgeV1, PlanRevisionRef, PlanStepV1 } from '../planning/types.js';
+import type { ParticipationRole, SignedPayloadRef } from '../participation/types.js';
+import type { CoordinationCommandTemplate, RecommendationSubjectV1 } from '../decisions/types.js';
+interface CommandBase {
+    actor: Address;
+    issuedAt: string;
+}
+export interface SubmitEndeavorRequestCommand extends CommandBase {
+    kind: 'SubmitEndeavorRequest';
+    requestId: EndeavorRequestId;
+    targetPrincipal: Address;
+    goal: string;
+    entryPoint: EndeavorEntryPoint;
+    intentRef?: EntityRef;
+    intakeContext?: ContextRef[];
+    profileRef?: EntityRef;
+}
+export interface AdoptEndeavorCommand extends CommandBase {
+    kind: 'AdoptEndeavor';
+    requestId: EndeavorRequestId;
+    endeavorId: EndeavorId;
+    situationId: SituationId;
+    title: string;
+    outcome: {
+        outcomeId: string;
+        criteria: OutcomeCriterionV1[];
+    };
+    initialParticipations: Array<{
+        participationId: ParticipationId;
+        participant: Address;
+        role: ParticipationRole;
+    }>;
+}
+export interface DeclineEndeavorRequestCommand extends CommandBase {
+    kind: 'DeclineEndeavorRequest';
+    requestId: EndeavorRequestId;
+    reason: string;
+}
+export interface ReviseOutcomeCommand extends CommandBase {
+    kind: 'ReviseOutcome';
+    endeavorId: EndeavorId;
+    outcome: {
+        outcomeId: string;
+        criteria: OutcomeCriterionV1[];
+    };
+}
+export interface ProposePlanCommand extends CommandBase {
+    kind: 'ProposePlan';
+    endeavorId: EndeavorId;
+    planId: CoordinationPlanId;
+    revision: number;
+    steps: PlanStepV1[];
+    edges: PlanEdgeV1[];
+    milestones: MilestoneDefinitionV1[];
+}
+export interface AdoptPlanCommand extends CommandBase {
+    kind: 'AdoptPlan';
+    endeavorId: EndeavorId;
+    planRef: PlanRevisionRef;
+}
+export interface RejectPlanCommand extends CommandBase {
+    kind: 'RejectPlan';
+    endeavorId: EndeavorId;
+    planId: CoordinationPlanId;
+    revision: number;
+    reason?: string;
+}
+export interface InviteParticipantCommand extends CommandBase {
+    kind: 'InviteParticipant';
+    endeavorId: EndeavorId;
+    participationId: ParticipationId;
+    participant: Address;
+    role: ParticipationRole;
+    scope?: PlanStepId[];
+}
+export interface AcceptParticipationCommand extends CommandBase {
+    kind: 'AcceptParticipation';
+    endeavorId: EndeavorId;
+    participationId: ParticipationId;
+}
+export interface WithdrawParticipationCommand extends CommandBase {
+    kind: 'WithdrawParticipation';
+    endeavorId: EndeavorId;
+    participationId: ParticipationId;
+}
+export interface ProposeContributionCommand extends CommandBase {
+    kind: 'ProposeContribution';
+    endeavorId: EndeavorId;
+    proposalId: ProposalId;
+    planRef: PlanRevisionRef;
+    steps: PlanStepId[];
+    note?: string;
+}
+export interface AllocateContributionCommand extends CommandBase {
+    kind: 'AllocateContribution';
+    endeavorId: EndeavorId;
+    allocationId: AllocationId;
+    proposalRef: ProposalId;
+    participant: Address;
+    steps: PlanStepId[];
+}
+export interface CommitContributionCommand extends CommandBase {
+    kind: 'CommitContribution';
+    endeavorId: EndeavorId;
+    commitmentId: CommitmentId;
+    allocationRef: AllocationId;
+    planRef: PlanRevisionRef;
+    steps: PlanStepId[];
+    signature: SignedPayloadRef;
+    bounds?: {
+        deadline?: string;
+        effortEstimateRef?: EntityRef;
+    };
+}
+export interface WithdrawCommitmentCommand extends CommandBase {
+    kind: 'WithdrawCommitment';
+    endeavorId: EndeavorId;
+    commitmentId: CommitmentId;
+    reason?: string;
+}
+export interface ReallocateContributionCommand extends CommandBase {
+    kind: 'ReallocateContribution';
+    endeavorId: EndeavorId;
+    commitmentId: CommitmentId;
+    allocationId: AllocationId;
+    participant: Address;
+}
+export interface RecordStepSatisfiedCommand extends CommandBase {
+    kind: 'RecordStepSatisfied';
+    endeavorId: EndeavorId;
+    stepId: PlanStepId;
+    evidenceRefs: EntityRef[];
+}
+export interface RecordMilestoneAchievedCommand extends CommandBase {
+    kind: 'RecordMilestoneAchieved';
+    endeavorId: EndeavorId;
+    milestoneId: string;
+    evidenceRefs: EntityRef[];
+}
+export interface SatisfyEndeavorCommand extends CommandBase {
+    kind: 'SatisfyEndeavor';
+    endeavorId: EndeavorId;
+    outcomeValidationRef: EntityRef;
+}
+export interface AbandonEndeavorCommand extends CommandBase {
+    kind: 'AbandonEndeavor';
+    endeavorId: EndeavorId;
+    reason?: string;
+}
+/** spec 333 §3 / spec 334 §10 (W4 minimal slice) — the actor is the RECOMMENDING agent. */
+export interface ProposeRecommendationCommand extends CommandBase {
+    kind: 'ProposeRecommendation';
+    recommendationId: RecommendationId;
+    subject: RecommendationSubjectV1;
+    /** Recommendation class, e.g. 'duplicate-goal', 'triage-classification'. */
+    recommendationKind: string;
+    proposedCommands: CoordinationCommandTemplate[];
+    confidence?: number;
+    explanation: string;
+    evidenceRefs?: EntityRef[];
+}
+/** Steward/principal decision on a proposed recommendation. Acceptance NEVER applies the
+ *  templates — the serving plane replays them through ordinary command validation. */
+export interface ResolveRecommendationCommand extends CommandBase {
+    kind: 'ResolveRecommendation';
+    recommendationId: RecommendationId;
+    resolution: 'accepted' | 'rejected';
+    reason?: string;
+}
+export type CoordinationCommandV1 = SubmitEndeavorRequestCommand | AdoptEndeavorCommand | DeclineEndeavorRequestCommand | ReviseOutcomeCommand | ProposePlanCommand | AdoptPlanCommand | RejectPlanCommand | InviteParticipantCommand | AcceptParticipationCommand | WithdrawParticipationCommand | ProposeContributionCommand | AllocateContributionCommand | CommitContributionCommand | WithdrawCommitmentCommand | ReallocateContributionCommand | RecordStepSatisfiedCommand | RecordMilestoneAchievedCommand | SatisfyEndeavorCommand | AbandonEndeavorCommand | ProposeRecommendationCommand | ResolveRecommendationCommand;
+/** Every coordination command kind — the set `CoordinationCommandTemplate.kind` must name
+ *  (validated at ProposeRecommendation time: templates are typed, never free-form). */
+export declare const COORDINATION_COMMAND_KINDS: ReadonlySet<string>;
+export {};
+//# sourceMappingURL=commands.d.ts.map

package/dist/core/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/core/commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,UAAU,EACV,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC3G,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,KAAK,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAElG,UAAU,WAAW;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,4BAA6B,SAAQ,WAAW;IAC/D,IAAI,EAAE,uBAAuB,CAAC;IAC9B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,kBAAkB,CAAC;IAC/B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,aAAa,CAAC,EAAE,UAAU,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,kBAAkB,EAAE,CAAA;KAAE,CAAC;IAC/D,qBAAqB,EAAE,KAAK,CAAC;QAC3B,eAAe,EAAE,eAAe,CAAC;QACjC,WAAW,EAAE,OAAO,CAAC;QACrB,IAAI,EAAE,iBAAiB,CAAC;KACzB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,6BAA8B,SAAQ,WAAW;IAChE,IAAI,EAAE,wBAAwB,CAAC;IAC/B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,IAAI,EAAE,eAAe,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,kBAAkB,EAAE,CAAA;KAAE,CAAC;CAChE;AAED,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAyB,SAAQ,WAAW;IAC3D,IAAI,EAAE,mBAAmB,CAAC;IAC1B,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,EAAE,eAAe,CAAC;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,0BAA2B,SAAQ,WAAW;IAC7D,IAAI,EAAE,qBAAqB,CAAC;IAC5B,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,4BAA6B,SAAQ,WAAW;IAC/D,IAAI,EAAE,uBAAuB,CAAC;IAC9B,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,0BAA2B,SAAQ,WAAW;IAC7D,IAAI,EAAE,qBAAqB,CAAC;IAC5B,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,2BAA4B,SAAQ,WAAW;IAC9D,IAAI,EAAE,sBAAsB,CAAC;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,UAAU,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,yBAA0B,SAAQ,WAAW;IAC5D,IAAI,EAAE,oBAAoB,CAAC;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,YAAY,CAAC;IAC5B,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC;CAC/D;AAED,MAAM,WAAW,yBAA0B,SAAQ,WAAW;IAC5D,IAAI,EAAE,oBAAoB,CAAC;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,6BAA8B,SAAQ,WAAW;IAChE,IAAI,EAAE,wBAAwB,CAAC;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,0BAA2B,SAAQ,WAAW;IAC7D,IAAI,EAAE,qBAAqB,CAAC;IAC5B,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,SAAS,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,8BAA+B,SAAQ,WAAW;IACjE,IAAI,EAAE,yBAAyB,CAAC;IAChC,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,SAAS,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,IAAI,EAAE,iBAAiB,CAAC;IACxB,UAAU,EAAE,UAAU,CAAC;IACvB,oBAAoB,EAAE,SAAS,CAAC;CACjC;AAED,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,IAAI,EAAE,iBAAiB,CAAC;IACxB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,2FAA2F;AAC3F,MAAM,WAAW,4BAA6B,SAAQ,WAAW;IAC/D,IAAI,EAAE,uBAAuB,CAAC;IAC9B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,OAAO,EAAE,uBAAuB,CAAC;IACjC,4EAA4E;IAC5E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,2BAA2B,EAAE,CAAC;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;CAC5B;AAED;sFACsF;AACtF,MAAM,WAAW,4BAA6B,SAAQ,WAAW;IAC/D,IAAI,EAAE,uBAAuB,CAAC;IAC9B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,qBAAqB,GAC7B,4BAA4B,GAC5B,oBAAoB,GACpB,6BAA6B,GAC7B,oBAAoB,GACpB,kBAAkB,GAClB,gBAAgB,GAChB,iBAAiB,GACjB,wBAAwB,GACxB,0BAA0B,GAC1B,4BAA4B,GAC5B,0BAA0B,GAC1B,2BAA2B,GAC3B,yBAAyB,GACzB,yBAAyB,GACzB,6BAA6B,GAC7B,0BAA0B,GAC1B,8BAA8B,GAC9B,sBAAsB,GACtB,sBAAsB,GACtB,4BAA4B,GAC5B,4BAA4B,CAAC;AAEjC;uFACuF;AACvF,eAAO,MAAM,0BAA0B,EAAE,WAAW,CAAC,MAAM,CAsBzD,CAAC"}

package/dist/core/commands.js

@@ -0,0 +1,26 @@
+/** Every coordination command kind — the set `CoordinationCommandTemplate.kind` must name
+ *  (validated at ProposeRecommendation time: templates are typed, never free-form). */
+export const COORDINATION_COMMAND_KINDS = new Set([
+    'SubmitEndeavorRequest',
+    'AdoptEndeavor',
+    'DeclineEndeavorRequest',
+    'ReviseOutcome',
+    'ProposePlan',
+    'AdoptPlan',
+    'RejectPlan',
+    'InviteParticipant',
+    'AcceptParticipation',
+    'WithdrawParticipation',
+    'ProposeContribution',
+    'AllocateContribution',
+    'CommitContribution',
+    'WithdrawCommitment',
+    'ReallocateContribution',
+    'RecordStepSatisfied',
+    'RecordMilestoneAchieved',
+    'SatisfyEndeavor',
+    'AbandonEndeavor',
+    'ProposeRecommendation',
+    'ResolveRecommendation',
+]);
+//# sourceMappingURL=commands.js.map

package/dist/core/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/core/commands.ts"],"names":[],"mappings":"AA4NA;uFACuF;AACvF,MAAM,CAAC,MAAM,0BAA0B,GAAwB,IAAI,GAAG,CAAgC;IACpG,uBAAuB;IACvB,eAAe;IACf,wBAAwB;IACxB,eAAe;IACf,aAAa;IACb,WAAW;IACX,YAAY;IACZ,mBAAmB;IACnB,qBAAqB;IACrB,uBAAuB;IACvB,qBAAqB;IACrB,sBAAsB;IACtB,oBAAoB;IACpB,oBAAoB;IACpB,wBAAwB;IACxB,qBAAqB;IACrB,yBAAyB;IACzB,iBAAiB;IACjB,iBAAiB;IACjB,uBAAuB;IACvB,uBAAuB;CACxB,CAAC,CAAC"}

package/dist/core/events.d.ts

@@ -0,0 +1,163 @@
+import type { Address, Hex32 } from '@agenticprimitives/types';
+import type { EntityRef, SituationId } from '@agenticprimitives/situations';
+import type { AllocationId, CommitmentId, CoordinationPlanId, EndeavorId, EndeavorRequestId, ParticipationId, PlanStepId, ProposalId, RecommendationId } from './ids.js';
+import type { EndeavorRequestV1, OutcomeSpecificationV1 } from './types.js';
+import type { RecommendationV1 } from '../decisions/types.js';
+import type { MilestoneDefinitionV1, PlanEdgeV1, PlanRevisionRef, PlanStepV1 } from '../planning/types.js';
+import type { ParticipationRole, SignedPayloadRef } from '../participation/types.js';
+interface EventBase {
+    eventId: string;
+    occurredAt: string;
+    revision: number;
+}
+interface EndeavorEventBase extends EventBase {
+    endeavorId: EndeavorId;
+}
+export interface EndeavorRequestSubmittedEvent extends EventBase {
+    kind: 'EndeavorRequestSubmitted';
+    requestId: EndeavorRequestId;
+    request: EndeavorRequestV1;
+}
+export interface EndeavorRequestDeclinedEvent extends EventBase {
+    kind: 'EndeavorRequestDeclined';
+    requestId: EndeavorRequestId;
+    declinedBy: Address;
+    reason: string;
+}
+export interface EndeavorAdoptedEvent extends EndeavorEventBase {
+    kind: 'EndeavorAdopted';
+    requestId: EndeavorRequestId;
+    managingPrincipal: Address;
+    situationId: SituationId;
+    title: string;
+    outcome: OutcomeSpecificationV1;
+}
+export interface OutcomeRevisedEvent extends EndeavorEventBase {
+    kind: 'OutcomeRevised';
+    outcome: OutcomeSpecificationV1;
+}
+export interface PlanProposedEvent extends EndeavorEventBase {
+    kind: 'PlanProposed';
+    planId: CoordinationPlanId;
+    planRevision: number;
+    contentHash: Hex32;
+    steps: PlanStepV1[];
+    edges: PlanEdgeV1[];
+    milestones: MilestoneDefinitionV1[];
+    proposedBy: Address;
+}
+export interface PlanAdoptedEvent extends EndeavorEventBase {
+    kind: 'PlanAdopted';
+    planRef: PlanRevisionRef;
+    adoptedBy: Address;
+    supersededPlanRef?: PlanRevisionRef;
+}
+export interface PlanRejectedEvent extends EndeavorEventBase {
+    kind: 'PlanRejected';
+    planId: CoordinationPlanId;
+    planRevision: number;
+    rejectedBy: Address;
+    reason?: string;
+}
+export interface ParticipationInvitedEvent extends EndeavorEventBase {
+    kind: 'ParticipationInvited';
+    participationId: ParticipationId;
+    participant: Address;
+    role: ParticipationRole;
+    invitedBy: Address;
+    scope?: PlanStepId[];
+}
+export interface ParticipationAssertedEvent extends EndeavorEventBase {
+    kind: 'ParticipationAsserted';
+    participationId: ParticipationId;
+    participant: Address;
+    role: ParticipationRole;
+    assertedBy: 'invitation-acceptance' | 'allocation-commitment' | 'self-sponsor';
+    scope?: PlanStepId[];
+}
+export interface ParticipationWithdrawnEvent extends EndeavorEventBase {
+    kind: 'ParticipationWithdrawn';
+    participationId: ParticipationId;
+}
+export interface ContributionProposedEvent extends EndeavorEventBase {
+    kind: 'ContributionProposed';
+    proposalId: ProposalId;
+    proposer: Address;
+    planRef: PlanRevisionRef;
+    steps: PlanStepId[];
+    note?: string;
+}
+export interface ContributionAllocatedEvent extends EndeavorEventBase {
+    kind: 'ContributionAllocated';
+    allocationId: AllocationId;
+    proposalRef: ProposalId;
+    participant: Address;
+    steps: PlanStepId[];
+    decidedBy: Address;
+}
+export interface ContributionCommittedEvent extends EndeavorEventBase {
+    kind: 'ContributionCommitted';
+    commitmentId: CommitmentId;
+    allocationRef: AllocationId;
+    participant: Address;
+    planRef: PlanRevisionRef;
+    steps: PlanStepId[];
+    signature: SignedPayloadRef;
+    bounds?: {
+        deadline?: string;
+        effortEstimateRef?: EntityRef;
+    };
+}
+export interface CommitmentWithdrawnEvent extends EndeavorEventBase {
+    kind: 'CommitmentWithdrawn';
+    commitmentId: CommitmentId;
+    reason?: string;
+}
+export interface ContributionReallocatedEvent extends EndeavorEventBase {
+    kind: 'ContributionReallocated';
+    commitmentId: CommitmentId;
+    allocationId: AllocationId;
+    participant: Address;
+    decidedBy: Address;
+}
+export interface PlanStepSatisfiedEvent extends EndeavorEventBase {
+    kind: 'PlanStepSatisfied';
+    stepId: PlanStepId;
+    planRef: PlanRevisionRef;
+    evidenceRefs: EntityRef[];
+    recordedBy: Address;
+}
+export interface MilestoneAchievedEvent extends EndeavorEventBase {
+    kind: 'MilestoneAchieved';
+    milestoneId: string;
+    evidenceRefs: EntityRef[];
+    recordedBy: Address;
+}
+export interface EndeavorSatisfiedEvent extends EndeavorEventBase {
+    kind: 'EndeavorSatisfied';
+    outcomeValidationRef: EntityRef;
+}
+export interface EndeavorAbandonedEvent extends EndeavorEventBase {
+    kind: 'EndeavorAbandoned';
+    reason?: string;
+}
+export interface RecommendationProposedEvent extends EventBase {
+    kind: 'RecommendationProposed';
+    recommendationId: RecommendationId;
+    recommendation: RecommendationV1;
+}
+export interface RecommendationAcceptedEvent extends EventBase {
+    kind: 'RecommendationAccepted';
+    recommendationId: RecommendationId;
+    resolvedBy: Address;
+    reason?: string;
+}
+export interface RecommendationRejectedEvent extends EventBase {
+    kind: 'RecommendationRejected';
+    recommendationId: RecommendationId;
+    resolvedBy: Address;
+    reason?: string;
+}
+export type CoordinationEventV1 = EndeavorRequestSubmittedEvent | EndeavorRequestDeclinedEvent | EndeavorAdoptedEvent | OutcomeRevisedEvent | PlanProposedEvent | PlanAdoptedEvent | PlanRejectedEvent | ParticipationInvitedEvent | ParticipationAssertedEvent | ParticipationWithdrawnEvent | ContributionProposedEvent | ContributionAllocatedEvent | ContributionCommittedEvent | CommitmentWithdrawnEvent | ContributionReallocatedEvent | PlanStepSatisfiedEvent | MilestoneAchievedEvent | EndeavorSatisfiedEvent | EndeavorAbandonedEvent | RecommendationProposedEvent | RecommendationAcceptedEvent | RecommendationRejectedEvent;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/core/events.d.ts.map

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

package/dist/core/events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events.js.map

package/dist/core/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/core/events.ts"],"names":[],"mappings":""}

package/dist/core/ids.d.ts

@@ -0,0 +1,31 @@
+export type EndeavorId = `end_${string}`;
+export type EndeavorRequestId = `ereq_${string}`;
+export type CoordinationPlanId = `plan_${string}`;
+export type PlanStepId = `step_${string}`;
+export type ParticipationId = `part_${string}`;
+export type AllocationId = `alloc_${string}`;
+export type CommitmentId = `commit_${string}`;
+export type ProposalId = `prop_${string}`;
+export type RecommendationId = `rec_${string}`;
+export declare class CoordinationIdError extends Error {
+    constructor(expectedPrefix: string, value: string);
+}
+export declare const makeEndeavorId: (suffix: string) => EndeavorId;
+export declare const makeEndeavorRequestId: (suffix: string) => EndeavorRequestId;
+export declare const makeCoordinationPlanId: (suffix: string) => CoordinationPlanId;
+export declare const makePlanStepId: (suffix: string) => PlanStepId;
+export declare const makeParticipationId: (suffix: string) => ParticipationId;
+export declare const makeAllocationId: (suffix: string) => AllocationId;
+export declare const makeCommitmentId: (suffix: string) => CommitmentId;
+export declare const makeProposalId: (suffix: string) => ProposalId;
+export declare const makeRecommendationId: (suffix: string) => RecommendationId;
+export declare const assertEndeavorId: (value: string) => EndeavorId;
+export declare const assertEndeavorRequestId: (value: string) => EndeavorRequestId;
+export declare const assertCoordinationPlanId: (value: string) => CoordinationPlanId;
+export declare const assertPlanStepId: (value: string) => PlanStepId;
+export declare const assertParticipationId: (value: string) => ParticipationId;
+export declare const assertAllocationId: (value: string) => AllocationId;
+export declare const assertCommitmentId: (value: string) => CommitmentId;
+export declare const assertProposalId: (value: string) => ProposalId;
+export declare const assertRecommendationId: (value: string) => RecommendationId;
+//# sourceMappingURL=ids.d.ts.map

package/dist/core/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/core/ids.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,OAAO,MAAM,EAAE,CAAC;AACzC,MAAM,MAAM,iBAAiB,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjD,MAAM,MAAM,kBAAkB,GAAG,QAAQ,MAAM,EAAE,CAAC;AAClD,MAAM,MAAM,UAAU,GAAG,QAAQ,MAAM,EAAE,CAAC;AAC1C,MAAM,MAAM,eAAe,GAAG,QAAQ,MAAM,EAAE,CAAC;AAC/C,MAAM,MAAM,YAAY,GAAG,SAAS,MAAM,EAAE,CAAC;AAC7C,MAAM,MAAM,YAAY,GAAG,UAAU,MAAM,EAAE,CAAC;AAC9C,MAAM,MAAM,UAAU,GAAG,QAAQ,MAAM,EAAE,CAAC;AAC1C,MAAM,MAAM,gBAAgB,GAAG,OAAO,MAAM,EAAE,CAAC;AAE/C,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAGlD;AAcD,eAAO,MAAM,cAAc,WAAY,MAAM,KAAG,UAAkC,CAAC;AACnF,eAAO,MAAM,qBAAqB,WAAY,MAAM,KAAG,iBAA0C,CAAC;AAClG,eAAO,MAAM,sBAAsB,WAAY,MAAM,KAAG,kBAA2C,CAAC;AACpG,eAAO,MAAM,cAAc,WAAY,MAAM,KAAG,UAAmC,CAAC;AACpF,eAAO,MAAM,mBAAmB,WAAY,MAAM,KAAG,eAAwC,CAAC;AAC9F,eAAO,MAAM,gBAAgB,WAAY,MAAM,KAAG,YAAsC,CAAC;AACzF,eAAO,MAAM,gBAAgB,WAAY,MAAM,KAAG,YAAuC,CAAC;AAC1F,eAAO,MAAM,cAAc,WAAY,MAAM,KAAG,UAAmC,CAAC;AACpF,eAAO,MAAM,oBAAoB,WAAY,MAAM,KAAG,gBAAwC,CAAC;AAE/F,eAAO,MAAM,gBAAgB,UAAW,MAAM,KAAG,UAAmC,CAAC;AACrF,eAAO,MAAM,uBAAuB,UAAW,MAAM,KAAG,iBAA2C,CAAC;AACpG,eAAO,MAAM,wBAAwB,UAAW,MAAM,KAAG,kBAA4C,CAAC;AACtG,eAAO,MAAM,gBAAgB,UAAW,MAAM,KAAG,UAAoC,CAAC;AACtF,eAAO,MAAM,qBAAqB,UAAW,MAAM,KAAG,eAAyC,CAAC;AAChG,eAAO,MAAM,kBAAkB,UAAW,MAAM,KAAG,YAAuC,CAAC;AAC3F,eAAO,MAAM,kBAAkB,UAAW,MAAM,KAAG,YAAwC,CAAC;AAC5F,eAAO,MAAM,gBAAgB,UAAW,MAAM,KAAG,UAAoC,CAAC;AACtF,eAAO,MAAM,sBAAsB,UAAW,MAAM,KAAG,gBAAyC,CAAC"}

package/dist/core/ids.js

@@ -0,0 +1,36 @@
+// Branded coordination ids (spec 332 §5). Ids are supplied by commands — never generated here.
+export class CoordinationIdError extends Error {
+    constructor(expectedPrefix, value) {
+        super(`[coordination] expected id with prefix "${expectedPrefix}", got "${value}"`);
+    }
+}
+function make(prefix, suffix) {
+    if (suffix.length === 0)
+        throw new CoordinationIdError(prefix, suffix);
+    return `${prefix}${suffix}`;
+}
+function assert(prefix, value) {
+    if (!value.startsWith(prefix) || value.length <= prefix.length) {
+        throw new CoordinationIdError(prefix, value);
+    }
+    return value;
+}
+export const makeEndeavorId = (suffix) => make('end_', suffix);
+export const makeEndeavorRequestId = (suffix) => make('ereq_', suffix);
+export const makeCoordinationPlanId = (suffix) => make('plan_', suffix);
+export const makePlanStepId = (suffix) => make('step_', suffix);
+export const makeParticipationId = (suffix) => make('part_', suffix);
+export const makeAllocationId = (suffix) => make('alloc_', suffix);
+export const makeCommitmentId = (suffix) => make('commit_', suffix);
+export const makeProposalId = (suffix) => make('prop_', suffix);
+export const makeRecommendationId = (suffix) => make('rec_', suffix);
+export const assertEndeavorId = (value) => assert('end_', value);
+export const assertEndeavorRequestId = (value) => assert('ereq_', value);
+export const assertCoordinationPlanId = (value) => assert('plan_', value);
+export const assertPlanStepId = (value) => assert('step_', value);
+export const assertParticipationId = (value) => assert('part_', value);
+export const assertAllocationId = (value) => assert('alloc_', value);
+export const assertCommitmentId = (value) => assert('commit_', value);
+export const assertProposalId = (value) => assert('prop_', value);
+export const assertRecommendationId = (value) => assert('rec_', value);
+//# sourceMappingURL=ids.js.map

package/dist/core/ids.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,12 @@
+export type { AllocationId, CommitmentId, CoordinationPlanId, EndeavorId, EndeavorRequestId, ParticipationId, PlanStepId, ProposalId, RecommendationId, } from './ids.js';
+export { CoordinationIdError, assertAllocationId, assertCommitmentId, assertCoordinationPlanId, assertEndeavorId, assertEndeavorRequestId, assertParticipationId, assertPlanStepId, assertProposalId, assertRecommendationId, makeAllocationId, makeCommitmentId, makeCoordinationPlanId, makeEndeavorId, makeEndeavorRequestId, makeParticipationId, makePlanStepId, makeProposalId, makeRecommendationId, } from './ids.js';
+export type { ContextRef, CoordinationContextSnapshotV1, EndeavorEntryPoint, EndeavorLifecycle, EndeavorRelationKind, EndeavorRelationV1, EndeavorRequestV1, EndeavorV1, ExternalObjectBindingV1, ExternalSyncMode, OutcomeCriterionKind, OutcomeCriterionV1, OutcomeSpecificationV1, } from './types.js';
+export { COORDINATION_CLASS_IRIS } from './types.js';
+export type { CoordinationCommandV1 } from './commands.js';
+export { COORDINATION_COMMAND_KINDS } from './commands.js';
+export type { CoordinationEventV1 } from './events.js';
+export type { CommandValidationResult, CoordinationStateV1, EndeavorRequestStatus, SatisfiedStepV1, } from './reducer.js';
+export { CoordinationEventError, applyCoordinationEvent, initialCoordinationState, planKey, validateCoordinationCommand, } from './reducer.js';
+export type { ProvenanceActivitySummary, ProvenanceCorrespondenceSummary, ProvenanceEntitySummary, ProvenanceInputsV1, } from './provenance.js';
+export { deriveProvenanceInputs } from './provenance.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,UAAU,EACV,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,UAAU,EACV,6BAA6B,EAC7B,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,YAAY,EACV,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,OAAO,EACP,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,yBAAyB,EACzB,+BAA+B,EAC/B,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,6 @@
+export { CoordinationIdError, assertAllocationId, assertCommitmentId, assertCoordinationPlanId, assertEndeavorId, assertEndeavorRequestId, assertParticipationId, assertPlanStepId, assertProposalId, assertRecommendationId, makeAllocationId, makeCommitmentId, makeCoordinationPlanId, makeEndeavorId, makeEndeavorRequestId, makeParticipationId, makePlanStepId, makeProposalId, makeRecommendationId, } from './ids.js';
+export { COORDINATION_CLASS_IRIS } from './types.js';
+export { COORDINATION_COMMAND_KINDS } from './commands.js';
+export { CoordinationEventError, applyCoordinationEvent, initialCoordinationState, planKey, validateCoordinationCommand, } from './reducer.js';
+export { deriveProvenanceInputs } from './provenance.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAiBlB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAGrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAS3D,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,OAAO,EACP,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AAQtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/core/provenance.d.ts

@@ -0,0 +1,29 @@
+import type { CoordinationEventV1 } from './events.js';
+export interface ProvenanceEntitySummary {
+    id: string;
+    kind: string;
+    wasRevisionOf?: string;
+    generatedBy?: string;
+}
+export interface ProvenanceActivitySummary {
+    id: string;
+    kind: string;
+    agent?: string;
+    used?: string[];
+    generated?: string[];
+}
+export interface ProvenanceCorrespondenceSummary {
+    activityId: string;
+    planId: string;
+    planRevision: number;
+    planHash: string;
+    stepId: string;
+}
+export interface ProvenanceInputsV1 {
+    entities: ProvenanceEntitySummary[];
+    activities: ProvenanceActivitySummary[];
+    agents: string[];
+    correspondences: ProvenanceCorrespondenceSummary[];
+}
+export declare function deriveProvenanceInputs(events: CoordinationEventV1[]): ProvenanceInputsV1;
+//# sourceMappingURL=provenance.d.ts.map