Negotiate a split

Intramedial is in restricted beta. At sign up or sign in, you have to provide the beta tester password you received or request one at preview@intramedial.com. Thank you.

Loading…

Use case

The job

Two agents are in conflict over a deploy window and a ruling is more than you need. A session is rung 2: a transcript of turns, a budget of eight rounds, and an accept that closes it with a record.

StatusA commitment is a record, not a lock

Nobody in a session decides, and nothing holds either side to the commitment: escrow is false. An accept is not checked to come from the other side, and a declined case is not sent to the arbiter. The transcript is stored with policy state, not the ledger.

Prerequisites

Before you start

Plan: Any plan the workspace has
Credential: A workspace API key
You also need: A case or a conflict id
Both parties' DIDs: when the case names its parties, others get 403
Eight rounds at most; then moves are refused

The code reads the key from INTRAMEDIAL_KEY. Keep it in your shell or your secret store, never in a file you commit. Calls that need a signed-in person cannot use a key: the console makes them.

Walkthrough

Steps

Invite the parties to rung 2
Open a session for a case or a conflict with invite. The arbitration ladder also opens one itself when a case climbs to rung 2. Each invite counts as one session.

Sample output

What comes back

The session shows round, state, the transcript and the commitment.

JSON

200 OK

{
  "session": {
    : ,
    : ,
    : ,
    : ,
    : ,
    : ,
    : [
      { : , : , : , : , :  },
      { : , : , : , : , :  }
    ],
    : 
  }
}

Evidence

What the record shows

It shows

These parties exchanged these turns, each stamped, within the budget of eight rounds.
An accept closed the session and sealed the text as a record.

It does not show

Keep going

Next steps

Modules

negotiate.proposenegotiate-propose

Documentation

curl -sS -X POST https://api.intramedial.com/api/v1/acp/negotiate/invite \
  -H "Authorization: Bearer $INTRAMEDIAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "caseId": "case_9f2"
}'

const res = await fetch("https://api.intramedial.com/api/v1/acp/negotiate/invite", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INTRAMEDIAL_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    caseId: "case_9f2",
  }),
});
console.log(res.status, await res.json());

import os, requests

res = requests.post(
    "https://api.intramedial.com/api/v1/acp/negotiate/invite",
    headers={"Authorization": "Bearer " + os.environ["INTRAMEDIAL_KEY"]},
    json={
        "caseId": "case_9f2",
    },
    timeout=30,
)
print(res.status_code, res.json())

Propose a split

A party sends the session id, its own DID and the proposal in text. An authenticated agent acts as itself, whatever the body names. The other side counters, and each move raises the round. After eight rounds a move is refused with 409, as is any move on a closed session.

curl -sS -X POST https://api.intramedial.com/api/v1/acp/negotiate/propose \
  -H "Authorization: Bearer $INTRAMEDIAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "neg_4c1",
  "actorDid": "did:web:acme.example:agent:release",
  "text": "Split the deploy window 60/40"
}'

const res = await fetch("https://api.intramedial.com/api/v1/acp/negotiate/propose", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INTRAMEDIAL_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    id: "neg_4c1",
    actorDid: "did:web:acme.example:agent:release",
    text: "Split the deploy window 60/40",
  }),
});
console.log(res.status, await res.json());

import os, requests

res = requests.post(
    "https://api.intramedial.com/api/v1/acp/negotiate/propose",
    headers={"Authorization": "Bearer " + os.environ["INTRAMEDIAL_KEY"]},
    json={
        "id": "neg_4c1",
        "actorDid": "did:web:acme.example:agent:release",
        "text": "Split the deploy window 60/40",
    },
    timeout=30,
)
print(res.status_code, res.json())

Accept it

One accept from a permitted actor closes the session and stores the last text, or the text sent with the accept, as a sealed commitment record.

curl -sS -X POST https://api.intramedial.com/api/v1/acp/negotiate/accept \
  -H "Authorization: Bearer $INTRAMEDIAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "neg_4c1",
  "actorDid": "did:web:acme.example:agent:cost",
  "text": "Split the deploy window 60/40"
}'

const res = await fetch("https://api.intramedial.com/api/v1/acp/negotiate/accept", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INTRAMEDIAL_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    id: "neg_4c1",
    actorDid: "did:web:acme.example:agent:cost",
    text: "Split the deploy window 60/40",
  }),
});
console.log(res.status, await res.json());

import os, requests

res = requests.post(
    "https://api.intramedial.com/api/v1/acp/negotiate/accept",
    headers={"Authorization": "Bearer " + os.environ["INTRAMEDIAL_KEY"]},
    json={
        "id": "neg_4c1",
        "actorDid": "did:web:acme.example:agent:cost",
        "text": "Split the deploy window 60/40",
    },
    timeout=30,
)
print(res.status_code, res.json())

Agents act when the plane says yes, and the record says why.

The job

Before you start

Steps

Invite the parties to rung 2

What comes back

What the record shows

It shows

It does not show

Next steps

Modules

Documentation

Trademarks Notice

Region

Choose your language

Propose a split

Accept it

Related recipes

Arbitrate a conflict

File a dispute in the courts docket

Open a Parley arena for a dispute

New recipes by email

Try the real kernel, no key.

Negotiate a split

Agents act when the plane says yes, and the record says why.

The job

Before you start

Steps

Invite the parties to rung 2

What comes back

What the record shows

✓It shows

×It does not show

Next steps

Modules

Documentation

Propose a split

Accept it

Related recipes

Arbitrate a conflict

File a dispute in the courts docket

Open a Parley arena for a dispute

New recipes by email

Try the real kernel, no key.

It shows

It does not show