@agenticprimitives/provenance 0.0.0-alpha.0 → 0.0.0-alpha.2

package/dist/endeavor.d.ts

@@ -0,0 +1,96 @@
+import type { AgentClass, ProvenanceRecordV1 } from './types.js';
+export interface EndeavorRequestInput {
+    requestId: string;
+    requester: string;
+    requesterClass?: AgentClass;
+    submittedAt: string;
+    /** home-request | discussion-ask | inbox-ask | a2a-intent — provenance of the door, never a model switch. */
+    entryPoint?: string;
+    /** Vault ref / hash of the intake body — never inline plaintext. */
+    ref?: string;
+}
+export interface EndeavorPlanRevisionInput {
+    planId: string;
+    revision: number;
+    contentHash: string;
+    proposedBy: string;
+    proposedByClass?: AgentClass;
+    proposedAt: string;
+    status: 'proposed' | 'adopted' | 'superseded' | 'rejected';
+    adoptedBy?: string;
+    adoptedAt?: string;
+    /** apcoord:PlanStep ids + kinds, projected as p-plan:Steps of this revision. */
+    steps: Array<{
+        stepId: string;
+        kind: string;
+    }>;
+}
+export interface EndeavorStepExecutionInput {
+    activityId: string;
+    /** The DURABLE apcoord:PlanStep id (`p-plan:correspondsToStep`). */
+    stepId: string;
+    /** The EXACT adopted plan revision the execution ran under (`prov:hadPlan`). */
+    planId: string;
+    planRevision: number;
+    actor: string;
+    actorClass?: AgentClass;
+    /** The capacity the actor functioned in (`prov:hadRole`) — never a permission. */
+    role?: string;
+    startedAt: string;
+    endedAt?: string;
+    /** BY-HASH refs (delegation, entitlement, the CoordinationContextSnapshot) — `prov:used`. */
+    usedRefs?: string[];
+    /** PRIVATE — `prov:actedOnBehalfOf`. S1 firewall rejects it from any public row. */
+    onBehalfOf?: string;
+    /** Generated artifact refs (vault refs / hashes). The object form additionally carries
+     *  `prov:wasDerivedFrom` entity ids — e.g. a spec-329 synthesis artifact derived from each
+     *  member answer (spec 334 §4 door 2 re-expression of the consultation fan-out). */
+    artifactRefs?: Array<string | {
+        ref: string;
+        derivedFrom?: string[];
+    }>;
+    /** The RUN-SPECIFIC `apexec:ExecutionPlan` this step compiled into (ADR-0054 §3): emitted as an
+     *  ExecutionPlan entity `prov:wasDerivedFrom` the adopted revision, and the step gains
+     *  `ep-plan:isDecomposedAsPlan` → it. `ref` is the run plan's hash / vault ref. */
+    runPlan?: {
+        id: string;
+        ref?: string;
+    };
+    /** `ep-plan:FailedActivity` — the execution was interrupted; recorded, never dropped. */
+    failed?: boolean;
+}
+export interface EndeavorAttestationInput {
+    id: string;
+    /** apatt: outcome / validation / evidence — projected as Attestation entities. */
+    kind: 'outcome' | 'validation' | 'evidence';
+    ref?: string;
+    /** Contributing artifact ENTITY ids (`prov:wasDerivedFrom`). */
+    derivedFrom?: string[];
+}
+/** Structural projection input for one Endeavor (never the coordination package's types — leaf boundary). */
+export interface EndeavorProvenanceInput {
+    endeavorId: string;
+    managingPrincipal: string;
+    managingPrincipalClass?: AgentClass;
+    request?: EndeavorRequestInput;
+    adoption?: {
+        actor: string;
+        actorClass?: AgentClass;
+        at: string;
+    };
+    outcome?: {
+        specId: string;
+        ref?: string;
+    };
+    planRevisions: EndeavorPlanRevisionInput[];
+    executions: EndeavorStepExecutionInput[];
+    attestations?: EndeavorAttestationInput[];
+}
+/**
+ * Project one Endeavor's whole coordination process into the private PROV-O / P-Plan A-box:
+ * who (agents), did what (activities), on what (`prov:used`, by hash), producing what
+ * (`prov:generated`), under WHICH plan step and revision (`p-plan:correspondsToStep` +
+ * `prov:hadPlan`) — the reconstructable trace ADR-0054 requires.
+ */
+export declare function projectEndeavorProvenance(input: EndeavorProvenanceInput): ProvenanceRecordV1;
+//# sourceMappingURL=endeavor.d.ts.map

package/dist/endeavor.d.ts.map

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

package/dist/endeavor.js

@@ -0,0 +1,159 @@
+const planEntityId = (endeavorId, planId, revision) => `ent:${endeavorId}:plan:${planId}:rev:${revision}`;
+/**
+ * Project one Endeavor's whole coordination process into the private PROV-O / P-Plan A-box:
+ * who (agents), did what (activities), on what (`prov:used`, by hash), producing what
+ * (`prov:generated`), under WHICH plan step and revision (`p-plan:correspondsToStep` +
+ * `prov:hadPlan`) — the reconstructable trace ADR-0054 requires.
+ */
+export function projectEndeavorProvenance(input) {
+    const agents = new Map();
+    const addAgent = (id, agentClass) => {
+        if (!agents.has(id.toLowerCase()))
+            agents.set(id.toLowerCase(), { id, agentClass: agentClass ?? 'service' });
+    };
+    addAgent(input.managingPrincipal, input.managingPrincipalClass);
+    const activities = [];
+    const entities = [];
+    const plans = [];
+    // Intake: the request entity, attributed to the requester.
+    const requestEntityId = input.request ? `ent:${input.endeavorId}:request:${input.request.requestId}` : undefined;
+    if (input.request && requestEntityId) {
+        addAgent(input.request.requester, input.request.requesterClass);
+        entities.push({ id: requestEntityId, type: 'EndeavorRequest', ref: input.request.ref });
+    }
+    // Adoption: the activity that used the request and generated the outcome specification.
+    const outcomeEntityId = input.outcome ? `ent:${input.endeavorId}:outcome:${input.outcome.specId}` : undefined;
+    if (input.adoption) {
+        addAgent(input.adoption.actor, input.adoption.actorClass);
+        activities.push({
+            id: `act:${input.endeavorId}:adoption`,
+            type: 'EndeavorAdoption',
+            tier: 'execution-orchestrated',
+            startedAt: input.adoption.at,
+            endedAt: input.adoption.at,
+            wasAssociatedWith: input.adoption.actor,
+            used: requestEntityId ? [requestEntityId] : [],
+            generated: outcomeEntityId ? [outcomeEntityId] : [],
+        });
+    }
+    if (input.outcome && outcomeEntityId) {
+        entities.push({
+            id: outcomeEntityId,
+            type: 'OutcomeSpecification',
+            wasGeneratedBy: input.adoption ? `act:${input.endeavorId}:adoption` : undefined,
+            ref: input.outcome.ref,
+        });
+    }
+    // Plan revisions: entities chained by prov:wasRevisionOf, each with its proposal (and adoption) activity,
+    // plus the P-Plan projection of the ADOPTED revision's steps.
+    const sorted = [...input.planRevisions].sort((a, b) => a.revision - b.revision);
+    let priorRevisionEntity;
+    for (const rev of sorted) {
+        const entityId = planEntityId(input.endeavorId, rev.planId, rev.revision);
+        const proposalActivityId = `act:${input.endeavorId}:plan:${rev.planId}:rev:${rev.revision}:proposed`;
+        addAgent(rev.proposedBy, rev.proposedByClass);
+        activities.push({
+            id: proposalActivityId,
+            type: 'PlanProposal',
+            tier: 'execution-orchestrated',
+            startedAt: rev.proposedAt,
+            endedAt: rev.proposedAt,
+            wasAssociatedWith: rev.proposedBy,
+            used: priorRevisionEntity ? [priorRevisionEntity] : [],
+            generated: [entityId],
+        });
+        entities.push({
+            id: entityId,
+            type: 'PlanRevision',
+            wasGeneratedBy: proposalActivityId,
+            ref: rev.contentHash,
+            wasRevisionOf: priorRevisionEntity,
+        });
+        if (rev.status === 'adopted' || rev.status === 'superseded') {
+            const adopter = rev.adoptedBy ?? input.managingPrincipal;
+            addAgent(adopter);
+            activities.push({
+                id: `act:${input.endeavorId}:plan:${rev.planId}:rev:${rev.revision}:adopted`,
+                type: 'PlanAdoption',
+                tier: 'execution-orchestrated',
+                startedAt: rev.adoptedAt ?? rev.proposedAt,
+                endedAt: rev.adoptedAt ?? rev.proposedAt,
+                wasAssociatedWith: adopter,
+                used: [entityId],
+                generated: [],
+            });
+            plans.push({
+                id: entityId,
+                steps: rev.steps.map((s) => ({ id: s.stepId, toolId: s.kind, isStepOfPlan: entityId })),
+            });
+        }
+        priorRevisionEntity = entityId;
+    }
+    // Per-step executions: correspondsToStep + qualified association (hadPlan = the exact revision entity).
+    for (const exec of input.executions) {
+        addAgent(exec.actor, exec.actorClass);
+        const revisionEntityId = planEntityId(input.endeavorId, exec.planId, exec.planRevision);
+        const artifactEntityIds = (exec.artifactRefs ?? []).map((raw, i) => {
+            const artifact = typeof raw === 'string' ? { ref: raw } : raw;
+            const id = `ent:${input.endeavorId}:artifact:${exec.activityId}:${i}`;
+            entities.push({
+                id,
+                type: 'Artifact',
+                wasGeneratedBy: `act:${exec.activityId}`,
+                ref: artifact.ref,
+                ...(artifact.derivedFrom?.length ? { wasDerivedFrom: artifact.derivedFrom } : {}),
+            });
+            return id;
+        });
+        // The compile bridge, both names (ADR-0054 §3): the run ExecutionPlan entity is
+        // prov:wasDerivedFrom the adopted revision, and the durable step gains
+        // ep-plan:isDecomposedAsPlan → it.
+        if (exec.runPlan) {
+            const runPlanEntityId = `ent:${input.endeavorId}:runplan:${exec.runPlan.id}`;
+            entities.push({
+                id: runPlanEntityId,
+                type: 'ExecutionPlan',
+                ref: exec.runPlan.ref,
+                wasDerivedFrom: [revisionEntityId],
+            });
+            const adoptedPlan = plans.find((p) => p.id === revisionEntityId);
+            const step = adoptedPlan?.steps.find((s) => s.id === exec.stepId);
+            if (step)
+                step.isDecomposedAsPlan = runPlanEntityId;
+        }
+        activities.push({
+            id: `act:${exec.activityId}`,
+            type: 'StepExecution',
+            tier: 'execution-orchestrated',
+            startedAt: exec.startedAt,
+            endedAt: exec.endedAt,
+            wasAssociatedWith: exec.actor,
+            used: exec.usedRefs ?? [],
+            onBehalfOf: exec.onBehalfOf,
+            generated: artifactEntityIds,
+            correspondsToStep: exec.stepId,
+            hadPlan: revisionEntityId,
+            hadRole: exec.role,
+            ...(exec.failed ? { failed: true } : {}),
+        });
+    }
+    // Outcome / validation attestations derive from the contributing artifacts.
+    for (const att of input.attestations ?? []) {
+        entities.push({
+            id: `ent:${input.endeavorId}:attestation:${att.id}`,
+            type: 'Attestation',
+            ref: att.ref,
+            wasDerivedFrom: att.derivedFrom,
+        });
+    }
+    return {
+        version: 'ap.provenance.v1',
+        agents: [...agents.values()],
+        activities,
+        entities,
+        plans,
+        // One Endeavor = one ep-plan:ExecutionTraceBundle; everything above is a hasTraceElement member.
+        bundle: { id: `bundle:${input.endeavorId}` },
+    };
+}
+//# sourceMappingURL=endeavor.js.map

