Decision Mode

Mode identifier: macp.mode.decision.v1 Participant model: declared Determinism: semantic-deterministic

Purpose

Structured decision-making with proposals, evaluations, objections, and votes leading to a bound outcome via Commitment.

Session Lifecycle

SessionStart → Proposal → Evaluation → Objection? → Vote → Commitment

Phase Transitions

Phase	Triggered By	Allowed Messages
`Proposal`	Session start	Proposal
`Evaluation`	First Proposal	Proposal, Evaluation, Objection
`Voting`	First Vote	Vote
`Committed`	Commitment	(terminal)

API

DecisionSession

import { DecisionSession, MacpClient, Auth } from 'macp-sdk-typescript';

const session = new DecisionSession(client, {
  sessionId: 'optional-custom-id',  // default: auto-generated UUID
  modeVersion: '1.0.0',             // default
  configurationVersion: 'config.default',
  policyVersion: 'policy.default',
  auth: Auth.devAgent('coordinator'),
});

`start(input)`

Initiates the decision session.

await session.start({
  intent: 'choose deployment strategy',
  participants: ['alice', 'bob', 'carol'],
  ttlMs: 300_000,    // 5 minutes
  context: { project: 'web-app' },  // optional, Buffer | string | object
  roots: [{ uri: 'https://git.example.com/repo', name: 'main-repo' }],
  sender: 'coordinator',  // optional, derived from auth
});

`propose(input)`

Submit a proposal for consideration.

await session.propose({
  proposalId: 'p1',          // unique within session
  option: 'canary-deploy',   // the proposed option
  rationale: 'gradual rollout with monitoring',
  supportingData: Buffer.from('...'),  // optional
});

`evaluate(input)`

Add an evaluation of a proposal.

await session.evaluate({
  proposalId: 'p1',
  recommendation: 'approve',  // or 'reject', 'defer', etc.
  confidence: 0.92,            // 0.0 - 1.0
  reason: 'risk assessment favorable',
  sender: 'alice',
  auth: Auth.devAgent('alice'),
});

`raiseObjection(input)`

Flag an objection against a proposal.

await session.raiseObjection({
  proposalId: 'p1',
  reason: 'insufficient monitoring coverage',
  severity: 'high',  // 'low', 'medium', 'high', 'critical', 'block'
  sender: 'bob',
  auth: Auth.devAgent('bob'),
});

`vote(input)`

Cast a vote on a proposal.

await session.vote({
  proposalId: 'p1',
  vote: 'approve',  // recognized positive: approve, approved, yes, accept, accepted
  reason: 'all concerns addressed',
  sender: 'carol',
  auth: Auth.devAgent('carol'),
});

`commit(input)`

Finalize the decision session.

await session.commit({
  action: 'deployment.approved',
  authorityScope: 'release-management',
  reason: 'unanimous approval for canary deploy',
  commitmentId: 'optional-custom-id',  // default: auto-generated UUID
});

DecisionProjection

The projection tracks all proposals, evaluations, objections, and votes locally.

State

Property	Type	Description
`proposals`	`Map<string, DecisionProposalRecord>`	Proposals by ID
`evaluations`	`DecisionEvaluationRecord[]`	All evaluations
`objections`	`DecisionObjectionRecord[]`	All objections
`votes`	`Map<string, Map<string, DecisionVoteRecord>>`	Votes by proposalId → sender
`transcript`	`Envelope[]`	All accepted envelopes
`phase`	`'Proposal' \| 'Evaluation' \| 'Voting' \| 'Committed'`	Current phase
`commitment`	`Record<string, unknown> \| undefined`	Commitment payload if resolved

Query Helpers

// Count positive votes per proposal
session.projection.voteTotals();
// → { 'p1': 2, 'p2': 1 }

// Get proposal with most positive votes
session.projection.majorityWinner();
// → 'p1'

// Check for blocking objections (severity: high, critical, or block)
session.projection.hasBlockingObjection('p1');
// → true/false

Vote Deduplication

If the same sender votes twice on the same proposal, the later vote replaces the earlier one.

RFC Validation Rules

The runtime enforces these rules (the SDK does not validate locally):

proposal_id must be unique within the session
Evaluation, Objection, and Vote must reference an existing proposal_id
Each participant may cast at most one Vote per proposal (latest wins)
Commitment must come from an authorized sender
Session must have at least one proposal before resolving

Example

See examples/decision-smoke.ts for a complete working example.

On this page