LangGraph Adapter Example

This example shows concrete control-point placement for UAICP gates.

Graph State

type GraphState = {
  requestId: string;
  traceId: string;
  intent: string;
  toolResults: Array<{ tool: string; output: unknown }>;
  approvalToken?: string;
};

UAICP Nodes

function mapEnvelope(state: GraphState): UaicpEnvelope {
  return {
    uaicp_version: '0.2',
    request_id: state.requestId,
    trace_id: state.traceId,
    state: 'execute',
    timestamp: new Date().toISOString(),
    identity: getRuntimeIdentity(),
    metadata: { intent: state.intent },
  };
}

function collectEvidence(state: GraphState): EvidenceObject[] {
  return state.toolResults.map((r, i) => ({
    evidence_id: `${state.requestId}-${i}`,
    evidence_type: 'tool_result',
    content_hash: hashResult(r.output),
    source: r.tool,
  }));
}

function verifyAndGate(state: GraphState): 'deliver' | 'fail_safe' | 'needs_review' {
  const envelope = mapEnvelope(state);
  const evidence = collectEvidence(state);
  const verification = runVerifier(envelope, evidence);

  if (!verification.required_checks_passed) return 'fail_safe';

  const policy = runPolicyGate({
    envelope,
    verification,
    action: 'reverse_wire_transfer',
    resource: state.traceId,
    writeRisk: 'write_high_risk',
    approvalToken: state.approvalToken,
    allowedControlClasses: ['human-supervised', 'human-directed'],
    trustTierAllowlist: ['high'],
  });

  return policy.decision === 'allow' ? 'deliver' : policy.decision;
}

Node Order

planner -> tools -> uaicp_verify_and_policy_gate -> terminal

Terminal delivery should only execute when gate output is deliver.