package/dist/endeavor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endeavor.js","sourceRoot":"","sources":["../src/endeavor.ts"],"names":[],"mappings":"AA+FA,MAAM,YAAY,GAAG,CAAC,UAAkB,EAAE,MAAc,EAAE,QAAgB,EAAU,EAAE,CACpF,OAAO,UAAU,SAAS,MAAM,QAAQ,QAAQ,EAAE,CAAC;AAErD;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAA8B;IACtE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC/C,MAAM,QAAQ,GAAG,CAAC,EAAU,EAAE,UAAuB,EAAQ,EAAE;QAC7D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,UAAU,IAAI,SAAS,EAAE,CAAC,CAAC;IAC/G,CAAC,CAAC;IACF,QAAQ,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAEhE,MAAM,UAAU,GAAmB,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,2DAA2D;IAC3D,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,UAAU,YAAY,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACjH,IAAI,KAAK,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC;QACrC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAChE,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,wFAAwF;IACxF,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,UAAU,YAAY,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9G,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC1D,UAAU,CAAC,IAAI,CAAC;YACd,EAAE,EAAE,OAAO,KAAK,CAAC,UAAU,WAAW;YACtC,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,wBAAwB;YAC9B,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE;YAC5B,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE;YAC1B,iBAAiB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK;YACvC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE;YAC9C,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE;SACpD,CAAC,CAAC;IACL,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC;YACZ,EAAE,EAAE,eAAe;YACnB,IAAI,EAAE,sBAAsB;YAC5B,cAAc,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,UAAU,WAAW,CAAC,CAAC,CAAC,SAAS;YAC/E,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG;SACvB,CAAC,CAAC;IACL,CAAC;IAED,0GAA0G;IAC1G,8DAA8D;IAC9D,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAChF,IAAI,mBAAuC,CAAC;IAC5C,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1E,MAAM,kBAAkB,GAAG,OAAO,KAAK,CAAC,UAAU,SAAS,GAAG,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAQ,WAAW,CAAC;QACrG,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC;QAC9C,UAAU,CAAC,IAAI,CAAC;YACd,EAAE,EAAE,kBAAkB;YACtB,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,wBAAwB;YAC9B,SAAS,EAAE,GAAG,CAAC,UAAU;YACzB,OAAO,EAAE,GAAG,CAAC,UAAU;YACvB,iBAAiB,EAAE,GAAG,CAAC,UAAU;YACjC,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAAE;YACtD,SAAS,EAAE,CAAC,QAAQ,CAAC;SACtB,CAAC,CAAC;QACH,QAAQ,CAAC,IAAI,CAAC;YACZ,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,cAAc;YACpB,cAAc,EAAE,kBAAkB;YAClC,GAAG,EAAE,GAAG,CAAC,WAAW;YACpB,aAAa,EAAE,mBAAmB;SACnC,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YAC5D,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,IAAI,KAAK,CAAC,iBAAiB,CAAC;YACzD,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClB,UAAU,CAAC,IAAI,CAAC;gBACd,EAAE,EAAE,OAAO,KAAK,CAAC,UAAU,SAAS,GAAG,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAQ,UAAU;gBAC5E,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,wBAAwB;gBAC9B,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,UAAU;gBAC1C,OAAO,EAAE,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,UAAU;gBACxC,iBAAiB,EAAE,OAAO;gBAC1B,IAAI,EAAE,CAAC,QAAQ,CAAC;gBAChB,SAAS,EAAE,EAAE;aACd,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,QAAQ;gBACZ,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC;aACxF,CAAC,CAAC;QACL,CAAC;QACD,mBAAmB,GAAG,QAAQ,CAAC;IACjC,CAAC;IAED,wGAAwG;IACxG,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,gBAAgB,GAAG,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACxF,MAAM,iBAAiB,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACjE,MAAM,QAAQ,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YAC9D,MAAM,EAAE,GAAG,OAAO,KAAK,CAAC,UAAU,aAAa,IAAI,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;YACtE,QAAQ,CAAC,IAAI,CAAC;gBACZ,EAAE;gBACF,IAAI,EAAE,UAAU;gBAChB,cAAc,EAAE,OAAO,IAAI,CAAC,UAAU,EAAE;gBACxC,GAAG,EAAE,QAAQ,CAAC,GAAG;gBACjB,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAClF,CAAC,CAAC;YACH,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;QACH,gFAAgF;QAChF,uEAAuE;QACvE,mCAAmC;QACnC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,eAAe,GAAG,OAAO,KAAK,CAAC,UAAU,YAAY,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YAC7E,QAAQ,CAAC,IAAI,CAAC;gBACZ,EAAE,EAAE,eAAe;gBACnB,IAAI,EAAE,eAAe;gBACrB,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG;gBACrB,cAAc,EAAE,CAAC,gBAAgB,CAAC;aACnC,CAAC,CAAC;YACH,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,gBAAgB,CAAC,CAAC;YACjE,MAAM,IAAI,GAAG,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;YAClE,IAAI,IAAI;gBAAE,IAAI,CAAC,kBAAkB,GAAG,eAAe,CAAC;QACtD,CAAC;QACD,UAAU,CAAC,IAAI,CAAC;YACd,EAAE,EAAE,OAAO,IAAI,CAAC,UAAU,EAAE;YAC5B,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,wBAAwB;YAC9B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,iBAAiB,EAAE,IAAI,CAAC,KAAK;YAC7B,IAAI,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS,EAAE,iBAAiB;YAC5B,iBAAiB,EAAE,IAAI,CAAC,MAAM;YAC9B,OAAO,EAAE,gBAAgB;YACzB,OAAO,EAAE,IAAI,CAAC,IAAI;YAClB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzC,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC;YACZ,EAAE,EAAE,OAAO,KAAK,CAAC,UAAU,gBAAgB,GAAG,CAAC,EAAE,EAAE;YACnD,IAAI,EAAE,aAAa;YACnB,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,cAAc,EAAE,GAAG,CAAC,WAAW;SAChC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,OAAO,EAAE,kBAAkB;QAC3B,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC5B,UAAU;QACV,QAAQ;QACR,KAAK;QACL,iGAAiG;QACjG,MAAM,EAAE,EAAE,EAAE,EAAE,UAAU,KAAK,CAAC,UAAU,EAAE,EAAE;KAC7C,CAAC;AACJ,CAAC"}

package/dist/firewall.d.ts

