Getting Started

npm install macp-sdk-typescript

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

const client = new MacpClient({
  address: '127.0.0.1:50051',
  secure: false,                    // true for TLS in production
  auth: Auth.devAgent('my-agent'),  // default auth for all operations
});

// Handshake — negotiates protocol version and capabilities
const init = await client.initialize();
console.log(init.selectedProtocolVersion); // '1.0'
console.log(init.runtimeInfo?.name);       // runtime name
console.log(init.supportedModes);          // available modes

import { DecisionSession } from 'macp-sdk-typescript';

const session = new DecisionSession(client);

// 1. Start a session
await session.start({
  intent: 'choose a deployment strategy',
  participants: ['alice', 'bob'],
  ttlMs: 60_000, // 1 minute
});

// 2. Submit a proposal
await session.propose({
  proposalId: 'p1',
  option: 'canary-deploy',
  rationale: 'gradual rollout with monitoring',
});

// 3. Evaluate (as another agent)
await session.evaluate({
  proposalId: 'p1',
  recommendation: 'approve',
  confidence: 0.92,
  reason: 'risk assessment favorable',
  sender: 'alice',
  auth: Auth.devAgent('alice'),
});

// 4. Vote
await session.vote({
  proposalId: 'p1',
  vote: 'approve',
  reason: 'team consensus',
  sender: 'bob',
  auth: Auth.devAgent('bob'),
});

// 5. Check projection state
console.log(session.projection.voteTotals());    // { p1: 1 }
console.log(session.projection.majorityWinner()); // 'p1'

// 6. Commit the decision
await session.commit({
  action: 'deployment.approved',
  authorityScope: 'release-management',
  reason: 'unanimous approval for canary deploy',
});

// 7. Verify
const meta = await session.metadata();
console.log(meta.metadata.state); // 'SESSION_STATE_RESOLVED'

client.close();