How to Suggest an Actor for a Case
Use this guide when you believe an actor belongs on a case and you are not the one who decides. A suggestion goes to the CASE_MANAGER, which presents it to the Case Owner for a decision (ADR-0026, ADR-0029). You finish with the suggested actor either invited or the recommendation declined, and with the outcome reported back to you.
Prerequisites
- A running Vultron instance you can drive. The demo containers are the quickest route — see Tutorial: Run the Receive-Report Demo for the two steps that get you a container shell.
- An actor identity on that instance, holding the role each step names.
- Working knowledge of the ActivityStreams verb, object, and target shape, summarized in Vultron and ActivityPub.
-
Working knowledge of the case model: the objects a case is made of, in The Case Model, and who is allowed to change them, in The CASE_MANAGER and the Case Ledger. Where a guide's messages are case-scoped, they route through the CASE_MANAGER and their results appear on the case ledger.
-
A case you participate in. Any participant can suggest an actor. The CASE_MANAGER refuses a suggestion from an actor that is not a participant, and forwards nothing to the Case Owner.
- The suggested actor's Uniform Resource Identifier (URI).
- The roles you suggest for the actor, if any.
Do not suggest
CASE_MANAGERorCASE_OWNER: the CASE_MANAGER refuses the suggestion, sends you a refusal notice, and forwards nothing (CM-20-006, CM-20-008). - The CASE_MANAGER's actor URI.
If you hold the Case Owner role and the decision is yours alone, invite the actor directly instead — see How to Invite an Actor to a Case.
The exchange
The sequence diagram below shows the full round trip, from recommendation to invitation or the Case Owner's Reject, which the CASE_MANAGER ledgers like an Accept.
The recommender never contacts the Case Owner or the invitee directly.
---
title: Suggesting an Actor for a Case (ADR-0026 CaseActor-routed)
---
sequenceDiagram
actor A as Recommender
participant CA as CASE_MANAGER
actor B as Case Owner
actor D as Invitee
Note over A: Recognize that Actor should be invited
A ->> CA: Offer(Actor)[target=VulnerabilityCase]
activate CA
Note over CA: Record in ledger, assign default roles
CA ->> B: Offer(CaseParticipant)[target=VulnerabilityCase]
activate B
alt Accept Suggestion
B ->> CA: Accept(Offer(CaseParticipant)[target=VulnerabilityCase])
CA ->> A: AcceptActorRecommendation
CA ->>+ D: Invite(VulnerabilityCase preview)[target=Actor]
note over D: The stub carries the embargo, and the Invite the roles.<br/>Respond to invitation (not shown)
deactivate D
else Reject Suggestion
B ->> CA: Reject(Offer(CaseParticipant)[target=VulnerabilityCase])
CA ->> A: RejectActorRecommendation
end
deactivate B
deactivate CA
Recommend the actor
The formal message set does not name this exchange.
All three activities are in the General Inquiry (GI) umbrella, which is a placeholder, not a description.
See Why GI expands.
-
Send
Offer(Actor)to the CASE_MANAGER with the recommended actor as itsobjectand the case as itstarget.Suggest actor to case
Recommends an actor to the CASE_MANAGER for the case named by the target.
- When… a Participant suggests an actor that the case should include
- Send:
Offer(Actor)[target=VulnerabilityCase] - Send to: the CASE_MANAGER
- Sent by: a participant
- Distinguished by: sender is not the Case Owner
- Reference: Suggest actor to case
Example activity
{ "@context": [ "https://www.w3.org/ns/activitystreams", "https://certcc.github.io/Vultron/ns/context.jsonld", "https://w3id.org/security/data-integrity/v2" ], "type": "Offer", "id": "urn:uuid:890aea69-4c7f-46d4-aef4-40987a1db820", "name": "https://vultron.example/users/finndervul Offer Coordinator LLC to urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "published": "2026-06-01T19:12:00.000000+00:00", "updated": "2026-06-01T19:12:00.000000+00:00", "content": "I'm recommending we add Coordinator LLC to the case.", "to": "https://vultron.example/case-actors/vendorco-case-actor", "actor": "https://vultron.example/users/finndervul", "target": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "object": { "type": "Organization", "id": "https://vultron.example/organizations/coordinator", "name": "Coordinator LLC", "published": "2026-06-01T19:12:00.000000+00:00", "updated": "2026-06-01T19:12:00.000000+00:00", "inbox": { "id": "https://vultron.example/organizations/coordinator/inbox", "type": "OrderedCollection", "items": [] }, "outbox": { "id": "https://vultron.example/organizations/coordinator/outbox", "type": "OrderedCollection", "items": [] } }, "proof": { "@context": [ "https://www.w3.org/ns/activitystreams", "https://certcc.github.io/Vultron/ns/context.jsonld", "https://w3id.org/security/data-integrity/v2" ], "type": "DataIntegrityProof", "cryptosuite": "eddsa-jcs-2022", "verificationMethod": "https://vultron.example/users/finndervul#main-key", "proofPurpose": "assertionMethod", "created": "2026-06-01T19:12:00.000000+00:00", "proofValue": "z2K1vhzm2LSUPdpPGNh5mVZRGUAxY4x2hnCYpq4L1FtUD34XL9ADufhvs5zJxas6kwuapHrPd2z8Zx9zxxTuDpBTj" } } -
Wait. The CASE_MANAGER records the recommendation on the ledger, assigns default roles, and forwards a transformed offer to the Case Owner.
Offer case participant
Forwards the recommendation as a proposed participant record, carrying the original recommendation's ID, the default roles it assigned, and the recommender's reason as its content.
- When… the CASE_MANAGER presents a suggested actor to the Case Owner
- Send:
Offer(CaseParticipant)[target=VulnerabilityCase] - Send to: a participant
- Sent by: the CASE_MANAGER
- Reference: Offer case participant
Example activity
{ "@context": [ "https://www.w3.org/ns/activitystreams", "https://certcc.github.io/Vultron/ns/context.jsonld", "https://w3id.org/security/data-integrity/v2" ], "type": "Offer", "id": "urn:uuid:2ea0ec09-1dc8-4fe7-9e2c-30f76c037f7c", "name": "https://vultron.example/case-actors/vendorco-case-actor Offer https://vultron.example/organizations/coordinator to urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "inReplyTo": "urn:uuid:e7aeb772-2d1d-4303-a94d-f46005f9ad8a", "published": "2026-06-01T19:12:00.000000+00:00", "updated": "2026-06-01T19:12:00.000000+00:00", "content": "I'm recommending we add Coordinator LLC to the case.", "to": [ "https://vultron.example/organizations/vendorco" ], "actor": "https://vultron.example/case-actors/vendorco-case-actor", "target": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "object": { "id": "https://vultron.example/organizations/coordinator#participant", "type": "CaseParticipant", "name": "https://vultron.example/organizations/coordinator", "published": "2026-06-01T19:12:00.000000+00:00", "updated": "2026-06-01T19:12:00.000000+00:00", "attributedTo": "https://vultron.example/organizations/coordinator", "caseRoles": [ "vendor" ], "participantStatuses": [ { "id": "urn:uuid:f56216ac-27fe-4a87-a852-e6a4c41a047b", "type": "ParticipantStatus", "name": "START vf", "context": "https://vultron.example/organizations/coordinator#participant", "published": "2026-06-01T19:12:00.000000+00:00", "updated": "2026-06-01T19:12:00.000000+00:00", "attributedTo": "https://vultron.example/organizations/coordinator", "rmState": "START", "vfState": "vf", "caseEngagement": true, "cvdRole": [ "VENDOR" ] } ], "embargoConsents": [], "joined": true }, "proof": { "@context": [ "https://www.w3.org/ns/activitystreams", "https://certcc.github.io/Vultron/ns/context.jsonld", "https://w3id.org/security/data-integrity/v2" ], "type": "DataIntegrityProof", "cryptosuite": "eddsa-jcs-2022", "verificationMethod": "https://vultron.example/case-actors/vendorco-case-actor#main-key", "proofPurpose": "assertionMethod", "created": "2026-06-01T19:12:00.000000+00:00", "proofValue": "z5a1iyXxadFQK1H5HYj61on3AvRsozmz7MmGEBkLo9y8rTbKVtHYD7urq6MdJpsipqJgxPL581jytfZ2ZCWbWuzYF" } } -
Read the outcome from the CASE_MANAGER's answer to your
Offer(Actor). ItsinReplyTonames your recommendation. AnAccept(Offer(Actor))means the suggested actor is invited, or was already invited or a participant.Accept actor recommendation
Accepts the recommender's suggestion, with
inReplyTonaming it. The CASE_MANAGER sends it once the Case Owner approves, or at once when the suggested actor is already invited or has joined.- When… the CASE_MANAGER tells a recommender that the actor it suggested will be invited
- Send:
Accept(Offer(Actor)[target=VulnerabilityCase]) - Send to: a participant
- Sent by: the CASE_MANAGER
- Reference: Accept actor recommendation
Example activity
{ "@context": [ "https://www.w3.org/ns/activitystreams", "https://certcc.github.io/Vultron/ns/context.jsonld", "https://w3id.org/security/data-integrity/v2" ], "type": "Accept", "id": "urn:uuid:36167b05-8850-41bc-93a2-7575ec936923", "name": "https://vultron.example/case-actors/vendorco-case-actor Accept https://vultron.example/users/finndervul Offer Coordinator LLC to urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a to urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "inReplyTo": "urn:uuid:9e807826-2cf4-4c6e-9d92-01d797478051", "published": "2026-06-01T19:12:00.000000+00:00", "updated": "2026-06-01T19:12:00.000000+00:00", "content": "We're accepting your recommendation to add Coordinator LLC to the case. We'll reach out to them shortly.", "to": "https://vultron.example/users/finndervul", "actor": "https://vultron.example/case-actors/vendorco-case-actor", "target": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "object": { "type": "Offer", "id": "urn:uuid:9e807826-2cf4-4c6e-9d92-01d797478051", "name": "https://vultron.example/users/finndervul Offer Coordinator LLC to urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "published": "2026-06-01T19:12:00.000000+00:00", "updated": "2026-06-01T19:12:00.000000+00:00", "content": "I'm recommending we add Coordinator LLC to the case.", "to": "https://vultron.example/case-actors/vendorco-case-actor", "actor": "https://vultron.example/users/finndervul", "target": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "object": { "type": "Organization", "id": "https://vultron.example/organizations/coordinator", "name": "Coordinator LLC", "published": "2026-06-01T19:12:00.000000+00:00", "updated": "2026-06-01T19:12:00.000000+00:00", "inbox": { "id": "https://vultron.example/organizations/coordinator/inbox", "type": "OrderedCollection", "items": [] }, "outbox": { "id": "https://vultron.example/organizations/coordinator/outbox", "type": "OrderedCollection", "items": [] } } }, "proof": { "@context": [ "https://www.w3.org/ns/activitystreams", "https://certcc.github.io/Vultron/ns/context.jsonld", "https://w3id.org/security/data-integrity/v2" ], "type": "DataIntegrityProof", "cryptosuite": "eddsa-jcs-2022", "verificationMethod": "https://vultron.example/case-actors/vendorco-case-actor#main-key", "proofPurpose": "assertionMethod", "created": "2026-06-01T19:12:00.000000+00:00", "proofValue": "z42d2PEiurxqGhmyQH2fTZ69x3MnhtfB44GornnRam7UkPFp3RJmVPBfsb7MdFPRPnqAYjLLxvY7h8g1gbVV4RKEa" } }A
Reject(Offer(Actor))means the Case Owner declined the suggestion.Reject actor recommendation
Declines the recommender's suggestion, with
inReplyTonaming it. The suggested actor is not invited.- When… the CASE_MANAGER tells a recommender that the Case Owner declined the actor it suggested
- Send:
Reject(Offer(Actor)[target=VulnerabilityCase]) - Send to: a participant
- Sent by: the CASE_MANAGER
- Reference: Reject actor recommendation
Example activity
{ "@context": [ "https://www.w3.org/ns/activitystreams", "https://certcc.github.io/Vultron/ns/context.jsonld", "https://w3id.org/security/data-integrity/v2" ], "type": "Reject", "id": "urn:uuid:89eeb06e-b56e-47b7-a73f-31ffce1885a2", "name": "https://vultron.example/case-actors/vendorco-case-actor Reject https://vultron.example/users/finndervul Offer Coordinator LLC to urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a to urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "inReplyTo": "urn:uuid:4fb0c76e-bec2-46c2-80ac-79c0d1c86ab1", "published": "2026-06-01T19:12:00.000000+00:00", "updated": "2026-06-01T19:12:00.000000+00:00", "content": "We're declining your recommendation to add Coordinator LLC to the case. Thanks anyway.", "to": "https://vultron.example/users/finndervul", "actor": "https://vultron.example/case-actors/vendorco-case-actor", "target": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "object": { "type": "Offer", "id": "urn:uuid:4fb0c76e-bec2-46c2-80ac-79c0d1c86ab1", "name": "https://vultron.example/users/finndervul Offer Coordinator LLC to urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "published": "2026-06-01T19:12:00.000000+00:00", "updated": "2026-06-01T19:12:00.000000+00:00", "content": "I'm recommending we add Coordinator LLC to the case.", "to": "https://vultron.example/case-actors/vendorco-case-actor", "actor": "https://vultron.example/users/finndervul", "target": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "object": { "type": "Organization", "id": "https://vultron.example/organizations/coordinator", "name": "Coordinator LLC", "published": "2026-06-01T19:12:00.000000+00:00", "updated": "2026-06-01T19:12:00.000000+00:00", "inbox": { "id": "https://vultron.example/organizations/coordinator/inbox", "type": "OrderedCollection", "items": [] }, "outbox": { "id": "https://vultron.example/organizations/coordinator/outbox", "type": "OrderedCollection", "items": [] } } }, "proof": { "@context": [ "https://www.w3.org/ns/activitystreams", "https://certcc.github.io/Vultron/ns/context.jsonld", "https://w3id.org/security/data-integrity/v2" ], "type": "DataIntegrityProof", "cryptosuite": "eddsa-jcs-2022", "verificationMethod": "https://vultron.example/case-actors/vendorco-case-actor#main-key", "proofPurpose": "assertionMethod", "created": "2026-06-01T19:12:00.000000+00:00", "proofValue": "z3zXTctWzNHZuGc9tzRKpBDk9qrCTAiKUhH3MyAo4ZNgpiK1n8aNRKm3YzDDsdgzyAK8YpCnQYzY1dnFd5VN9jVgB" } }
Accept either answer only from the CASE_MANAGER, and change nothing on receipt. The CASE_MANAGER ledgered the answer, and your replica takes it from the ledger.
The forwarded offer names your original recommendation in its inReplyTo field, so the Case Owner can trace the request back to you.
If your Offer(Actor) includes a content or summary field, the CASE_MANAGER carries it forward as content on the Offer(CaseParticipant), so the Case Owner reads your reason without consulting the original recommendation (CM-16-020).
Decide on a recommendation
As Case Owner, answer the forwarded offer, addressing the reply to the CASE_MANAGER and not to the recommender.
-
If the actor should join, send
Accept(Offer(CaseParticipant)), with the forwardedOffer(CaseParticipant)as itsobject. The CASE_MANAGER then invites the actor. It refuses anAcceptof an offer that namesCASE_MANAGERorCASE_OWNERfor the actor, and sends no invitation (CM-20-008).Accept case participant offer
Accepts the proposed participant record. The CASE_MANAGER then invites the suggested actor.
- When… the Case Owner approves a suggested actor
- Send:
Accept(Offer(CaseParticipant)[target=VulnerabilityCase]) - Send to: the CASE_MANAGER
- Sent by: the Case Owner
- Reference: Accept case participant offer
Example activity
{ "@context": [ "https://www.w3.org/ns/activitystreams", "https://certcc.github.io/Vultron/ns/context.jsonld", "https://w3id.org/security/data-integrity/v2" ], "type": "Accept", "id": "urn:uuid:6d20d22e-3447-4897-a3ed-518565bb05c3", "name": "https://vultron.example/organizations/vendorco Accept https://vultron.example/case-actors/vendorco-case-actor Offer https://vultron.example/organizations/coordinator to urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a to urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "inReplyTo": "urn:uuid:f8d974d7-06c9-4ae9-b1ed-84558cbac4b8", "published": "2026-06-01T19:12:00.000000+00:00", "updated": "2026-06-01T19:12:00.000000+00:00", "content": "Accepting recommendation to add Coordinator LLC to the case.", "to": [ "https://vultron.example/case-actors/vendorco-case-actor" ], "actor": "https://vultron.example/organizations/vendorco", "target": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "object": { "type": "Offer", "id": "urn:uuid:f8d974d7-06c9-4ae9-b1ed-84558cbac4b8", "name": "https://vultron.example/case-actors/vendorco-case-actor Offer https://vultron.example/organizations/coordinator to urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "inReplyTo": "urn:uuid:5baadde1-bc9d-40b8-b924-eec504c0473b", "published": "2026-06-01T19:12:00.000000+00:00", "updated": "2026-06-01T19:12:00.000000+00:00", "content": "I'm recommending we add Coordinator LLC to the case.", "to": [ "https://vultron.example/organizations/vendorco" ], "actor": "https://vultron.example/case-actors/vendorco-case-actor", "target": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "object": { "id": "https://vultron.example/organizations/coordinator#participant", "type": "CaseParticipant", "name": "https://vultron.example/organizations/coordinator", "published": "2026-06-01T19:12:00.000000+00:00", "updated": "2026-06-01T19:12:00.000000+00:00", "attributedTo": "https://vultron.example/organizations/coordinator", "caseRoles": [ "vendor" ], "participantStatuses": [ { "id": "urn:uuid:c2d98e67-b523-44d8-b3d6-0d892b776f41", "type": "ParticipantStatus", "name": "START vf", "context": "https://vultron.example/organizations/coordinator#participant", "published": "2026-06-01T19:12:00.000000+00:00", "updated": "2026-06-01T19:12:00.000000+00:00", "attributedTo": "https://vultron.example/organizations/coordinator", "rmState": "START", "vfState": "vf", "caseEngagement": true, "cvdRole": [ "VENDOR" ] } ], "embargoConsents": [], "joined": true } }, "proof": { "@context": [ "https://www.w3.org/ns/activitystreams", "https://certcc.github.io/Vultron/ns/context.jsonld", "https://w3id.org/security/data-integrity/v2" ], "type": "DataIntegrityProof", "cryptosuite": "eddsa-jcs-2022", "verificationMethod": "https://vultron.example/organizations/vendorco#main-key", "proofPurpose": "assertionMethod", "created": "2026-06-01T19:12:00.000000+00:00", "proofValue": "z8o52fdWZYfvxpbcSFXXNF3JWPsM5GXcam8m4wQ8WTrr4qiTFrjGSBtpKRS75f7ZUQ3XahuyX3UyQB73HcMzCBTn" } } -
If it should not, send
Reject(Offer(CaseParticipant))with the sameobject. No invitation is sent.Reject case participant offer
Rejects the proposed participant record. The CASE_MANAGER tells the recommender.
- When… the Case Owner declines a suggested actor
- Send:
Reject(Offer(CaseParticipant)[target=VulnerabilityCase]) - Send to: the CASE_MANAGER
- Sent by: the Case Owner
- Reference: Reject case participant offer
Example activity
{ "@context": [ "https://www.w3.org/ns/activitystreams", "https://certcc.github.io/Vultron/ns/context.jsonld", "https://w3id.org/security/data-integrity/v2" ], "type": "Reject", "id": "urn:uuid:3fa43889-3476-4ecc-95d6-b4d69d5e8ead", "name": "https://vultron.example/organizations/vendorco Reject https://vultron.example/case-actors/vendorco-case-actor Offer https://vultron.example/organizations/coordinator to urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a to urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "inReplyTo": "urn:uuid:ef15e5f6-2ed9-4fa0-a798-9024543e72f5", "published": "2026-06-01T19:12:00.000000+00:00", "updated": "2026-06-01T19:12:00.000000+00:00", "content": "Declining recommendation to add Coordinator LLC to the case.", "to": [ "https://vultron.example/case-actors/vendorco-case-actor" ], "actor": "https://vultron.example/organizations/vendorco", "target": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "object": { "type": "Offer", "id": "urn:uuid:ef15e5f6-2ed9-4fa0-a798-9024543e72f5", "name": "https://vultron.example/case-actors/vendorco-case-actor Offer https://vultron.example/organizations/coordinator to urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "inReplyTo": "urn:uuid:c208f2aa-5bc8-4a37-99d2-93e0743107d7", "published": "2026-06-01T19:12:00.000000+00:00", "updated": "2026-06-01T19:12:00.000000+00:00", "content": "I'm recommending we add Coordinator LLC to the case.", "to": [ "https://vultron.example/organizations/vendorco" ], "actor": "https://vultron.example/case-actors/vendorco-case-actor", "target": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a", "object": { "id": "https://vultron.example/organizations/coordinator#participant", "type": "CaseParticipant", "name": "https://vultron.example/organizations/coordinator", "published": "2026-06-01T19:12:00.000000+00:00", "updated": "2026-06-01T19:12:00.000000+00:00", "attributedTo": "https://vultron.example/organizations/coordinator", "caseRoles": [ "vendor" ], "participantStatuses": [ { "id": "urn:uuid:c7810e2f-8b69-402f-8663-2766ee0d62d5", "type": "ParticipantStatus", "name": "START vf", "context": "https://vultron.example/organizations/coordinator#participant", "published": "2026-06-01T19:12:00.000000+00:00", "updated": "2026-06-01T19:12:00.000000+00:00", "attributedTo": "https://vultron.example/organizations/coordinator", "rmState": "START", "vfState": "vf", "caseEngagement": true, "cvdRole": [ "VENDOR" ] } ], "embargoConsents": [], "joined": true } }, "proof": { "@context": [ "https://www.w3.org/ns/activitystreams", "https://certcc.github.io/Vultron/ns/context.jsonld", "https://w3id.org/security/data-integrity/v2" ], "type": "DataIntegrityProof", "cryptosuite": "eddsa-jcs-2022", "verificationMethod": "https://vultron.example/organizations/vendorco#main-key", "proofPurpose": "assertionMethod", "created": "2026-06-01T19:12:00.000000+00:00", "proofValue": "zajGRUj18DPXhtrUYJPeaYQ6xaPTzXGFyYuCUByDYznRWFG3MJMnbQR8TvjhRiURD3wQo4mdu4e7TVYgzRtyM1EK" } }
The CASE_MANAGER acts on a decision only when the Case Owner sent it.
It refuses a reply from any other sender, invites no one, and tells the recommender nothing.
The actor it invites is the one named in the Offer(CaseParticipant) it forwarded, never the one named in your reply.
The CASE_MANAGER also refuses an Accept for an actor that has already joined or has closed its record, and it commits and sends nothing for it.
The same holds for an actor the case has removed.
It also refuses a reply that names an Offer(CaseParticipant) it never forwarded, or a recommendation it holds no record of, and it commits and sends nothing for it.
Replying to the recommender skips the record
The CASE_MANAGER is the single writer for the case ledger. A decision sent straight back to the recommender is never committed, so no replica learns of it and no invitation follows.
Verify
| What you sent | What to confirm |
|---|---|
Offer(Actor) |
The recommendation appears as a ledger entry. |
Accept(Offer(CaseParticipant)) |
The recommender holds an Accept(Offer(Actor)), and the suggested actor holds an Invite. |
Reject(Offer(CaseParticipant)) |
The recommender holds a Reject(Offer(Actor)), and no Invite was sent. |
See it end to end
Try it: vultron-demo suggest-actor
vultron-demo suggest-actor
Or with Docker Compose:
DEMO=suggest-actor docker compose -f docker/docker-compose.yml run --rm demo
The scenario runs both outcomes: the Case Owner accepts one suggestion and rejects another.
Further reading
- General Inquiry (GI) Messages — the wire format and a rendered example for the recommendation activities
- Case Management Messages — the wire format for the forwarded offer and its accept and reject replies
- Activity Vocabulary Design — why the suggestion step exists alongside direct invitation, and the situations it covers