@@ -7,7 +7,7 @@ export interface PublicProvenanceRow {
     anchoredBy?: string;
     /** REQUIRED: the assurance floor — must be `OnchainConfirmed`. */
     assurance?: string;
-    /** `prov:actedOnBehalfOf` / `apfab:onBehalfOf` edges — MUST be empty for a public row. */
+    /** `prov:actedOnBehalfOf` / `apvr:onBehalfOf` edges — MUST be empty for a public row. */
     actedOnBehalfOf?: string[];
     /** `prov:wasAttributedTo` agent classes — MUST NOT include `person`. */
     attributedToClasses?: AgentClass[];

package/dist/firewall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"firewall.d.ts","sourceRoot":"","sources":["../src/firewall.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,+GAA+G;IAC/G,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,wEAAwE;IACxE,mBAAmB,CAAC,EAAE,UAAU,EAAE,CAAC;IACnC,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,MAAM,cAAc,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAgC1E,2FAA2F;AAC3F,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,mBAAmB,GAAG,cAAc,CAY/E;AAED,gHAAgH;AAChH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,CAGzE"}
+{"version":3,"file":"firewall.d.ts","sourceRoot":"","sources":["../src/firewall.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,+GAA+G;IAC/G,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,wEAAwE;IACxE,mBAAmB,CAAC,EAAE,UAAU,EAAE,CAAC;IACnC,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,MAAM,cAAc,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAgC1E,2FAA2F;AAC3F,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,mBAAmB,GAAG,cAAc,CAY/E;AAED,gHAAgH;AAChH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,CAGzE"}

package/dist/harness.d.ts

@@ -0,0 +1,124 @@
+import type { AgentClass, ProvenanceRecordV1 } from './types.js';
+/** The IRI the discovery indexer gives a Smart Agent in the public KB (`urn:ap:agent:eip155:<chain>:<sa>`),
+ *  used here so a private run graph and the public graph name the SAME node — joinable by a reader who holds
+ *  both, never joined inside an engine (spec 356/357). Without a chain id the agent is named by address alone. */
+export declare function agentIri(address: string, chainId?: number): string;
+/** One step of the view (the shape `orchestration.provenanceOf` produces per step). */
+export interface HarnessStepView {
+    stepRef: string;
+    toolId: string;
+    capability?: {
+        id: string;
+        action: string;
+    };
+    risk?: string;
+    status: string;
+    startedAt?: string;
+    endedAt?: string;
+    authority?: {
+        presentedRef: string | null;
+        decision: string;
+        afterApproval: boolean;
+        chain?: {
+            accountabilityRoot: string;
+            actingAgent: string;
+            depth: number;
+            chainDigest: string;
+            links: Array<{
+                ref: string;
+                delegator: string;
+                delegate: string;
+                parentRef: string | null;
+            }>;
+        };
+    };
+    actor?: {
+        rootPrincipal?: string;
+        originatingAgent?: string;
+        actingAgent: string;
+    };
+    receiptDigest?: string;
+    inputDigest?: string;
+    outputDigest?: string;
+    txHash?: string;
+    delegatedTo?: string;
+    delegatedToRun?: string;
+    effects?: Array<{
+        produces: string;
+        ok: boolean;
+    }>;
+    decisions?: Array<{
+        point: string;
+        ruleId: string;
+    }>;
+    errorClass?: string;
+    /** Spec 390 — the span this step's activity is. */
+    spanId?: string;
+    /** Spec 391 — the step's raw result was offloaded to the acting agent's vault: where, how big, its digest. */
+    artifact?: {
+        recordType: string;
+        digest: string;
+        bytes: number;
+    };
+}
+/** The whole view — `RunProvenanceV1` from `@agenticprimitives/orchestration`, restated structurally. */
+export interface HarnessRunProvenanceInput {
+    runRef: string;
+    /** ISO — when the run ended. */
+    endedAt: string;
+    /** The agent the run ran at: whose authority was spent, whose vault the record lives in. An address. */
+    agent: string;
+    agentClass?: AgentClass;
+    asker?: string;
+    askerClass?: AgentClass;
+    intentDigest?: string;
+    outcome: string;
+    playbook?: {
+        skillId: string;
+        version: string;
+        commitment: string;
+    };
+    /** Spec 367 §8 — the request this run answered (a routed or handed-off run): the sender's run and step. */
+    inResponseTo?: {
+        agent: string;
+        runRef: string;
+        stepRef?: string;
+    };
+    steps: HarnessStepView[];
+    /** The chain the agents live on — names them the way the public KB does. */
+    chainId?: number;
+    /** Spec 390 — the trace the run's spans belong to, and the run's root span. */
+    traceId?: string;
+    spanId?: string;
+}
+/** Ids are derived from run and step references, so the same record is the same graph. */
+export declare const harnessIds: {
+    run: (runRef: string) => string;
+    bundle: (runRef: string) => string;
+    step: (runRef: string, stepRef: string) => string;
+    plan: (runRef: string) => string;
+    planStep: (runRef: string, stepRef: string) => string;
+    playbook: (p: {
+        skillId: string;
+        version: string;
+        commitment: string;
+    }) => string;
+    runtime: (agentIriValue: string) => string;
+    mandate: (ref: string) => string;
+    receipt: (digest: string) => string;
+    tx: (hash: string) => string;
+    effect: (runRef: string, stepRef: string, produces: string) => string;
+    decision: (runRef: string, stepRef: string, point: string) => string;
+    actor: (runRef: string, stepRef: string) => string;
+    artifact: (runRef: string, stepRef: string) => string;
+};
+/**
+ * Project a harness run into the private A-box: the runtime `actedOnBehalfOf` the agent; the run
+ * (`ServiceExecution`) associated with the runtime under its ExecutionPlan and — when a playbook shaped it —
+ * with the agent under that playbook; one activity per step that `usedDelegation` its mandate, `used` every
+ * chain link by reference, `generated` its receipt, its transaction, its effects and its decisions, and ended
+ * in a named completion state; a P-Plan with `isPrecededBy` order; one bundle, `wasInformedBy` the sender's
+ * when this run answered another.
+ */
+export declare function projectHarnessRunProvenance(input: HarnessRunProvenanceInput): ProvenanceRecordV1;
+//# sourceMappingURL=harness.d.ts.map

package/dist/harness.d.ts.map

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

package/dist/harness.js

@@ -0,0 +1,163 @@
+/** The IRI the discovery indexer gives a Smart Agent in the public KB (`urn:ap:agent:eip155:<chain>:<sa>`),
+ *  used here so a private run graph and the public graph name the SAME node — joinable by a reader who holds
+ *  both, never joined inside an engine (spec 356/357). Without a chain id the agent is named by address alone. */
+export function agentIri(address, chainId) {
+    const a = address.toLowerCase();
+    return chainId ? `urn:ap:agent:eip155:${chainId}:${a}` : `urn:ap:agent:${a}`;
+}
+const COMPLETION = {
+    completed: 'Completed', executed: 'Completed', failed: 'Failed', refused: 'Refused', denied: 'Refused',
+    skipped: 'Skipped', suspended: 'Suspended',
+};
+const completionOf = (status) => COMPLETION[status] ?? 'Failed';
+/** Ids are derived from run and step references, so the same record is the same graph. */
+export const harnessIds = {
+    run: (runRef) => `act:${runRef}`,
+    bundle: (runRef) => `bundle:${runRef}`,
+    step: (runRef, stepRef) => `act:${runRef}:${stepRef}`,
+    plan: (runRef) => `plan:${runRef}`,
+    planStep: (runRef, stepRef) => `plan:${runRef}:step:${stepRef}`,
+    playbook: (p) => `playbook:${p.skillId}@${p.version}#${p.commitment}`,
+    runtime: (agentIriValue) => `runtime:${agentIriValue}`,
+    mandate: (ref) => `mandate:${ref}`,
+    receipt: (digest) => `receipt:${digest}`,
+    tx: (hash) => `tx:${hash}`,
+    effect: (runRef, stepRef, produces) => `effect:${runRef}:${stepRef}:${produces}`,
+    decision: (runRef, stepRef, point) => `decision:${runRef}:${stepRef}:${point}`,
+    actor: (runRef, stepRef) => `actor:${runRef}:${stepRef}`,
+    artifact: (runRef, stepRef) => `artifact:${runRef}:${stepRef}`,
+};
+/**
+ * Project a harness run into the private A-box: the runtime `actedOnBehalfOf` the agent; the run
+ * (`ServiceExecution`) associated with the runtime under its ExecutionPlan and — when a playbook shaped it —
+ * with the agent under that playbook; one activity per step that `usedDelegation` its mandate, `used` every
+ * chain link by reference, `generated` its receipt, its transaction, its effects and its decisions, and ended
+ * in a named completion state; a P-Plan with `isPrecededBy` order; one bundle, `wasInformedBy` the sender's
+ * when this run answered another.
+ */
+export function projectHarnessRunProvenance(input) {
+    const ids = harnessIds;
+    const agentId = agentIri(input.agent, input.chainId);
+    const runtimeId = ids.runtime(agentId);
+    const runId = ids.run(input.runRef);
+    const planId = ids.plan(input.runRef);
+    const bundleId = ids.bundle(input.runRef);
+    const agents = new Map();
+    const agent = (id, agentClass) => {
+        if (!agents.has(id))
+            agents.set(id, { id, ...(agentClass ? { agentClass } : {}) });
+        return id;
+    };
+    agent(agentId, input.agentClass);
+    agents.set(runtimeId, { id: runtimeId, kind: 'AgentRuntime', actedOnBehalfOf: agentId });
+    const askerId = input.asker ? agent(agentIri(input.asker, input.chainId), input.askerClass) : undefined;
+    const entities = [];
+    const entity = (e) => { if (!entities.some((x) => x.id === e.id))
+        entities.push(e); return e.id; };
+    // The plans: the run's own ExecutionPlan (what the planner proposed and the executor received), and the
+    // playbook that shaped it (the procedure, pinned by its content commitment).
+    const plans = [{
+            id: planId, kind: 'ExecutionPlan',
+            steps: input.steps.map((s, i) => ({
+                id: ids.planStep(input.runRef, s.stepRef), toolId: s.toolId, isStepOfPlan: planId,
+                ...(i > 0 ? { isPrecededBy: ids.planStep(input.runRef, input.steps[i - 1].stepRef) } : {}),
+            })),
+        }];
+    const playbookId = input.playbook ? ids.playbook(input.playbook) : undefined;
+    if (input.playbook && playbookId)
+        plans.push({ id: playbookId, kind: 'Playbook', steps: [], ref: input.playbook.commitment });
+    const activities = [];
+    const stepIds = [];
+    for (const s of input.steps) {
+        const stepId = ids.step(input.runRef, s.stepRef);
+        stepIds.push(stepId);
+        const used = [];
+        const generated = [];
+        let usedDelegation;
+        let accountabilityRoot;
+        if (s.authority?.presentedRef) {
+            usedDelegation = entity({ id: ids.mandate(s.authority.presentedRef), type: 'Delegation', ref: s.authority.presentedRef });
+        }
+        for (const link of s.authority?.chain?.links ?? []) {
+            const id = entity({ id: ids.mandate(link.ref), type: 'Delegation', ref: link.ref });
+            if (id !== usedDelegation)
+                used.push(id);
+        }
+        if (s.authority?.chain?.accountabilityRoot)
+            accountabilityRoot = agent(agentIri(s.authority.chain.accountabilityRoot, input.chainId));
+        if (s.receiptDigest)
+            generated.push(entity({ id: ids.receipt(s.receiptDigest), type: 'StepReceipt', wasGeneratedBy: stepId, ref: s.receiptDigest, wasAttributedTo: agentId }));
+        if (s.txHash)
+            generated.push(entity({ id: ids.tx(s.txHash), type: 'ChainTransaction', wasGeneratedBy: stepId, ref: s.txHash }));
+        for (const e of s.effects ?? [])
+            generated.push(entity({ id: ids.effect(input.runRef, s.stepRef, e.produces), type: 'Effect', wasGeneratedBy: stepId, effectProduces: e.produces, effectSucceeded: e.ok }));
+        for (const d of s.decisions ?? [])
+            generated.push(entity({ id: ids.decision(input.runRef, s.stepRef, d.point), type: 'DecisionRecord', wasGeneratedBy: stepId, decisionPoint: d.point, decisionRule: d.ruleId }));
+        if (s.artifact)
+            generated.push(entity({ id: ids.artifact(input.runRef, s.stepRef), type: 'RunArtifact', wasGeneratedBy: stepId, ref: s.artifact.recordType, wasAttributedTo: agentId, artifactBytes: s.artifact.bytes, artifactDigest: s.artifact.digest }));
+        let actorContext;
+        if (s.actor) {
+            actorContext = entity({
+                id: ids.actor(input.runRef, s.stepRef), type: 'ActorContext',
+                actingAgent: agent(agentIri(s.actor.actingAgent, input.chainId)),
+                ...(s.actor.originatingAgent ? { originatingAgent: agent(agentIri(s.actor.originatingAgent, input.chainId)) } : {}),
+                ...(s.actor.rootPrincipal ? { rootPrincipal: agent(agentIri(s.actor.rootPrincipal, input.chainId)) } : {}),
+            });
+        }
+        const delegatedToAgent = s.delegatedTo ? agent(agentIri(s.delegatedTo, input.chainId)) : undefined;
+        const completion = completionOf(s.status);
+        activities.push({
+            id: stepId, type: 'StepExecution', tier: 'execution-orchestrated',
+            startedAt: s.startedAt ?? input.endedAt, ...(s.endedAt ? { endedAt: s.endedAt } : {}),
+            wasAssociatedWith: agentId,
+            used, ...(usedDelegation ? { usedDelegation } : {}),
+            generated,
+            correspondsToStep: ids.planStep(input.runRef, s.stepRef),
+            ...(playbookId ? { hadPlan: playbookId } : {}),
+            ...(completion === 'Failed' || completion === 'Refused' ? { failed: true } : {}),
+            completionState: completion,
+            ...(s.receiptDigest ? { receiptDigest: s.receiptDigest } : {}),
+            ...(s.capability ? { realizesCapability: s.capability.id } : {}),
+            ...(s.authority ? { authorityDecision: s.authority.decision, afterApproval: s.authority.afterApproval } : {}),
+            ...(s.authority?.chain ? { chainDigest: s.authority.chain.chainDigest } : {}),
+            ...(accountabilityRoot ? { accountabilityRoot } : {}),
+            ...(actorContext ? { actorContext } : {}),
+            ...(delegatedToAgent ? { delegatedToAgent } : {}),
+            ...(s.delegatedToRun ? { wasInformedBy: [ids.run(s.delegatedToRun)] } : {}),
+            ...(s.errorClass ? { errorClass: s.errorClass } : {}),
+            ...(input.traceId ? { traceId: input.traceId } : {}),
+            ...(s.spanId ? { spanId: s.spanId } : {}),
+        });
+    }
+    const started = input.steps.map((s) => s.startedAt).filter((x) => !!x).sort()[0] ?? input.endedAt;
+    activities.unshift({
+        id: runId, type: 'HarnessRun', tier: 'execution-orchestrated',
+        startedAt: started, endedAt: input.endedAt,
+        wasAssociatedWith: runtimeId,
+        used: [], generated: [],
+        executionPlan: planId,
+        ...(playbookId ? { hadPlan: playbookId, usedPlanContentHash: input.playbook.commitment } : {}),
+        hasStep: stepIds,
+        runRef: input.runRef,
+        ...(input.intentDigest ? { intentDigest: input.intentDigest } : {}),
+        completionState: input.outcome === 'completed' ? 'Completed' : input.outcome === 'suspended' ? 'Suspended' : 'Failed',
+        ...(input.outcome !== 'completed' && input.outcome !== 'suspended' ? { failed: true } : {}),
+        ...(askerId ? { onBehalfOf: askerId } : {}),
+        ...(input.inResponseTo ? { wasInformedBy: [ids.run(input.inResponseTo.runRef)] } : {}),
+        ...(input.traceId ? { traceId: input.traceId } : {}),
+        ...(input.spanId ? { spanId: input.spanId } : {}),
+    });
+    return {
+        version: 'ap.provenance.v1',
+        agents: [...agents.values()],
+        activities,
+        entities,
+        plans,
+        bundle: {
+            id: bundleId,
+            wasAttributedTo: agentId,
+            ...(input.inResponseTo ? { wasInformedBy: [ids.bundle(input.inResponseTo.runRef)] } : {}),
+        },
+    };
+}
+//# sourceMappingURL=harness.js.map

package/dist/harness.js.map

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

package/dist/index.d.ts

@@ -3,5 +3,10 @@ export declare const PACKAGE_STATUS: "w5-projector";
 export declare const SPEC_REF = "specs/316-agentic-interaction-fabric.md";
 export type { Tier, AgentClass, ProvAgentRef, ProvActivityType, ProvActivity, ProvEntityType, ProvEntity, PPlanStep, PPlanPlan, ProvenanceRecordV1, } from './types.js';
 export { projectExchangeProvenance, projectRunProvenance, type ProvenanceExchangeInput, type ProvenanceRunInput, } from './project.js';
+export { projectEndeavorProvenance, type EndeavorProvenanceInput, type EndeavorRequestInput, type EndeavorPlanRevisionInput, type EndeavorStepExecutionInput, type EndeavorAttestationInput, } from './endeavor.js';
+export { projectHarnessRunProvenance, agentIri, harnessIds, type HarnessRunProvenanceInput, type HarnessStepView } from './harness.js';
+export { toJsonLd, toProvN, iriOf, PROV_ID_BASE, type JsonLdOptions } from './serialize.js';
 export { isPublicProjectionSafe, assertPublicProjectionSafe, type PublicProvenanceRow, type FirewallResult, } from './firewall.js';
+export { projectPublicProvenance } from './public.js';
+export type { PublicProvenanceRowV1, PublicProvenanceProjection } from './public.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,kCAAkC,CAAC;AAC5D,eAAO,MAAM,cAAc,EAAG,cAAuB,CAAC;AACtD,eAAO,MAAM,QAAQ,4CAA4C,CAAC;AAElE,YAAY,EACV,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,SAAS,EACT,SAAS,EACT,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,kCAAkC,CAAC;AAC5D,eAAO,MAAM,cAAc,EAAG,cAAuB,CAAC;AACtD,eAAO,MAAM,QAAQ,4CAA4C,CAAC;AAElE,YAAY,EACV,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,SAAS,EACT,SAAS,EACT,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,yBAAyB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,GAC9B,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,2BAA2B,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,yBAAyB,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AACvI,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE5F,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -5,5 +5,11 @@ export const PACKAGE_NAME = '@agenticprimitives/provenance';
 export const PACKAGE_STATUS = 'w5-projector';
 export const SPEC_REF = 'specs/316-agentic-interaction-fabric.md';
 export { projectExchangeProvenance, projectRunProvenance, } from './project.js';
+export { projectEndeavorProvenance, } from './endeavor.js';
+// Spec 389 — the harness run as the same graph, and the two serializations every record leaves in.
+export { projectHarnessRunProvenance, agentIri, harnessIds } from './harness.js';
+export { toJsonLd, toProvN, iriOf, PROV_ID_BASE } from './serialize.js';
 export { isPublicProjectionSafe, assertPublicProjectionSafe, } from './firewall.js';
+// Spec 395 — the public projection: anchored outcomes only, through S1.
+export { projectPublicProvenance } from './public.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,8GAA8G;AAC9G,mEAAmE;AACnE,MAAM,CAAC,MAAM,YAAY,GAAG,+BAA+B,CAAC;AAC5D,MAAM,CAAC,MAAM,cAAc,GAAG,cAAuB,CAAC;AACtD,MAAM,CAAC,MAAM,QAAQ,GAAG,yCAAyC,CAAC;AAelE,OAAO,EACL,yBAAyB,EACzB,oBAAoB,GAGrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAG3B,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,8GAA8G;AAC9G,mEAAmE;AACnE,MAAM,CAAC,MAAM,YAAY,GAAG,+BAA+B,CAAC;AAC5D,MAAM,CAAC,MAAM,cAAc,GAAG,cAAuB,CAAC;AACtD,MAAM,CAAC,MAAM,QAAQ,GAAG,yCAAyC,CAAC;AAelE,OAAO,EACL,yBAAyB,EACzB,oBAAoB,GAGrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,yBAAyB,GAM1B,MAAM,eAAe,CAAC;AAEvB,mGAAmG;AACnG,OAAO,EAAE,2BAA2B,EAAE,QAAQ,EAAE,UAAU,EAAwD,MAAM,cAAc,CAAC;AACvI,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAsB,MAAM,gBAAgB,CAAC;AAE5F,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAG3B,MAAM,eAAe,CAAC;AACvB,wEAAwE;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC"}

package/dist/public.d.ts

@@ -0,0 +1,34 @@
+import type { ProvenanceRecordV1 } from './types.js';
+/** One anchored outcome of a run, safe for anyone to read. The ids are the private graph's IRIs. */
+export interface PublicProvenanceRowV1 {
+    type: 'AnchoredOutcome';
+    '@id': string;
+    run: string;
+    /** The chain transaction the step left — the anchor. */
+    anchoredBy: string;
+    assurance: 'OnchainConfirmed';
+    receiptDigest?: string;
+    /** The mandate the step presented, by hash — a counterparty checks its revocation state on the chain. */
+    mandate?: string;
+    chainDigest?: string;
+    intentDigest?: string;
+    /** The playbook's content commitment (never its author). */
+    playbook?: string;
+    capability?: string;
+    completionState: string;
+    endedAt?: string;
+}
+export interface PublicProvenanceProjection {
+    rows: PublicProvenanceRowV1[];
+    /** Every step activity that was NOT projected, and the firewall's or the anchor rule's reason. */
+    refused: Array<{
+        activity: string;
+        reason: string;
+    }>;
+}
+/**
+ * Project the anchored outcomes of a run. Pure. A candidate that the S1 firewall refuses, or whose JSON carries
+ * anything that looks like an address, is refused with the reason — never trimmed into shape.
+ */
+export declare function projectPublicProvenance(record: ProvenanceRecordV1): PublicProvenanceProjection;
+//# sourceMappingURL=public.d.ts.map

package/dist/public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../src/public.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,kBAAkB,EAA4B,MAAM,YAAY,CAAC;AAE/E,oGAAoG;AACpG,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yGAAyG;IACzG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,qBAAqB,EAAE,CAAC;IAC9B,kGAAkG;IAClG,OAAO,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAID;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,GAAG,0BAA0B,CA0C9F"}

package/dist/public.js

@@ -0,0 +1,67 @@
+// THE PUBLIC PROJECTION — spec 395. What a run LEFT ON THE CHAIN may be cited in public; what it was ABOUT may
+// not. One row per step that generated a `ChainTransaction`: the transaction is the anchor (`apvr:anchoredBy`,
+// assurance OnchainConfirmed — the harness records a hash only from a mined receipt), and the row carries DIGESTS
+// AND IDS ONLY: the run and step IRIs (derived from the run reference — correlation, never trust), the receipt
+// digest, the chain digest, the intent digest, the playbook commitment, the capability id, the completion state.
+// NO AGENT, NO ATTRIBUTION, NO actedOnBehalfOf, NO ARGUMENT, NO RESULT, NO WORDS, NO ADDRESS. Every row passes the
+// S1 firewall before it leaves; a step without an anchor is refused BY NAME and nothing of it is emitted.
+//
+// Served by the acting agent to anyone; never written into the discovery KB (ADR-0040: the indexer is the only
+// writer). A counterparty verifies by RECOMPUTING — the receipt they hold hashes to the digest the row names, the
+// transaction exists on chain, the run id is the one their receipt's hasProvenance named. No gate reads a row.
+import { isPublicProjectionSafe } from './firewall.js';
+const ADDRESS = /0x[0-9a-f]{40}(?![0-9a-f])/i;
+/**
+ * Project the anchored outcomes of a run. Pure. A candidate that the S1 firewall refuses, or whose JSON carries
+ * anything that looks like an address, is refused with the reason — never trimmed into shape.
+ */
+export function projectPublicProvenance(record) {
+    const rows = [];
+    const refused = [];
+    const run = record.activities.find((a) => a.type === 'HarnessRun');
+    const entities = new Map(record.entities.map((e) => [e.id, e]));
+    const playbook = run?.usedPlanContentHash;
+    for (const step of record.activities.filter((a) => a.type === 'StepExecution')) {
+        const tx = step.generated.map((id) => entities.get(id)).find((e) => !!e && e.type === 'ChainTransaction');
+        const candidate = {
+            type: 'AnchoredOutcome',
+            ...(tx?.ref ? { anchoredBy: tx.ref.toLowerCase() } : {}),
+            assurance: tx ? 'OnchainConfirmed' : 'Asserted',
+            properties: {
+                run: run?.id ?? '', step: step.id,
+                ...(step.receiptDigest ? { receiptDigest: step.receiptDigest } : {}),
+                ...(step.usedDelegation && entities.get(step.usedDelegation)?.ref ? { mandate: entities.get(step.usedDelegation).ref.toLowerCase() } : {}),
+                ...(step.chainDigest ? { chainDigest: step.chainDigest } : {}),
+                ...(run?.intentDigest ? { intentDigest: run.intentDigest } : {}),
+                ...(playbook ? { playbook } : {}),
+                ...(step.realizesCapability ? { capability: step.realizesCapability } : {}),
+                completionState: step.completionState ?? 'Completed',
+                ...(step.endedAt ? { endedAt: step.endedAt } : {}),
+            },
+        };
+        const verdict = isPublicProjectionSafe(candidate);
+        if (!verdict.ok) {
+            refused.push({ activity: step.id, reason: verdict.reason });
+            continue;
+        }
+        const row = {
+            type: 'AnchoredOutcome', '@id': step.id, run: candidate.properties.run, anchoredBy: candidate.anchoredBy, assurance: 'OnchainConfirmed',
+            ...(candidate.properties.receiptDigest ? { receiptDigest: candidate.properties.receiptDigest } : {}),
+            ...(candidate.properties.mandate ? { mandate: candidate.properties.mandate } : {}),
+            ...(candidate.properties.chainDigest ? { chainDigest: candidate.properties.chainDigest } : {}),
+            ...(candidate.properties.intentDigest ? { intentDigest: candidate.properties.intentDigest } : {}),
+            ...(candidate.properties.playbook ? { playbook: candidate.properties.playbook } : {}),
+            ...(candidate.properties.capability ? { capability: candidate.properties.capability } : {}),
+            completionState: candidate.properties.completionState,
+            ...(candidate.properties.endedAt ? { endedAt: candidate.properties.endedAt } : {}),
+        };
+        // The last line: nothing that looks like an agent's address leaves, whatever field it hid in.
+        if (ADDRESS.test(JSON.stringify(row))) {
+            refused.push({ activity: step.id, reason: 'address_literal' });
+            continue;
+        }
+        rows.push(row);
+    }
+    return { rows, refused };
+}
+//# sourceMappingURL=public.js.map

package/dist/public.js.map

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

package/dist/serialize.d.ts

@@ -0,0 +1,21 @@
+import type { ProvenanceRecordV1 } from './types.js';
+export declare const PROV_ID_BASE = "urn:ap:prov:";
+/** A record id as an IRI: an absolute IRI (`urn:`, `https:`, `did:`) stays; an address becomes an agent IRI;
+ *  anything else resolves under the record base. */
+export declare function iriOf(id: string, chainId?: number): string;
+export interface JsonLdOptions {
+    /** The `@context` value: the published context object, or its URL. */
+    context: Record<string, unknown> | string;
+    /** Names agents the way the public KB does when known. */
+    chainId?: number;
+}
+type Node = Record<string, unknown>;
+/** A JSON-LD 1.1 document: the bundle as a named graph whose members are `@graph`. */
+export declare function toJsonLd(record: ProvenanceRecordV1, opts: JsonLdOptions): Node;
+/** PROV-N (W3C Recommendation) — the text notation, one statement per line. Qualified names use the same
+ *  prefixes the JSON-LD context declares. */
+export declare function toProvN(record: ProvenanceRecordV1, opts?: {
+    chainId?: number;
+}): string;
+export {};
+//# sourceMappingURL=serialize.d.ts.map

package/dist/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAuF,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE1I,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C;oDACoD;AACpD,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAI1D;AAwBD,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IAC1C,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpC,sFAAsF;AACtF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAkF9E;AAED;6CAC6C;AAC7C,wBAAgB,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAqE3F"}

package/dist/serialize.js

@@ -0,0 +1,211 @@
+export const PROV_ID_BASE = 'urn:ap:prov:';
+/** A record id as an IRI: an absolute IRI (`urn:`, `https:`, `did:`) stays; an address becomes an agent IRI;
+ *  anything else resolves under the record base. */
+export function iriOf(id, chainId) {
+    if (/^(urn|https?|did):/i.test(id))
+        return id;
+    if (/^0x[0-9a-f]{40}$/i.test(id))
+        return chainId ? `urn:ap:agent:eip155:${chainId}:${id.toLowerCase()}` : `urn:ap:agent:${id.toLowerCase()}`;
+    return `${PROV_ID_BASE}${id}`;
+}
+/** The class terms (as the context names them) for each activity type. */
+const ACTIVITY_TYPES = {
+    CommunicationDelivery: ['Activity', 'CommunicationDelivery'],
+    IntentInvocation: ['Activity', 'IntentInvocation'],
+    OrchestratedTask: ['Activity', 'OrchestratedTask'],
+    EndeavorAdoption: ['Activity'],
+    PlanProposal: ['Activity'],
+    PlanAdoption: ['Activity'],
+    StepExecution: ['Activity'],
+    HarnessRun: ['Activity', 'ServiceExecution'],
+};
+const ENTITY_TYPES = {
+    Message: ['Entity'], Artifact: ['Entity'], DecisionArtifact: ['Entity'], EndeavorRequest: ['Entity'],
+    OutcomeSpecification: ['Entity'], PlanRevision: ['Entity', 'Plan', 'CoordinationPlan'], ExecutionPlan: ['Entity', 'Plan', 'ExecutionPlan'],
+    Attestation: ['Entity'], Delegation: ['Entity', 'Delegation'], Playbook: ['Entity', 'Plan', 'AgentSkillPackage'],
+    StepReceipt: ['Entity', 'StepReceipt'], ChainTransaction: ['Entity', 'ChainTransaction'], Effect: ['Entity', 'Effect'],
+    DecisionRecord: ['Entity', 'DecisionRecord'], ActorContext: ['Entity', 'ActorContext'], RunArtifact: ['Entity', 'RunArtifact'],
+};
+const PLAN_TYPES = {
+    Plan: ['Entity', 'Plan'], ExecutionPlan: ['Entity', 'Plan', 'ExecutionPlan'], Playbook: ['Entity', 'Plan', 'AgentSkillPackage'], CoordinationPlan: ['Entity', 'Plan', 'CoordinationPlan'],
+};
+/** A JSON-LD 1.1 document: the bundle as a named graph whose members are `@graph`. */
+export function toJsonLd(record, opts) {
+    const iri = (id) => iriOf(id, opts.chainId);
+    const iris = (ids) => (ids?.length ? ids.map(iri) : undefined);
+    const drop = (o) => Object.fromEntries(Object.entries(o).filter(([, v]) => v !== undefined && !(Array.isArray(v) && v.length === 0)));
+    const agentNode = (a) => drop({
+        id: iri(a.id),
+        type: a.kind === 'AgentRuntime' ? ['SoftwareAgent', 'AgentRuntime'] : ['Agent', ...(a.agentClass === 'person' ? ['Person'] : a.agentClass === 'org' ? ['Organization'] : a.agentClass === 'service' ? ['SoftwareAgent'] : [])],
+        actedOnBehalfOf: a.actedOnBehalfOf ? iri(a.actedOnBehalfOf) : undefined,
+    });
+    const activityNode = (a) => {
+        const types = [...ACTIVITY_TYPES[a.type]];
+        if (a.type === 'StepExecution' && a.hadPlan)
+            types.push('SkillExecution');
+        if (a.failed)
+            types.push('FailedActivity');
+        const associations = [];
+        if (a.hadPlan || a.hadRole)
+            associations.push(drop({ type: 'Association', agent: iri(a.wasAssociatedWith), hadPlan: a.hadPlan ? iri(a.hadPlan) : undefined, hadRole: a.hadRole ? iri(a.hadRole) : undefined }));
+        if (a.executionPlan)
+            associations.push({ type: 'Association', agent: iri(a.wasAssociatedWith), hadPlan: iri(a.executionPlan) });
+        return drop({
+            id: iri(a.id), type: types,
+            startedAtTime: a.startedAt, endedAtTime: a.endedAt, endedAt: a.endedAt,
+            wasAssociatedWith: iri(a.wasAssociatedWith),
+            qualifiedAssociation: associations.length ? associations : undefined,
+            actedOnBehalfOf: a.onBehalfOf ? iri(a.onBehalfOf) : undefined,
+            used: iris(a.used), usedDelegation: a.usedDelegation ? iri(a.usedDelegation) : undefined,
+            generated: iris(a.generated),
+            wasInformedBy: iris(a.wasInformedBy),
+            correspondsToStep: a.correspondsToStep ? iri(a.correspondsToStep) : undefined,
+            hasStep: iris(a.hasStep),
+            runRef: a.runRef, intentDigest: a.intentDigest,
+            completionState: a.completionState,
+            receiptDigest: a.receiptDigest, usedPlanContentHash: a.usedPlanContentHash,
+            realizesCapability: a.realizesCapability ? (/^(urn|https?):/.test(a.realizesCapability) ? a.realizesCapability : `urn:ap:capability:${a.realizesCapability}`) : undefined,
+            authorityDecision: a.authorityDecision, afterApproval: a.afterApproval, chainDigest: a.chainDigest,
+            accountabilityRoot: a.accountabilityRoot ? iri(a.accountabilityRoot) : undefined,
+            actorContext: a.actorContext ? iri(a.actorContext) : undefined,
+            delegatedToAgent: a.delegatedToAgent ? iri(a.delegatedToAgent) : undefined,
+            errorClass: a.errorClass,
+            traceId: a.traceId, spanId: a.spanId,
+        });
+    };
+    const entityNode = (e) => drop({
+        id: iri(e.id), type: ENTITY_TYPES[e.type],
+        wasGeneratedBy: e.wasGeneratedBy ? iri(e.wasGeneratedBy) : undefined,
+        wasRevisionOf: e.wasRevisionOf ? iri(e.wasRevisionOf) : undefined,
+        wasDerivedFrom: iris(e.wasDerivedFrom),
+        wasAttributedTo: e.wasAttributedTo ? iri(e.wasAttributedTo) : undefined,
+        effectProduces: e.effectProduces, effectSucceeded: e.effectSucceeded,
+        decisionPoint: e.decisionPoint, decisionRule: e.decisionRule,
+        actingAgent: e.actingAgent ? iri(e.actingAgent) : undefined,
+        originatingAgent: e.originatingAgent ? iri(e.originatingAgent) : undefined,
+        rootPrincipal: e.rootPrincipal ? iri(e.rootPrincipal) : undefined,
+        artifactBytes: e.artifactBytes, artifactDigest: e.artifactDigest,
+    });
+    const planNodes = (p) => [
+        drop({ id: iri(p.id), type: PLAN_TYPES[p.kind ?? 'Plan'] }),
+        ...p.steps.map((s) => drop({
+            id: iri(s.id), type: ['Step'], isStepOfPlan: iri(s.isStepOfPlan),
+            isPrecededBy: s.isPrecededBy ? iri(s.isPrecededBy) : undefined,
+            isDecomposedAsPlan: s.isDecomposedAsPlan ? iri(s.isDecomposedAsPlan) : undefined,
+        })),
+    ];
+    const members = [
+        ...record.agents.map(agentNode),
+        ...record.activities.map(activityNode),
+        ...record.entities.map(entityNode),
+        ...record.plans.flatMap(planNodes),
+    ];
+    if (!record.bundle)
+        return { '@context': opts.context, graph: members };
+    return drop({
+        '@context': opts.context,
+        id: iri(record.bundle.id),
+        type: ['Entity', 'Bundle', 'ExecutionTraceBundle'],
+        wasAttributedTo: record.bundle.wasAttributedTo ? iri(record.bundle.wasAttributedTo) : undefined,
+        wasInformedBy: iris(record.bundle.wasInformedBy),
+        hasTraceElement: members.map((m) => m['id']),
+        graph: members,
+    });
+}
+/** PROV-N (W3C Recommendation) — the text notation, one statement per line. Qualified names use the same
+ *  prefixes the JSON-LD context declares. */
+export function toProvN(record, opts = {}) {
+    const iri = (id) => `<${iriOf(id, opts.chainId)}>`;
+    const q = (s) => `"${s.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+    const attrs = (o) => {
+        const kv = Object.entries(o).filter(([, v]) => v !== undefined).map(([k, v]) => `${k}=${typeof v === 'boolean' ? `"${v}" %% xsd:boolean` : q(String(v))}`);
+        return kv.length ? `, [${kv.join(', ')}]` : '';
+    };
+    const lines = [
+        'document',
+        '  prefix prov <http://www.w3.org/ns/prov#>',
+        '  prefix p-plan <http://purl.org/net/p-plan#>',
+        '  prefix ep-plan <https://w3id.org/ep-plan#>',
+        '  prefix xsd <http://www.w3.org/2001/XMLSchema#>',
+        '  prefix ap <https://agenticprimitives.dev/ns/core#>',
+        '  prefix apexec <https://agenticprimitives.dev/ns/execution#>',
+        '  prefix apactor <https://agenticprimitives.dev/ns/actor#>',
+        '  prefix apguide <https://agenticprimitives.dev/ns/guidance#>',
+        '  prefix apdel <https://agenticprimitives.dev/ns/delegation#>',
+        '  prefix apvr <https://agenticprimitives.dev/ns/verification-receipt#>',
+    ];
+    const body = [];
+    const indent = record.bundle ? '    ' : '  ';
+    for (const a of record.agents) {
+        body.push(`${indent}agent(${iri(a.id)}${attrs({ 'prov:type': a.kind === 'AgentRuntime' ? 'apexec:AgentRuntime' : a.agentClass === 'person' ? 'prov:Person' : a.agentClass === 'org' ? 'prov:Organization' : a.agentClass === 'service' ? 'prov:SoftwareAgent' : 'ap:Agent' })})`);
+        if (a.actedOnBehalfOf)
+            body.push(`${indent}actedOnBehalfOf(${iri(a.id)}, ${iri(a.actedOnBehalfOf)}, -)`);
+    }
+    for (const a of record.activities) {
+        const t = a.type === 'HarnessRun' ? 'apexec:ServiceExecution' : a.type === 'StepExecution' && a.hadPlan ? 'apexec:SkillExecution' : `prov:Activity`;
+        body.push(`${indent}activity(${iri(a.id)}, ${a.startedAt}, ${a.endedAt ?? '-'}${attrs({ 'prov:type': t, 'apexec:runRef': a.runRef, 'apexec:intentDigest': a.intentDigest, 'apexec:completionState': a.completionState ? `apexec:${a.completionState}` : undefined, 'apexec:receiptDigest': a.receiptDigest, 'apexec:usedPlanContentHash': a.usedPlanContentHash, 'apexec:authorityDecision': a.authorityDecision, 'apexec:afterApproval': a.afterApproval, 'apexec:chainDigest': a.chainDigest, 'apexec:errorClass': a.errorClass, 'apexec:realizesCapability': a.realizesCapability, 'apexec:traceId': a.traceId, 'apexec:spanId': a.spanId })})`);
+        if (a.failed)
+            body.push(`${indent}activity(${iri(a.id)}, -, -, [prov:type="ep-plan:FailedActivity"])`);
+        body.push(`${indent}wasAssociatedWith(${iri(a.id)}, ${iri(a.wasAssociatedWith)}, ${a.hadPlan ? iri(a.hadPlan) : '-'}${a.hadRole ? `, [prov:role=${q(a.hadRole)}]` : ''})`);
+        if (a.executionPlan)
+            body.push(`${indent}wasAssociatedWith(${iri(a.id)}, ${iri(a.wasAssociatedWith)}, ${iri(a.executionPlan)})`);
+        if (a.onBehalfOf)
+            body.push(`${indent}actedOnBehalfOf(${iri(a.wasAssociatedWith)}, ${iri(a.onBehalfOf)}, ${iri(a.id)})`);
+        if (a.usedDelegation)
+            body.push(`${indent}used(${iri(a.id)}, ${iri(a.usedDelegation)}, -, [prov:type="apvr:usedDelegation"])`);
+        for (const u of a.used)
+            body.push(`${indent}used(${iri(a.id)}, ${iri(u)}, -)`);
+        for (const g of a.generated)
+            body.push(`${indent}wasGeneratedBy(${iri(g)}, ${iri(a.id)}, ${a.endedAt ?? '-'})`);
+        for (const w of a.wasInformedBy ?? [])
+            body.push(`${indent}wasInformedBy(${iri(a.id)}, ${iri(w)})`);
+        for (const s of a.hasStep ?? [])
+            body.push(`${indent}wasInfluencedBy(${iri(s)}, ${iri(a.id)}, [prov:type="apexec:hasStep"])`);
+        if (a.correspondsToStep)
+            body.push(`${indent}wasInfluencedBy(${iri(a.id)}, ${iri(a.correspondsToStep)}, [prov:type="p-plan:correspondsToStep"])`);
+        if (a.accountabilityRoot)
+            body.push(`${indent}wasInfluencedBy(${iri(a.id)}, ${iri(a.accountabilityRoot)}, [prov:type="apexec:accountabilityRoot"])`);
+        if (a.actorContext)
+            body.push(`${indent}used(${iri(a.id)}, ${iri(a.actorContext)}, -, [prov:type="apexec:actorContext"])`);
+        if (a.delegatedToAgent)
+            body.push(`${indent}wasInfluencedBy(${iri(a.id)}, ${iri(a.delegatedToAgent)}, [prov:type="apexec:delegatedToAgent"])`);
+    }
+    for (const e of record.entities) {
+        body.push(`${indent}entity(${iri(e.id)}${attrs({ 'prov:type': e.type === 'Delegation' ? 'apdel:Delegation' : e.type === 'Playbook' ? 'apguide:AgentSkillPackage' : e.type === 'ExecutionPlan' ? 'apexec:ExecutionPlan' : `apexec:${e.type}`, 'apexec:effectProduces': e.effectProduces, 'apexec:effectSucceeded': e.effectSucceeded, 'apexec:decisionPoint': e.decisionPoint, 'apexec:decisionRule': e.decisionRule, 'apexec:artifactDigest': e.artifactDigest, 'apexec:artifactBytes': e.artifactBytes !== undefined ? String(e.artifactBytes) : undefined })})`);
+        if (e.wasAttributedTo)
+            body.push(`${indent}wasAttributedTo(${iri(e.id)}, ${iri(e.wasAttributedTo)})`);
+        if (e.wasRevisionOf)
+            body.push(`${indent}wasRevisionOf(${iri(e.id)}, ${iri(e.wasRevisionOf)})`);
+        for (const d of e.wasDerivedFrom ?? [])
+            body.push(`${indent}wasDerivedFrom(${iri(e.id)}, ${iri(d)})`);
+        if (e.actingAgent)
+            body.push(`${indent}wasInfluencedBy(${iri(e.id)}, ${iri(e.actingAgent)}, [prov:type="apactor:actingAgent"])`);
+        if (e.originatingAgent)
+            body.push(`${indent}wasInfluencedBy(${iri(e.id)}, ${iri(e.originatingAgent)}, [prov:type="apactor:originatingAgent"])`);
+        if (e.rootPrincipal)
+            body.push(`${indent}wasInfluencedBy(${iri(e.id)}, ${iri(e.rootPrincipal)}, [prov:type="apactor:rootPrincipal"])`);
+    }
+    for (const p of record.plans) {
+        body.push(`${indent}entity(${iri(p.id)}, [prov:type="${p.kind === 'ExecutionPlan' ? 'apexec:ExecutionPlan' : p.kind === 'Playbook' ? 'apguide:AgentSkillPackage' : p.kind === 'CoordinationPlan' ? 'apcoord:CoordinationPlan' : 'p-plan:Plan'}"])`);
+        for (const s of p.steps) {
+            body.push(`${indent}entity(${iri(s.id)}, [prov:type="p-plan:Step", p-plan:isStepOfPlan=${q(iriOf(s.isStepOfPlan, opts.chainId))}])`);
+            if (s.isPrecededBy)
+                body.push(`${indent}wasInfluencedBy(${iri(s.id)}, ${iri(s.isPrecededBy)}, [prov:type="p-plan:isPrecededBy"])`);
+        }
+    }
+    if (record.bundle) {
+        lines.push(`  bundle ${iri(record.bundle.id)}`);
+        lines.push(...body);
+        lines.push('  endBundle');
+        lines.push(`  entity(${iri(record.bundle.id)}, [prov:type="ep-plan:ExecutionTraceBundle"])`);
+        if (record.bundle.wasAttributedTo)
+            lines.push(`  wasAttributedTo(${iri(record.bundle.id)}, ${iri(record.bundle.wasAttributedTo)})`);
+        for (const w of record.bundle.wasInformedBy ?? [])
+            lines.push(`  wasDerivedFrom(${iri(record.bundle.id)}, ${iri(w)}, [prov:type="prov:wasInformedBy"])`);
+    }
+    else
+        lines.push(...body);
+    lines.push('endDocument');
+    return lines.join('\n') + '\n';
+}
+//# sourceMappingURL=serialize.js.map

package/dist/serialize.js.map

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

package/dist/types.d.ts

@@ -3,11 +3,23 @@ export type AgentClass = 'person' | 'org' | 'service';
 /** PROV-O agent (`prov:Agent`), classified per ADR-0046. */
 export interface ProvAgentRef {
     id: string;
-    agentClass: AgentClass;
+    /** Person / org / service (ADR-0046). Absent when the projector was not told — a graph says `ap:Agent`
+     *  and nothing more, rather than a class it guessed (the knowledge plane's plausible-falsehood failure). */
+    agentClass?: AgentClass;
+    /** Spec 389 — `AgentRuntime` for the identified runtime (`apexec:AgentRuntime ⊑ prov:SoftwareAgent`) that
+     *  bore responsibility for a run; default `Agent`. */
+    kind?: 'Agent' | 'AgentRuntime';
+    /** `prov:actedOnBehalfOf` — the agent this one acted for (the runtime for its Smart Agent; a delegate
+     *  for its delegator). Private detail (the S1 firewall rejects it from any public row). */
+    actedOnBehalfOf?: string;
 }
-/** `apfab:CommunicationDelivery` (T0) / `apfab:IntentInvocation` (T1) / `apfab:OrchestratedTask ≡ apful:Task`
- *  (T2) — all `⊑ prov:Activity` (§6). */
-export type ProvActivityType = 'CommunicationDelivery' | 'IntentInvocation' | 'OrchestratedTask';
+/** `apix:CommunicationDelivery` (T0) / `apix:IntentInvocation` (T1) / `apix:OrchestratedTask ≡ apful:Task`
+ *  (T2) — all `⊑ prov:Activity` (§6). Spec 332 §7 adds the coordination activities: `EndeavorAdoption`,
+ *  `PlanProposal`, `PlanAdoption`, and the per-step `StepExecution` (an `apexec:ServiceExecution` /
+ *  `apful:Task` activity carrying `p-plan:correspondsToStep`). */
+export type ProvActivityType = 'CommunicationDelivery' | 'IntentInvocation' | 'OrchestratedTask' | 'EndeavorAdoption' | 'PlanProposal' | 'PlanAdoption' | 'StepExecution'
+/** Spec 389 — a harness run (`apexec:ServiceExecution`); its steps are `StepExecution`s it `hasStep`. */
+ | 'HarnessRun';
 export interface ProvActivity {
     id: string;
     type: ProvActivityType;
@@ -16,15 +28,56 @@ export interface ProvActivity {
     endedAt?: string;
     /** `prov:wasAssociatedWith` — the acting agent id. */
     wasAssociatedWith: string;
-    /** `apfab:usedDelegation`/`usedStatusEvidence ⊑ prov:used` — BY-HASH refs, never inline authority. */
+    /** `apvr:usedDelegation`/`usedStatusEvidence ⊑ prov:used` — BY-HASH refs, never inline authority. */
     used: string[];
-    /** `apfab:onBehalfOf ⊑ prov:actedOnBehalfOf` — **PRIVATE DETAIL ONLY** (the S1 firewall rejects it from any
+    /** `apvr:onBehalfOf ⊑ prov:actedOnBehalfOf` — **PRIVATE DETAIL ONLY** (the S1 firewall rejects it from any
      *  public row). */
     onBehalfOf?: string;
     /** `prov:generated` — entity ids this activity produced. */
     generated: string[];
+    /** `p-plan:correspondsToStep` — the DURABLE `apcoord:PlanStep` this execution enacted (spec 332 §7). */
+    correspondsToStep?: string;
+    /** `prov:qualifiedAssociation[prov:hadPlan]` — the EXACT adopted plan revision entity id (spec 330 §9). */
+    hadPlan?: string;
+    /** `prov:qualifiedAssociation[prov:hadRole]` — the capacity the agent functioned in. Never a permission. */
+    hadRole?: string;
+    /** `ep-plan:FailedActivity` — the execution was interrupted / not completed. A first-class trace
+     *  fact (tbox/plan.ttl), never silently dropped. */
+    failed?: boolean;
+    /** `apexec:hasStep` — the step activities this run contains (a run only). */
+    hasStep?: string[];
+    /** `apvr:usedDelegation ⊑ prov:used` — the mandate the step presented, by reference. */
+    usedDelegation?: string;
+    /** `prov:wasInformedBy` — activities this one was informed by (a hand-off step ← the child run). */
+    wasInformedBy?: string[];
+    /** A second `prov:qualifiedAssociation` (agent = the runtime, `hadPlan` = the run's own ExecutionPlan). */
+    executionPlan?: string;
+    runRef?: string;
+    intentDigest?: string;
+    /** `apexec:completionState` — one of the closed list (`Completed` … `Suspended`). */
+    completionState?: string;
+    receiptDigest?: string;
+    usedPlanContentHash?: string;
+    /** `apexec:realizesCapability` — the capability id the step realized (a `aps:Capability` IRI or id). */
+    realizesCapability?: string;
+    authorityDecision?: string;
+    afterApproval?: boolean;
+    chainDigest?: string;
+    accountabilityRoot?: string;
+    /** `apexec:actorContext` — the ActorContext entity id. */
+    actorContext?: string;
+    /** `apexec:delegatedToAgent` — the agent a step was handed to. */
+    delegatedToAgent?: string;
+    errorClass?: string;
+    /** Spec 390 — the OpenTelemetry span this activity IS (W3C-sized hex ids). Correlation, never trust. */
+    traceId?: string;
+    spanId?: string;
 }
-export type ProvEntityType = 'Message' | 'Artifact' | 'DecisionArtifact';
+export type ProvEntityType = 'Message' | 'Artifact' | 'DecisionArtifact' | 'EndeavorRequest' | 'OutcomeSpecification' | 'PlanRevision'
+/** The RUN-SPECIFIC `apexec:ExecutionPlan` a PlanStep compiled into (ADR-0054 §3 trichotomy). */
+ | 'ExecutionPlan' | 'Attestation' | 'Delegation' | 'Playbook' | 'StepReceipt' | 'ChainTransaction' | 'Effect' | 'DecisionRecord' | 'ActorContext'
+/** Spec 391 — a step's raw result, offloaded to the acting agent's vault. */
+ | 'RunArtifact';
 export interface ProvEntity {
     id: string;
     type: ProvEntityType;
@@ -32,6 +85,23 @@ export interface ProvEntity {
     wasGeneratedBy?: string;
     /** Vault-resident ref (hash / VaultRef) — NEVER inline plaintext. */
     ref?: string;
+    /** `prov:wasRevisionOf` — the prior revision entity id (plan revision chains, spec 332 §7). */
+    wasRevisionOf?: string;
+    /** `prov:wasDerivedFrom` — contributing entity ids (outcome attestations derive from artifacts). */
+    wasDerivedFrom?: string[];
+    /** `prov:wasAttributedTo` — the agent an entity is attributed to (a playbook to its author's agent is NOT
+     *  recorded — only the commitment is; a receipt to the acting agent). */
+    wasAttributedTo?: string;
+    effectProduces?: string;
+    effectSucceeded?: boolean;
+    decisionPoint?: string;
+    decisionRule?: string;
+    actingAgent?: string;
+    originatingAgent?: string;
+    rootPrincipal?: string;
+    /** Spec 391 — an offloaded artifact's size and digest. */
+    artifactBytes?: number;
+    artifactDigest?: string;
 }
 /** P-Plan (`tbox/plan.ttl`) — grounds an orchestration `Plan` (and a service-agent `PrimitivePlan`) as
  *  `p-plan:Plan`; steps are `p-plan:Step` via `isStepOfPlan` (§6). */
@@ -39,10 +109,23 @@ export interface PPlanStep {
     id: string;
     toolId: string;
     isStepOfPlan: string;
+    /** `ep-plan:isDecomposedAsPlan` — the run-specific ExecutionPlan ENTITY id this step compiled
+     *  into (the CoordinationPlan→ExecutionPlan bridge, named; emitted alongside the run plan's
+     *  `prov:wasDerivedFrom` back to the adopted revision). */
+    isDecomposedAsPlan?: string;
+    /** `p-plan:isPrecededBy` — the step before this one in the plan's order. */
+    isPrecededBy?: string;
 }
 export interface PPlanPlan {
     id: string;
     steps: PPlanStep[];
+    /** Spec 389 — which plan variant (ADR-0054 §3 trichotomy): the run's own `apexec:ExecutionPlan`, a
+     *  playbook (`apguide:AgentSkillPackage`, prescriptive procedure), a durable `apcoord:CoordinationPlan`.
+     *  Absent ⇒ `p-plan:Plan` only. */
+    kind?: 'ExecutionPlan' | 'Playbook' | 'CoordinationPlan';
+    /** For a playbook: `apexec:usedPlanContentHash` is carried on the run; the plan entity itself is named
+     *  by skill id, version and commitment. Vault ref / hash of the plan content when one exists. */
+    ref?: string;
 }
 /** The PRIVATE vault A-box the projector writes — the ONLY surface this package emits. It NEVER writes the
  *  public discovery KB (that has exactly one writer, the indexer, projecting on-chain facts; §6 / B1). */
@@ -52,5 +135,16 @@ export interface ProvenanceRecordV1 {
     activities: ProvActivity[];
     entities: ProvEntity[];
     plans: PPlanPlan[];
+    /** `ep-plan:ExecutionTraceBundle` (⊑ prov:Bundle) — names THIS record as one bundle; every
+     *  agent/activity/entity above is an `ep-plan:hasTraceElement` member. Set by per-execution
+     *  projections (one Endeavor = one bundle); absent on partial/merged records. */
+    bundle?: {
+        id: string;
+        /** Spec 389 — the sender's bundle for a routed / handed-off run (`prov:wasInformedBy`), so a run across
+         *  two Homes reads as one graph from either side, each holding only its own bundle. */
+        wasInformedBy?: string[];
+        /** `prov:wasAttributedTo` — whose bundle this is (the acting agent — the vault it lives in). */
+        wasAttributedTo?: string;
+    };
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,IAAI,GAAG,eAAe,GAAG,gBAAgB,GAAG,wBAAwB,CAAC;AACjF,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AAEtD,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;yCACyC;AACzC,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAEjG,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sGAAsG;IACtG,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;uBACmB;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,kBAAkB,CAAC;AAEzE,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;sEACsE;AACtE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AACD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED;0GAC0G;AAC1G,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticprimitives/provenance",
-  "version": "0.0.0-alpha.0",
+  "version": "0.0.0-alpha.2",
   "description": "The Ring-0 provenance projector (spec 316 §6): maps fabric exchanges + orchestration runs to a PRIVATE PROV-O / P-Plan A-box, and enforces the ADR-0040 public-projection firewall (S1). Sole writer of the private vault A-box; NEVER writes the public KB.",
   "license": "MIT",
   "repository": {